diff --git a/descriptions-next/api.github.com/api.github.com.2022-11-28.json b/descriptions-next/api.github.com/api.github.com.2022-11-28.json index 1fa4e92d08..0c01d0e879 100644 --- a/descriptions-next/api.github.com/api.github.com.2022-11-28.json +++ b/descriptions-next/api.github.com/api.github.com.2022-11-28.json @@ -1040,7 +1040,7 @@ }, "delete": { "summary": "Delete an installation for the authenticated app", - "description": "Uninstalls a GitHub App on a user, organization, or business account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the \"[Suspend an app installation](https://docs.github.com/rest/apps/apps#suspend-an-app-installation)\" endpoint.\n\nYou must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", + "description": "Uninstalls a GitHub App on a user, organization, or enterprise account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the \"[Suspend an app installation](https://docs.github.com/rest/apps/apps#suspend-an-app-installation)\" endpoint.\n\nYou must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", "tags": [ "apps" ], @@ -1175,7 +1175,7 @@ "/app/installations/{installation_id}/suspended": { "put": { "summary": "Suspend an app installation", - "description": "Suspends a GitHub App on a user, organization, or business account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub API or webhook events is blocked for that account.\n\nYou must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", + "description": "Suspends a GitHub App on a user, organization, or enterprise account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub API or webhook events is blocked for that account.\n\nYou must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", "tags": [ "apps" ], @@ -17605,7 +17605,7 @@ }, "delete": { "summary": "Remove an organization member", - "description": "Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories.", + "description": "Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories.\n\n> [!NOTE]\n> If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team.", "tags": [ "orgs" ], @@ -18023,7 +18023,7 @@ }, "delete": { "summary": "Remove organization membership for a user", - "description": "In order to remove a user's membership with an organization, the authenticated user must be an organization owner.\n\nIf the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases.", + "description": "In order to remove a user's membership with an organization, the authenticated user must be an organization owner.\n\nIf the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases.\n\n> [!NOTE]\n> If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team.", "tags": [ "orgs" ], @@ -98199,6 +98199,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" diff --git a/descriptions-next/api.github.com/api.github.com.2022-11-28.yaml b/descriptions-next/api.github.com/api.github.com.2022-11-28.yaml index 8533cbbd61..aea5cfa304 100644 --- a/descriptions-next/api.github.com/api.github.com.2022-11-28.yaml +++ b/descriptions-next/api.github.com/api.github.com.2022-11-28.yaml @@ -706,7 +706,7 @@ paths: delete: summary: Delete an installation for the authenticated app description: |- - Uninstalls a GitHub App on a user, organization, or business account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the "[Suspend an app installation](https://docs.github.com/rest/apps/apps#suspend-an-app-installation)" endpoint. + Uninstalls a GitHub App on a user, organization, or enterprise account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the "[Suspend an app installation](https://docs.github.com/rest/apps/apps#suspend-an-app-installation)" endpoint. You must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. tags: @@ -806,7 +806,7 @@ paths: put: summary: Suspend an app installation description: |- - Suspends a GitHub App on a user, organization, or business account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub API or webhook events is blocked for that account. + Suspends a GitHub App on a user, organization, or enterprise account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub API or webhook events is blocked for that account. You must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. tags: @@ -12793,8 +12793,11 @@ paths: subcategory: members delete: summary: Remove an organization member - description: Removing a user from this list will remove them from all teams - and they will no longer have any access to the organization's repositories. + description: |- + Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories. + + > [!NOTE] + > If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team. tags: - orgs operationId: orgs/remove-member @@ -13099,6 +13102,9 @@ paths: In order to remove a user's membership with an organization, the authenticated user must be an organization owner. If the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases. + + > [!NOTE] + > If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team. tags: - orgs operationId: orgs/remove-membership-for-user @@ -71005,6 +71011,10 @@ components: type: integer examples: - 1 + client_id: + type: string + examples: + - Iv1.ab1112223334445c target_id: description: The ID of the user or organization this token is being scoped to. diff --git a/descriptions-next/api.github.com/api.github.com.json b/descriptions-next/api.github.com/api.github.com.json index 1fa4e92d08..0c01d0e879 100644 --- a/descriptions-next/api.github.com/api.github.com.json +++ b/descriptions-next/api.github.com/api.github.com.json @@ -1040,7 +1040,7 @@ }, "delete": { "summary": "Delete an installation for the authenticated app", - "description": "Uninstalls a GitHub App on a user, organization, or business account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the \"[Suspend an app installation](https://docs.github.com/rest/apps/apps#suspend-an-app-installation)\" endpoint.\n\nYou must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", + "description": "Uninstalls a GitHub App on a user, organization, or enterprise account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the \"[Suspend an app installation](https://docs.github.com/rest/apps/apps#suspend-an-app-installation)\" endpoint.\n\nYou must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", "tags": [ "apps" ], @@ -1175,7 +1175,7 @@ "/app/installations/{installation_id}/suspended": { "put": { "summary": "Suspend an app installation", - "description": "Suspends a GitHub App on a user, organization, or business account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub API or webhook events is blocked for that account.\n\nYou must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", + "description": "Suspends a GitHub App on a user, organization, or enterprise account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub API or webhook events is blocked for that account.\n\nYou must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", "tags": [ "apps" ], @@ -17605,7 +17605,7 @@ }, "delete": { "summary": "Remove an organization member", - "description": "Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories.", + "description": "Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories.\n\n> [!NOTE]\n> If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team.", "tags": [ "orgs" ], @@ -18023,7 +18023,7 @@ }, "delete": { "summary": "Remove organization membership for a user", - "description": "In order to remove a user's membership with an organization, the authenticated user must be an organization owner.\n\nIf the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases.", + "description": "In order to remove a user's membership with an organization, the authenticated user must be an organization owner.\n\nIf the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases.\n\n> [!NOTE]\n> If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team.", "tags": [ "orgs" ], @@ -98199,6 +98199,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" diff --git a/descriptions-next/api.github.com/api.github.com.yaml b/descriptions-next/api.github.com/api.github.com.yaml index 8533cbbd61..aea5cfa304 100644 --- a/descriptions-next/api.github.com/api.github.com.yaml +++ b/descriptions-next/api.github.com/api.github.com.yaml @@ -706,7 +706,7 @@ paths: delete: summary: Delete an installation for the authenticated app description: |- - Uninstalls a GitHub App on a user, organization, or business account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the "[Suspend an app installation](https://docs.github.com/rest/apps/apps#suspend-an-app-installation)" endpoint. + Uninstalls a GitHub App on a user, organization, or enterprise account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the "[Suspend an app installation](https://docs.github.com/rest/apps/apps#suspend-an-app-installation)" endpoint. You must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. tags: @@ -806,7 +806,7 @@ paths: put: summary: Suspend an app installation description: |- - Suspends a GitHub App on a user, organization, or business account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub API or webhook events is blocked for that account. + Suspends a GitHub App on a user, organization, or enterprise account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub API or webhook events is blocked for that account. You must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. tags: @@ -12793,8 +12793,11 @@ paths: subcategory: members delete: summary: Remove an organization member - description: Removing a user from this list will remove them from all teams - and they will no longer have any access to the organization's repositories. + description: |- + Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories. + + > [!NOTE] + > If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team. tags: - orgs operationId: orgs/remove-member @@ -13099,6 +13102,9 @@ paths: In order to remove a user's membership with an organization, the authenticated user must be an organization owner. If the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases. + + > [!NOTE] + > If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team. tags: - orgs operationId: orgs/remove-membership-for-user @@ -71005,6 +71011,10 @@ components: type: integer examples: - 1 + client_id: + type: string + examples: + - Iv1.ab1112223334445c target_id: description: The ID of the user or organization this token is being scoped to. diff --git a/descriptions-next/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json b/descriptions-next/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json index 9c6c6663aa..007cfef382 100644 --- a/descriptions-next/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json +++ b/descriptions-next/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json @@ -5394,6 +5394,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -6479,6 +6485,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -7234,7 +7246,7 @@ }, "delete": { "summary": "Delete an installation for the authenticated app", - "description": "Uninstalls a GitHub App on a user, organization, or business account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the \"[Suspend an app installation](https://docs.github.com/rest/apps/apps#suspend-an-app-installation)\" endpoint.\n\nYou must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", + "description": "Uninstalls a GitHub App on a user, organization, or enterprise account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the \"[Suspend an app installation](https://docs.github.com/rest/apps/apps#suspend-an-app-installation)\" endpoint.\n\nYou must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", "tags": [ "apps" ], @@ -9470,7 +9482,7 @@ "/app/installations/{installation_id}/suspended": { "put": { "summary": "Suspend an app installation", - "description": "Suspends a GitHub App on a user, organization, or business account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub API or webhook events is blocked for that account.\n\nYou must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", + "description": "Suspends a GitHub App on a user, organization, or enterprise account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub API or webhook events is blocked for that account.\n\nYou must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", "tags": [ "apps" ], @@ -107182,6 +107194,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -108282,6 +108300,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -115109,7 +115133,7 @@ }, "delete": { "summary": "Remove an organization member", - "description": "Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories.", + "description": "Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories.\n\n> [!NOTE]\n> If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team.", "tags": [ "orgs" ], @@ -121325,7 +121349,7 @@ }, "delete": { "summary": "Remove organization membership for a user", - "description": "In order to remove a user's membership with an organization, the authenticated user must be an organization owner.\n\nIf the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases.", + "description": "In order to remove a user's membership with an organization, the authenticated user must be an organization owner.\n\nIf the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases.\n\n> [!NOTE]\n> If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team.", "tags": [ "orgs" ], @@ -338000,6 +338024,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -580262,6 +580292,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -631521,6 +631557,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -813072,6 +813114,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -816132,6 +816180,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -819097,6 +819151,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -822062,6 +822122,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -825161,6 +825227,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -828267,6 +828339,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -833368,6 +833446,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" diff --git a/descriptions-next/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml b/descriptions-next/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml index e71abd5a07..6fae45b599 100644 --- a/descriptions-next/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml +++ b/descriptions-next/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml @@ -2304,6 +2304,10 @@ paths: type: integer examples: - 1 + client_id: + type: string + examples: + - Iv1.ab1112223334445c target_id: description: The ID of the user or organization this token is being scoped to. @@ -2879,7 +2883,7 @@ paths: delete: summary: Delete an installation for the authenticated app description: |- - Uninstalls a GitHub App on a user, organization, or business account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the "[Suspend an app installation](https://docs.github.com/rest/apps/apps#suspend-an-app-installation)" endpoint. + Uninstalls a GitHub App on a user, organization, or enterprise account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the "[Suspend an app installation](https://docs.github.com/rest/apps/apps#suspend-an-app-installation)" endpoint. You must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. tags: @@ -3738,7 +3742,7 @@ paths: put: summary: Suspend an app installation description: |- - Suspends a GitHub App on a user, organization, or business account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub API or webhook events is blocked for that account. + Suspends a GitHub App on a user, organization, or enterprise account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub API or webhook events is blocked for that account. You must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. tags: @@ -29949,8 +29953,11 @@ paths: subcategory: members delete: summary: Remove an organization member - description: Removing a user from this list will remove them from all teams - and they will no longer have any access to the organization's repositories. + description: |- + Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories. + + > [!NOTE] + > If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team. tags: - orgs operationId: orgs/remove-member @@ -30495,6 +30502,9 @@ paths: In order to remove a user's membership with an organization, the authenticated user must be an organization owner. If the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases. + + > [!NOTE] + > If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team. tags: - orgs operationId: orgs/remove-membership-for-user diff --git a/descriptions-next/api.github.com/dereferenced/api.github.com.deref.json b/descriptions-next/api.github.com/dereferenced/api.github.com.deref.json index 9c6c6663aa..007cfef382 100644 --- a/descriptions-next/api.github.com/dereferenced/api.github.com.deref.json +++ b/descriptions-next/api.github.com/dereferenced/api.github.com.deref.json @@ -5394,6 +5394,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -6479,6 +6485,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -7234,7 +7246,7 @@ }, "delete": { "summary": "Delete an installation for the authenticated app", - "description": "Uninstalls a GitHub App on a user, organization, or business account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the \"[Suspend an app installation](https://docs.github.com/rest/apps/apps#suspend-an-app-installation)\" endpoint.\n\nYou must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", + "description": "Uninstalls a GitHub App on a user, organization, or enterprise account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the \"[Suspend an app installation](https://docs.github.com/rest/apps/apps#suspend-an-app-installation)\" endpoint.\n\nYou must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", "tags": [ "apps" ], @@ -9470,7 +9482,7 @@ "/app/installations/{installation_id}/suspended": { "put": { "summary": "Suspend an app installation", - "description": "Suspends a GitHub App on a user, organization, or business account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub API or webhook events is blocked for that account.\n\nYou must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", + "description": "Suspends a GitHub App on a user, organization, or enterprise account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub API or webhook events is blocked for that account.\n\nYou must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", "tags": [ "apps" ], @@ -107182,6 +107194,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -108282,6 +108300,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -115109,7 +115133,7 @@ }, "delete": { "summary": "Remove an organization member", - "description": "Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories.", + "description": "Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories.\n\n> [!NOTE]\n> If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team.", "tags": [ "orgs" ], @@ -121325,7 +121349,7 @@ }, "delete": { "summary": "Remove organization membership for a user", - "description": "In order to remove a user's membership with an organization, the authenticated user must be an organization owner.\n\nIf the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases.", + "description": "In order to remove a user's membership with an organization, the authenticated user must be an organization owner.\n\nIf the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases.\n\n> [!NOTE]\n> If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team.", "tags": [ "orgs" ], @@ -338000,6 +338024,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -580262,6 +580292,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -631521,6 +631557,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -813072,6 +813114,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -816132,6 +816180,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -819097,6 +819151,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -822062,6 +822122,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -825161,6 +825227,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -828267,6 +828339,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -833368,6 +833446,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" diff --git a/descriptions-next/api.github.com/dereferenced/api.github.com.deref.yaml b/descriptions-next/api.github.com/dereferenced/api.github.com.deref.yaml index e71abd5a07..6fae45b599 100644 --- a/descriptions-next/api.github.com/dereferenced/api.github.com.deref.yaml +++ b/descriptions-next/api.github.com/dereferenced/api.github.com.deref.yaml @@ -2304,6 +2304,10 @@ paths: type: integer examples: - 1 + client_id: + type: string + examples: + - Iv1.ab1112223334445c target_id: description: The ID of the user or organization this token is being scoped to. @@ -2879,7 +2883,7 @@ paths: delete: summary: Delete an installation for the authenticated app description: |- - Uninstalls a GitHub App on a user, organization, or business account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the "[Suspend an app installation](https://docs.github.com/rest/apps/apps#suspend-an-app-installation)" endpoint. + Uninstalls a GitHub App on a user, organization, or enterprise account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the "[Suspend an app installation](https://docs.github.com/rest/apps/apps#suspend-an-app-installation)" endpoint. You must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. tags: @@ -3738,7 +3742,7 @@ paths: put: summary: Suspend an app installation description: |- - Suspends a GitHub App on a user, organization, or business account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub API or webhook events is blocked for that account. + Suspends a GitHub App on a user, organization, or enterprise account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub API or webhook events is blocked for that account. You must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. tags: @@ -29949,8 +29953,11 @@ paths: subcategory: members delete: summary: Remove an organization member - description: Removing a user from this list will remove them from all teams - and they will no longer have any access to the organization's repositories. + description: |- + Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories. + + > [!NOTE] + > If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team. tags: - orgs operationId: orgs/remove-member @@ -30495,6 +30502,9 @@ paths: In order to remove a user's membership with an organization, the authenticated user must be an organization owner. If the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases. + + > [!NOTE] + > If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team. tags: - orgs operationId: orgs/remove-membership-for-user diff --git a/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.json b/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.json index c8b79ef1bc..8c848c42f1 100644 --- a/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.json +++ b/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.json @@ -5376,7 +5376,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -5410,6 +5410,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -6461,7 +6467,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -6495,6 +6501,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -7250,7 +7262,7 @@ }, "delete": { "summary": "Delete an installation for the authenticated app", - "description": "Uninstalls a GitHub App on a user, organization, or business account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the \"[Suspend an app installation](https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#suspend-an-app-installation)\" endpoint.\n\nYou must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", + "description": "Uninstalls a GitHub App on a user, organization, or enterprise account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the \"[Suspend an app installation](https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#suspend-an-app-installation)\" endpoint.\n\nYou must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", "tags": [ "apps" ], @@ -7317,7 +7329,7 @@ "/app/installations/{installation_id}/access_tokens": { "post": { "summary": "Create an installation access token for an app", - "description": "Creates an installation access token that enables a GitHub App to make authenticated API requests for the app's installation on an organization or individual account. Installation tokens expire one hour from the time you create them. Using an expired token produces a status code of `401 - Unauthorized`, and requires creating a new installation token. By default the installation token has access to all repositories that the installation can access.\n\nOptionally, you can use the `repositories` or `repository_ids` body parameters to specify individual repositories that the installation access token can access. If you don't use `repositories` or `repository_ids` to grant access to specific repositories, the installation access token will have access to all repositories that the installation was granted access to. The installation access token cannot be granted access to repositories that the installation was not granted access to. Up to 500 repositories can be listed in this manner.\n\nOptionally, use the `permissions` body parameter to specify the permissions that the installation access token should have. If `permissions` is not specified, the installation access token will have all of the permissions that were granted to the app. The installation access token cannot be granted permissions that the app was not granted.\n\nYou must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", + "description": "Creates an installation access token that enables a GitHub App to make authenticated API requests for the app's installation on an enterprise, organization, or individual account. Installation tokens expire one hour from the time you create them. Using an expired token produces a status code of `401 - Unauthorized`, and requires creating a new installation token. By default the installation token has access to all repositories that the installation can access.\n\nOptionally, you can use the `repositories` or `repository_ids` body parameters to specify individual repositories that the installation access token can access. If you don't use `repositories` or `repository_ids` to grant access to specific repositories, the installation access token will have access to all repositories that the installation was granted access to. The installation access token cannot be granted access to repositories that the installation was not granted access to. Up to 500 repositories can be listed in this manner.\n\nOptionally, use the `permissions` body parameter to specify the permissions that the installation access token should have. If `permissions` is not specified, the installation access token will have all of the permissions that were granted to the app. The installation access token cannot be granted permissions that the app was not granted.\n\nEnterprise account installations do not have access to repositories and cannot be scoped down using the `permissions` parameter.\n\nYou must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", "tags": [ "apps" ], @@ -7789,7 +7801,7 @@ "application/json": { "schema": { "title": "Installation Token", - "description": "Authentication token for a GitHub App installed on a user or org.", + "description": "Authentication token for a GitHub App installed on a user, org, or enterprise.", "type": "object", "properties": { "token": { @@ -9486,7 +9498,7 @@ "/app/installations/{installation_id}/suspended": { "put": { "summary": "Suspend an app installation", - "description": "Suspends a GitHub App on a user, organization, or business account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub Enterprise Cloud API or webhook events is blocked for that account.\n\nYou must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", + "description": "Suspends a GitHub App on a user, organization, or enterprise account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub Enterprise Cloud API or webhook events is blocked for that account.\n\nYou must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", "tags": [ "apps" ], @@ -27081,18 +27093,3366 @@ } } }, - "422": { - "description": "Validation failed, or the endpoint has been spammed.", + "422": { + "description": "Validation failed, or the endpoint has been spammed.", + "content": { + "application/json": { + "schema": { + "title": "Validation Error Simple", + "description": "Validation Error Simple", + "type": "object", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "errors": { + "type": "array", + "items": { + "type": "string" + } + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": false, + "category": "actions", + "subcategory": "self-hosted-runners" + } + } + }, + "/enterprises/{enterprise}/announcement": { + "get": { + "summary": "Get announcement banner for enterprise", + "description": "Gets the announcement banner currently set for the enterprise.", + "tags": [ + "enterprise-admin" + ], + "operationId": "announcement-banners/get-announcement-banner-for-enterprise", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/announcement-banners/enterprises#get-announcement-banner-for-enterprise" + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "title": "Announcement Banner", + "description": "Announcement at either the repository, organization, or enterprise level", + "type": "object", + "properties": { + "announcement": { + "type": [ + "string", + "null" + ], + "description": "The announcement text in GitHub Flavored Markdown. For more information about GitHub Flavored Markdown, see \"[Basic writing and formatting syntax](https://docs.github.com/enterprise-cloud@latest//github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax).\"", + "examples": [ + "Very **important** announcement about _something_." + ] + }, + "expires_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "The time at which the announcement expires. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`. To set an announcement that never expires, omit this parameter, set it to `null`, or set it to an empty string.", + "examples": [ + "\"2021-01-01T00:00:00.000-07:00\"" + ] + }, + "user_dismissible": { + "type": [ + "boolean", + "null" + ], + "description": "Whether an announcement can be dismissed by the user.", + "default": false, + "examples": [ + false + ] + } + }, + "required": [ + "announcement", + "expires_at", + "user_dismissible" + ] + }, + "examples": { + "default": { + "summary": "Announcement banner", + "value": { + "announcement": "Very **important** announcement about _something_.", + "expires_at": "2021-01-01T00:00:00.000+00:00", + "user_dismissible": false + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": false, + "category": "announcement-banners", + "subcategory": "enterprises" + } + }, + "patch": { + "summary": "Set announcement banner for enterprise", + "description": "Sets the announcement banner to display for the enterprise.", + "tags": [ + "enterprise-admin" + ], + "operationId": "announcement-banners/set-announcement-banner-for-enterprise", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/announcement-banners/enterprises#set-announcement-banner-for-enterprise" + }, + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "title": "Enterprise Announcement", + "description": "Enterprise global announcement", + "type": "object", + "properties": { + "announcement": { + "type": [ + "string", + "null" + ], + "description": "The announcement text in GitHub Flavored Markdown. For more information about GitHub Flavored Markdown, see \"[Basic writing and formatting syntax](https://docs.github.com/enterprise-cloud@latest//github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax).\"", + "examples": [ + "Very **important** announcement about _something_." + ] + }, + "expires_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "The time at which the announcement expires. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`. To set an announcement that never expires, omit this parameter, set it to `null`, or set it to an empty string.", + "examples": [ + "\"2021-01-01T00:00:00.000-07:00\"" + ] + }, + "user_dismissible": { + "type": [ + "boolean", + "null" + ], + "description": "Whether an announcement can be dismissed by the user.", + "default": false, + "examples": [ + false + ] + } + }, + "required": [ + "announcement" + ] + }, + "examples": { + "default": { + "summary": "Announcement banner", + "value": { + "announcement": "Very **important** announcement about _something_.", + "expires_at": "2021-01-01T00:00:00.000+00:00", + "user_dismissible": false + } + } + } + } + } + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "title": "Announcement Banner", + "description": "Announcement at either the repository, organization, or enterprise level", + "type": "object", + "properties": { + "announcement": { + "type": [ + "string", + "null" + ], + "description": "The announcement text in GitHub Flavored Markdown. For more information about GitHub Flavored Markdown, see \"[Basic writing and formatting syntax](https://docs.github.com/enterprise-cloud@latest//github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax).\"", + "examples": [ + "Very **important** announcement about _something_." + ] + }, + "expires_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "The time at which the announcement expires. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`. To set an announcement that never expires, omit this parameter, set it to `null`, or set it to an empty string.", + "examples": [ + "\"2021-01-01T00:00:00.000-07:00\"" + ] + }, + "user_dismissible": { + "type": [ + "boolean", + "null" + ], + "description": "Whether an announcement can be dismissed by the user.", + "default": false, + "examples": [ + false + ] + } + }, + "required": [ + "announcement", + "expires_at", + "user_dismissible" + ] + }, + "examples": { + "default": { + "summary": "Announcement banner", + "value": { + "announcement": "Very **important** announcement about _something_.", + "expires_at": "2021-01-01T00:00:00.000+00:00", + "user_dismissible": false + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": false, + "category": "announcement-banners", + "subcategory": "enterprises" + } + }, + "delete": { + "summary": "Remove announcement banner from enterprise", + "description": "Removes the announcement banner currently set for the enterprise.", + "tags": [ + "enterprise-admin" + ], + "operationId": "announcement-banners/remove-announcement-banner-for-enterprise", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/announcement-banners/enterprises#remove-announcement-banner-from-enterprise" + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "204": { + "description": "Response" + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": false, + "category": "announcement-banners", + "subcategory": "enterprises" + } + } + }, + "/enterprises/{enterprise}/apps/installable_organizations": { + "get": { + "summary": "Get enterprise-owned organizations that can have GitHub Apps installed", + "description": "List the organizations owned by the enterprise, intended for use by GitHub Apps that are managing applications across the enterprise.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/installable-organizations", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#get-enterprise-owned-organizations-that-can-have-github-apps-installed" + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "per_page", + "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api).\"", + "in": "query", + "schema": { + "type": "integer", + "default": 30 + } + }, + { + "name": "page", + "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api).\"", + "in": "query", + "schema": { + "type": "integer", + "default": 1 + } + } + ], + "responses": { + "200": { + "description": "A list of organizations owned by the enterprise on which the authenticated GitHub App is installed.", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "title": "Installable Organization", + "description": "A GitHub organization on which a GitHub App can be installed.", + "type": "object", + "properties": { + "id": { + "type": "integer", + "examples": [ + 1 + ] + }, + "login": { + "type": "string", + "examples": [ + "github" + ] + }, + "accessible_repositories_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/enterprises/biz-name/apps/organizations/org-login/accessible_repositories" + ] + } + }, + "required": [ + "id", + "login" + ] + } + }, + "examples": { + "default": { + "value": [ + { + "id": 1, + "login": "github" + }, + { + "id": 2, + "login": "microsoft" + } + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + } + }, + "/enterprises/{enterprise}/apps/installable_organizations/{org}/accessible_repositories": { + "get": { + "summary": "Get repositories belonging to an enterprise-owned organization", + "description": "List the repositories belonging to an enterprise-owned organization that can be made accessible to a GitHub App installed on that organization. This API provides a shallow list of repositories in the organization, allowing the caller to then add or remove those repositories to an installation in that organization.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/installable-organization-accessible-repositories", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#get-repositories-belonging-to-an-enterprise-owned-organization" + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "per_page", + "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api).\"", + "in": "query", + "schema": { + "type": "integer", + "default": 30 + } + }, + { + "name": "page", + "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api).\"", + "in": "query", + "schema": { + "type": "integer", + "default": 1 + } + } + ], + "responses": { + "200": { + "description": "A list of repositories owned by the enterprise organization on which the authenticated GitHub App is installed.", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "title": "Accessible Repository", + "description": "A repository that may be made accessible to a GitHub App.", + "type": "object", + "properties": { + "id": { + "description": "Unique identifier of the repository", + "type": "integer", + "format": "int64", + "examples": [ + 1 + ] + }, + "name": { + "description": "The name of the repository.", + "type": "string", + "examples": [ + "Team Environment" + ] + }, + "full_name": { + "type": "string", + "examples": [ + "octocat/Hello-World" + ] + } + }, + "required": [ + "full_name", + "id", + "name" + ] + } + }, + "examples": { + "default": { + "value": [ + { + "id": 1, + "name": "Hello World", + "full_name": "octocat/Hello-World" + }, + { + "id": 2, + "login": "Goodbye World", + "full_name": "octocat/Goodbye-World" + } + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + } + }, + "/enterprises/{enterprise}/apps/organizations/{org}/installations": { + "get": { + "summary": "List GitHub Apps installed on an enterprise-owned organization", + "description": "Lists the GitHub App installations associated with the given enterprise-owned organization. This lists all GitHub Apps that have been installed on the organization, regardless of who owns the application.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/organization-installations", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#list-github-apps-installed-on-an-enterprise-owned-organization" + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "per_page", + "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api).\"", + "in": "query", + "schema": { + "type": "integer", + "default": 30 + } + }, + { + "name": "page", + "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api).\"", + "in": "query", + "schema": { + "type": "integer", + "default": 1 + } + } + ], + "responses": { + "200": { + "description": "A list of GitHub App installations that have been granted access to the organization", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "title": "Enterprise Organization Installation", + "description": "A GitHub App Installation on an enterprise-owned organization", + "type": "object", + "properties": { + "id": { + "description": "The ID of the installation.", + "type": "integer", + "examples": [ + 1 + ] + }, + "app_slug": { + "type": "string", + "examples": [ + "github/github-actions" + ] + }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, + "repository_selection": { + "description": "Describe whether all repositories have been selected or there's a selection involved", + "type": "string", + "enum": [ + "all", + "selected" + ] + }, + "repositories_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/enterprises/acme-corp/apps/organizations/some-org/installations/1/repositories" + ] + }, + "permissions": { + "title": "App Permissions", + "type": "object", + "description": "The permissions granted to the user access token.", + "properties": { + "actions": { + "type": "string", + "description": "The level of permission to grant the access token for GitHub Actions workflows, workflow runs, and artifacts.", + "enum": [ + "read", + "write" + ] + }, + "administration": { + "type": "string", + "description": "The level of permission to grant the access token for repository creation, deletion, settings, teams, and collaborators creation.", + "enum": [ + "read", + "write" + ] + }, + "checks": { + "type": "string", + "description": "The level of permission to grant the access token for checks on code.", + "enum": [ + "read", + "write" + ] + }, + "codespaces": { + "type": "string", + "description": "The level of permission to grant the access token to create, edit, delete, and list Codespaces.", + "enum": [ + "read", + "write" + ] + }, + "contents": { + "type": "string", + "description": "The level of permission to grant the access token for repository contents, commits, branches, downloads, releases, and merges.", + "enum": [ + "read", + "write" + ] + }, + "dependabot_secrets": { + "type": "string", + "description": "The level of permission to grant the access token to manage Dependabot secrets.", + "enum": [ + "read", + "write" + ] + }, + "deployments": { + "type": "string", + "description": "The level of permission to grant the access token for deployments and deployment statuses.", + "enum": [ + "read", + "write" + ] + }, + "environments": { + "type": "string", + "description": "The level of permission to grant the access token for managing repository environments.", + "enum": [ + "read", + "write" + ] + }, + "issues": { + "type": "string", + "description": "The level of permission to grant the access token for issues and related comments, assignees, labels, and milestones.", + "enum": [ + "read", + "write" + ] + }, + "metadata": { + "type": "string", + "description": "The level of permission to grant the access token to search repositories, list collaborators, and access repository metadata.", + "enum": [ + "read", + "write" + ] + }, + "packages": { + "type": "string", + "description": "The level of permission to grant the access token for packages published to GitHub Packages.", + "enum": [ + "read", + "write" + ] + }, + "pages": { + "type": "string", + "description": "The level of permission to grant the access token to retrieve Pages statuses, configuration, and builds, as well as create new builds.", + "enum": [ + "read", + "write" + ] + }, + "pull_requests": { + "type": "string", + "description": "The level of permission to grant the access token for pull requests and related comments, assignees, labels, milestones, and merges.", + "enum": [ + "read", + "write" + ] + }, + "repository_custom_properties": { + "type": "string", + "description": "The level of permission to grant the access token to view and edit custom properties for a repository, when allowed by the property.", + "enum": [ + "read", + "write" + ] + }, + "repository_hooks": { + "type": "string", + "description": "The level of permission to grant the access token to manage the post-receive hooks for a repository.", + "enum": [ + "read", + "write" + ] + }, + "repository_projects": { + "type": "string", + "description": "The level of permission to grant the access token to manage repository projects, columns, and cards.", + "enum": [ + "read", + "write", + "admin" + ] + }, + "secret_scanning_alerts": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage secret scanning alerts.", + "enum": [ + "read", + "write" + ] + }, + "secrets": { + "type": "string", + "description": "The level of permission to grant the access token to manage repository secrets.", + "enum": [ + "read", + "write" + ] + }, + "security_events": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage security events like code scanning alerts.", + "enum": [ + "read", + "write" + ] + }, + "single_file": { + "type": "string", + "description": "The level of permission to grant the access token to manage just a single file.", + "enum": [ + "read", + "write" + ] + }, + "statuses": { + "type": "string", + "description": "The level of permission to grant the access token for commit statuses.", + "enum": [ + "read", + "write" + ] + }, + "vulnerability_alerts": { + "type": "string", + "description": "The level of permission to grant the access token to manage Dependabot alerts.", + "enum": [ + "read", + "write" + ] + }, + "workflows": { + "type": "string", + "description": "The level of permission to grant the access token to update GitHub Actions workflow files.", + "enum": [ + "write" + ] + }, + "members": { + "type": "string", + "description": "The level of permission to grant the access token for organization teams and members.", + "enum": [ + "read", + "write" + ] + }, + "organization_administration": { + "type": "string", + "description": "The level of permission to grant the access token to manage access to an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_custom_roles": { + "type": "string", + "description": "The level of permission to grant the access token for custom repository roles management.", + "enum": [ + "read", + "write" + ] + }, + "organization_custom_org_roles": { + "type": "string", + "description": "The level of permission to grant the access token for custom organization roles management.", + "enum": [ + "read", + "write" + ] + }, + "organization_custom_properties": { + "type": "string", + "description": "The level of permission to grant the access token for custom property management.", + "enum": [ + "read", + "write", + "admin" + ] + }, + "organization_copilot_seat_management": { + "type": "string", + "description": "The level of permission to grant the access token for managing access to GitHub Copilot for members of an organization with a Copilot Business subscription. This property is in public preview and is subject to change.", + "enum": [ + "write" + ] + }, + "organization_announcement_banners": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage announcement banners for an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_events": { + "type": "string", + "description": "The level of permission to grant the access token to view events triggered by an activity in an organization.", + "enum": [ + "read" + ] + }, + "organization_hooks": { + "type": "string", + "description": "The level of permission to grant the access token to manage the post-receive hooks for an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_personal_access_tokens": { + "type": "string", + "description": "The level of permission to grant the access token for viewing and managing fine-grained personal access token requests to an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_personal_access_token_requests": { + "type": "string", + "description": "The level of permission to grant the access token for viewing and managing fine-grained personal access tokens that have been approved by an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_plan": { + "type": "string", + "description": "The level of permission to grant the access token for viewing an organization's plan.", + "enum": [ + "read" + ] + }, + "organization_projects": { + "type": "string", + "description": "The level of permission to grant the access token to manage organization projects and projects public preview (where available).", + "enum": [ + "read", + "write", + "admin" + ] + }, + "organization_packages": { + "type": "string", + "description": "The level of permission to grant the access token for organization packages published to GitHub Packages.", + "enum": [ + "read", + "write" + ] + }, + "organization_secrets": { + "type": "string", + "description": "The level of permission to grant the access token to manage organization secrets.", + "enum": [ + "read", + "write" + ] + }, + "organization_self_hosted_runners": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage GitHub Actions self-hosted runners available to an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_user_blocking": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage users blocked by the organization.", + "enum": [ + "read", + "write" + ] + }, + "team_discussions": { + "type": "string", + "description": "The level of permission to grant the access token to manage team discussions and related comments.", + "enum": [ + "read", + "write" + ] + }, + "email_addresses": { + "type": "string", + "description": "The level of permission to grant the access token to manage the email addresses belonging to a user.", + "enum": [ + "read", + "write" + ] + }, + "followers": { + "type": "string", + "description": "The level of permission to grant the access token to manage the followers belonging to a user.", + "enum": [ + "read", + "write" + ] + }, + "git_ssh_keys": { + "type": "string", + "description": "The level of permission to grant the access token to manage git SSH keys.", + "enum": [ + "read", + "write" + ] + }, + "gpg_keys": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage GPG keys belonging to a user.", + "enum": [ + "read", + "write" + ] + }, + "interaction_limits": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage interaction limits on a repository.", + "enum": [ + "read", + "write" + ] + }, + "profile": { + "type": "string", + "description": "The level of permission to grant the access token to manage the profile settings belonging to a user.", + "enum": [ + "write" + ] + }, + "starring": { + "type": "string", + "description": "The level of permission to grant the access token to list and manage repositories a user is starring.", + "enum": [ + "read", + "write" + ] + } + }, + "example": { + "contents": "read", + "issues": "read", + "deployments": "write", + "single_file": "read" + } + }, + "events": { + "type": "array", + "items": { + "type": "string" + } + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" + } + }, + "required": [ + "id", + "client_id", + "repository_selection", + "repositories_url", + "permissions", + "created_at", + "updated_at" + ] + } + }, + "examples": { + "default": { + "value": [ + { + "value": { + "id": 1, + "app_slug": "monalisa/orbit", + "repository_selection": "selected", + "repositories_url": "https://api.github.com/enterprises/acme-corp/apps/organizations/some-org/installations/1/repositories", + "permissions": { + "checks": "write", + "metadata": "read", + "contents": "read" + }, + "events": [ + "push", + "pull_request" + ], + "created_at": "2017-07-08T16:18:44-04:00", + "updated_at": "2017-07-08T16:18:44-04:00" + } + } + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + }, + "post": { + "summary": "Install a GitHub App on an enterprise-owned organization", + "description": "Installs any valid GitHub App on the specified organization owned by the enterprise. If the app is already installed on the organization, and is suspended, it will be unsuspended.\nIf the app has a pending installation request, they will all be approved.\n\nIf the app is already installed and has a pending update request, it will be updated to the latest version. If the app is now requesting repository permissions, it will be given access to the repositories listed in the request or fail if no `repository_selection` is provided.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/create-installation", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#install-a-github-app-on-an-enterprise-owned-organization" + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "A GitHub App installation that was installed previously.", + "content": { + "application/json": { + "schema": { + "title": "Installation", + "description": "Installation", + "type": "object", + "properties": { + "id": { + "description": "The ID of the installation.", + "type": "integer", + "examples": [ + 1 + ] + }, + "account": { + "anyOf": [ + { + "title": "Simple User", + "description": "A GitHub user.", + "type": "object", + "properties": { + "name": { + "type": [ + "string", + "null" + ] + }, + "email": { + "type": [ + "string", + "null" + ] + }, + "login": { + "type": "string", + "examples": [ + "octocat" + ] + }, + "id": { + "type": "integer", + "format": "int64", + "examples": [ + 1 + ] + }, + "node_id": { + "type": "string", + "examples": [ + "MDQ6VXNlcjE=" + ] + }, + "avatar_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/images/error/octocat_happy.gif" + ] + }, + "gravatar_id": { + "type": [ + "string", + "null" + ], + "examples": [ + "41d064eb2195891e12d0413f63227ea7" + ] + }, + "url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat" + ] + }, + "html_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/octocat" + ] + }, + "followers_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/followers" + ] + }, + "following_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/following{/other_user}" + ] + }, + "gists_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/gists{/gist_id}" + ] + }, + "starred_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/starred{/owner}{/repo}" + ] + }, + "subscriptions_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/subscriptions" + ] + }, + "organizations_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/orgs" + ] + }, + "repos_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/repos" + ] + }, + "events_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/events{/privacy}" + ] + }, + "received_events_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/received_events" + ] + }, + "type": { + "type": "string", + "examples": [ + "User" + ] + }, + "site_admin": { + "type": "boolean" + }, + "starred_at": { + "type": "string", + "examples": [ + "\"2020-07-09T00:17:55Z\"" + ] + }, + "user_view_type": { + "type": "string", + "examples": [ + "public" + ] + } + }, + "required": [ + "avatar_url", + "events_url", + "followers_url", + "following_url", + "gists_url", + "gravatar_id", + "html_url", + "id", + "node_id", + "login", + "organizations_url", + "received_events_url", + "repos_url", + "site_admin", + "starred_url", + "subscriptions_url", + "type", + "url" + ] + }, + { + "title": "Enterprise", + "description": "An enterprise on GitHub.", + "type": "object", + "properties": { + "description": { + "description": "A short description of the enterprise.", + "type": [ + "string", + "null" + ] + }, + "html_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/enterprises/octo-business" + ] + }, + "website_url": { + "description": "The enterprise's website URL.", + "type": [ + "string", + "null" + ], + "format": "uri" + }, + "id": { + "description": "Unique identifier of the enterprise", + "type": "integer", + "examples": [ + 42 + ] + }, + "node_id": { + "type": "string", + "examples": [ + "MDEwOlJlcG9zaXRvcnkxMjk2MjY5" + ] + }, + "name": { + "description": "The name of the enterprise.", + "type": "string", + "examples": [ + "Octo Business" + ] + }, + "slug": { + "description": "The slug url identifier for the enterprise.", + "type": "string", + "examples": [ + "octo-business" + ] + }, + "created_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "examples": [ + "2019-01-26T19:01:12Z" + ] + }, + "updated_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "examples": [ + "2019-01-26T19:14:43Z" + ] + }, + "avatar_url": { + "type": "string", + "format": "uri" + } + }, + "required": [ + "id", + "node_id", + "name", + "slug", + "html_url", + "created_at", + "updated_at", + "avatar_url" + ] + } + ], + "type": [ + "null", + "object" + ] + }, + "repository_selection": { + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", + "type": "string", + "enum": [ + "all", + "selected" + ] + }, + "access_tokens_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/app/installations/1/access_tokens" + ] + }, + "repositories_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/installation/repositories" + ] + }, + "html_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/organizations/github/settings/installations/1" + ] + }, + "app_id": { + "type": "integer", + "examples": [ + 1 + ] + }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, + "target_id": { + "description": "The ID of the user or organization this token is being scoped to.", + "type": "integer" + }, + "target_type": { + "type": "string", + "examples": [ + "Organization" + ] + }, + "permissions": { + "title": "App Permissions", + "type": "object", + "description": "The permissions granted to the user access token.", + "properties": { + "actions": { + "type": "string", + "description": "The level of permission to grant the access token for GitHub Actions workflows, workflow runs, and artifacts.", + "enum": [ + "read", + "write" + ] + }, + "administration": { + "type": "string", + "description": "The level of permission to grant the access token for repository creation, deletion, settings, teams, and collaborators creation.", + "enum": [ + "read", + "write" + ] + }, + "checks": { + "type": "string", + "description": "The level of permission to grant the access token for checks on code.", + "enum": [ + "read", + "write" + ] + }, + "codespaces": { + "type": "string", + "description": "The level of permission to grant the access token to create, edit, delete, and list Codespaces.", + "enum": [ + "read", + "write" + ] + }, + "contents": { + "type": "string", + "description": "The level of permission to grant the access token for repository contents, commits, branches, downloads, releases, and merges.", + "enum": [ + "read", + "write" + ] + }, + "dependabot_secrets": { + "type": "string", + "description": "The level of permission to grant the access token to manage Dependabot secrets.", + "enum": [ + "read", + "write" + ] + }, + "deployments": { + "type": "string", + "description": "The level of permission to grant the access token for deployments and deployment statuses.", + "enum": [ + "read", + "write" + ] + }, + "environments": { + "type": "string", + "description": "The level of permission to grant the access token for managing repository environments.", + "enum": [ + "read", + "write" + ] + }, + "issues": { + "type": "string", + "description": "The level of permission to grant the access token for issues and related comments, assignees, labels, and milestones.", + "enum": [ + "read", + "write" + ] + }, + "metadata": { + "type": "string", + "description": "The level of permission to grant the access token to search repositories, list collaborators, and access repository metadata.", + "enum": [ + "read", + "write" + ] + }, + "packages": { + "type": "string", + "description": "The level of permission to grant the access token for packages published to GitHub Packages.", + "enum": [ + "read", + "write" + ] + }, + "pages": { + "type": "string", + "description": "The level of permission to grant the access token to retrieve Pages statuses, configuration, and builds, as well as create new builds.", + "enum": [ + "read", + "write" + ] + }, + "pull_requests": { + "type": "string", + "description": "The level of permission to grant the access token for pull requests and related comments, assignees, labels, milestones, and merges.", + "enum": [ + "read", + "write" + ] + }, + "repository_custom_properties": { + "type": "string", + "description": "The level of permission to grant the access token to view and edit custom properties for a repository, when allowed by the property.", + "enum": [ + "read", + "write" + ] + }, + "repository_hooks": { + "type": "string", + "description": "The level of permission to grant the access token to manage the post-receive hooks for a repository.", + "enum": [ + "read", + "write" + ] + }, + "repository_projects": { + "type": "string", + "description": "The level of permission to grant the access token to manage repository projects, columns, and cards.", + "enum": [ + "read", + "write", + "admin" + ] + }, + "secret_scanning_alerts": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage secret scanning alerts.", + "enum": [ + "read", + "write" + ] + }, + "secrets": { + "type": "string", + "description": "The level of permission to grant the access token to manage repository secrets.", + "enum": [ + "read", + "write" + ] + }, + "security_events": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage security events like code scanning alerts.", + "enum": [ + "read", + "write" + ] + }, + "single_file": { + "type": "string", + "description": "The level of permission to grant the access token to manage just a single file.", + "enum": [ + "read", + "write" + ] + }, + "statuses": { + "type": "string", + "description": "The level of permission to grant the access token for commit statuses.", + "enum": [ + "read", + "write" + ] + }, + "vulnerability_alerts": { + "type": "string", + "description": "The level of permission to grant the access token to manage Dependabot alerts.", + "enum": [ + "read", + "write" + ] + }, + "workflows": { + "type": "string", + "description": "The level of permission to grant the access token to update GitHub Actions workflow files.", + "enum": [ + "write" + ] + }, + "members": { + "type": "string", + "description": "The level of permission to grant the access token for organization teams and members.", + "enum": [ + "read", + "write" + ] + }, + "organization_administration": { + "type": "string", + "description": "The level of permission to grant the access token to manage access to an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_custom_roles": { + "type": "string", + "description": "The level of permission to grant the access token for custom repository roles management.", + "enum": [ + "read", + "write" + ] + }, + "organization_custom_org_roles": { + "type": "string", + "description": "The level of permission to grant the access token for custom organization roles management.", + "enum": [ + "read", + "write" + ] + }, + "organization_custom_properties": { + "type": "string", + "description": "The level of permission to grant the access token for custom property management.", + "enum": [ + "read", + "write", + "admin" + ] + }, + "organization_copilot_seat_management": { + "type": "string", + "description": "The level of permission to grant the access token for managing access to GitHub Copilot for members of an organization with a Copilot Business subscription. This property is in public preview and is subject to change.", + "enum": [ + "write" + ] + }, + "organization_announcement_banners": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage announcement banners for an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_events": { + "type": "string", + "description": "The level of permission to grant the access token to view events triggered by an activity in an organization.", + "enum": [ + "read" + ] + }, + "organization_hooks": { + "type": "string", + "description": "The level of permission to grant the access token to manage the post-receive hooks for an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_personal_access_tokens": { + "type": "string", + "description": "The level of permission to grant the access token for viewing and managing fine-grained personal access token requests to an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_personal_access_token_requests": { + "type": "string", + "description": "The level of permission to grant the access token for viewing and managing fine-grained personal access tokens that have been approved by an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_plan": { + "type": "string", + "description": "The level of permission to grant the access token for viewing an organization's plan.", + "enum": [ + "read" + ] + }, + "organization_projects": { + "type": "string", + "description": "The level of permission to grant the access token to manage organization projects and projects public preview (where available).", + "enum": [ + "read", + "write", + "admin" + ] + }, + "organization_packages": { + "type": "string", + "description": "The level of permission to grant the access token for organization packages published to GitHub Packages.", + "enum": [ + "read", + "write" + ] + }, + "organization_secrets": { + "type": "string", + "description": "The level of permission to grant the access token to manage organization secrets.", + "enum": [ + "read", + "write" + ] + }, + "organization_self_hosted_runners": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage GitHub Actions self-hosted runners available to an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_user_blocking": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage users blocked by the organization.", + "enum": [ + "read", + "write" + ] + }, + "team_discussions": { + "type": "string", + "description": "The level of permission to grant the access token to manage team discussions and related comments.", + "enum": [ + "read", + "write" + ] + }, + "email_addresses": { + "type": "string", + "description": "The level of permission to grant the access token to manage the email addresses belonging to a user.", + "enum": [ + "read", + "write" + ] + }, + "followers": { + "type": "string", + "description": "The level of permission to grant the access token to manage the followers belonging to a user.", + "enum": [ + "read", + "write" + ] + }, + "git_ssh_keys": { + "type": "string", + "description": "The level of permission to grant the access token to manage git SSH keys.", + "enum": [ + "read", + "write" + ] + }, + "gpg_keys": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage GPG keys belonging to a user.", + "enum": [ + "read", + "write" + ] + }, + "interaction_limits": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage interaction limits on a repository.", + "enum": [ + "read", + "write" + ] + }, + "profile": { + "type": "string", + "description": "The level of permission to grant the access token to manage the profile settings belonging to a user.", + "enum": [ + "write" + ] + }, + "starring": { + "type": "string", + "description": "The level of permission to grant the access token to list and manage repositories a user is starring.", + "enum": [ + "read", + "write" + ] + } + }, + "example": { + "contents": "read", + "issues": "read", + "deployments": "write", + "single_file": "read" + } + }, + "events": { + "type": "array", + "items": { + "type": "string" + } + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" + }, + "single_file_name": { + "type": [ + "string", + "null" + ], + "examples": [ + "config.yaml" + ] + }, + "has_multiple_single_files": { + "type": "boolean", + "examples": [ + true + ] + }, + "single_file_paths": { + "type": "array", + "items": { + "type": "string" + }, + "examples": [ + "config.yml", + ".github/issue_TEMPLATE.md" + ] + }, + "app_slug": { + "type": "string", + "examples": [ + "github-actions" + ] + }, + "suspended_by": { + "anyOf": [ + { + "type": "null" + }, + { + "title": "Simple User", + "description": "A GitHub user.", + "type": "object", + "properties": { + "name": { + "type": [ + "string", + "null" + ] + }, + "email": { + "type": [ + "string", + "null" + ] + }, + "login": { + "type": "string", + "examples": [ + "octocat" + ] + }, + "id": { + "type": "integer", + "format": "int64", + "examples": [ + 1 + ] + }, + "node_id": { + "type": "string", + "examples": [ + "MDQ6VXNlcjE=" + ] + }, + "avatar_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/images/error/octocat_happy.gif" + ] + }, + "gravatar_id": { + "type": [ + "string", + "null" + ], + "examples": [ + "41d064eb2195891e12d0413f63227ea7" + ] + }, + "url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat" + ] + }, + "html_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/octocat" + ] + }, + "followers_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/followers" + ] + }, + "following_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/following{/other_user}" + ] + }, + "gists_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/gists{/gist_id}" + ] + }, + "starred_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/starred{/owner}{/repo}" + ] + }, + "subscriptions_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/subscriptions" + ] + }, + "organizations_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/orgs" + ] + }, + "repos_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/repos" + ] + }, + "events_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/events{/privacy}" + ] + }, + "received_events_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/received_events" + ] + }, + "type": { + "type": "string", + "examples": [ + "User" + ] + }, + "site_admin": { + "type": "boolean" + }, + "starred_at": { + "type": "string", + "examples": [ + "\"2020-07-09T00:17:55Z\"" + ] + }, + "user_view_type": { + "type": "string", + "examples": [ + "public" + ] + } + }, + "required": [ + "avatar_url", + "events_url", + "followers_url", + "following_url", + "gists_url", + "gravatar_id", + "html_url", + "id", + "node_id", + "login", + "organizations_url", + "received_events_url", + "repos_url", + "site_admin", + "starred_url", + "subscriptions_url", + "type", + "url" + ] + } + ] + }, + "suspended_at": { + "type": [ + "string", + "null" + ], + "format": "date-time" + }, + "contact_email": { + "type": [ + "string", + "null" + ], + "examples": [ + "\"test_13f1e99741e3e004@d7e1eb0bc0a1ba12.com\"" + ] + } + }, + "required": [ + "id", + "app_id", + "app_slug", + "target_id", + "target_type", + "single_file_name", + "repository_selection", + "access_tokens_url", + "html_url", + "repositories_url", + "events", + "account", + "permissions", + "created_at", + "updated_at", + "suspended_by", + "suspended_at" + ] + }, + "examples": { + "default": { + "value": { + "id": 1, + "account": { + "login": "octocat", + "id": 1, + "node_id": "MDQ6VXNlcjE=", + "avatar_url": "https://github.com/images/error/octocat_happy.gif", + "gravatar_id": "", + "url": "https://api.github.com/users/octocat", + "html_url": "https://github.com/octocat", + "followers_url": "https://api.github.com/users/octocat/followers", + "following_url": "https://api.github.com/users/octocat/following{/other_user}", + "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", + "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", + "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", + "organizations_url": "https://api.github.com/users/octocat/orgs", + "repos_url": "https://api.github.com/users/octocat/repos", + "events_url": "https://api.github.com/users/octocat/events{/privacy}", + "received_events_url": "https://api.github.com/users/octocat/received_events", + "type": "User", + "site_admin": false + }, + "access_tokens_url": "https://api.github.com/app/installations/1/access_tokens", + "repositories_url": "https://api.github.com/installation/repositories", + "html_url": "https://github.com/organizations/github/settings/installations/1", + "app_id": 1, + "target_id": 1, + "target_type": "Organization", + "permissions": { + "checks": "write", + "metadata": "read", + "contents": "read" + }, + "events": [ + "push", + "pull_request" + ], + "single_file_name": "config.yaml", + "has_multiple_single_files": true, + "single_file_paths": [ + "config.yml", + ".github/issue_TEMPLATE.md" + ], + "repository_selection": "selected", + "created_at": "2017-07-08T16:18:44-04:00", + "updated_at": "2017-07-08T16:18:44-04:00", + "app_slug": "github-actions", + "suspended_at": null, + "suspended_by": null + } + } + } + } + } + }, + "201": { + "description": "A GitHub App installation.", + "content": { + "application/json": { + "schema": { + "title": "Installation", + "description": "Installation", + "type": "object", + "properties": { + "id": { + "description": "The ID of the installation.", + "type": "integer", + "examples": [ + 1 + ] + }, + "account": { + "anyOf": [ + { + "title": "Simple User", + "description": "A GitHub user.", + "type": "object", + "properties": { + "name": { + "type": [ + "string", + "null" + ] + }, + "email": { + "type": [ + "string", + "null" + ] + }, + "login": { + "type": "string", + "examples": [ + "octocat" + ] + }, + "id": { + "type": "integer", + "format": "int64", + "examples": [ + 1 + ] + }, + "node_id": { + "type": "string", + "examples": [ + "MDQ6VXNlcjE=" + ] + }, + "avatar_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/images/error/octocat_happy.gif" + ] + }, + "gravatar_id": { + "type": [ + "string", + "null" + ], + "examples": [ + "41d064eb2195891e12d0413f63227ea7" + ] + }, + "url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat" + ] + }, + "html_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/octocat" + ] + }, + "followers_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/followers" + ] + }, + "following_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/following{/other_user}" + ] + }, + "gists_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/gists{/gist_id}" + ] + }, + "starred_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/starred{/owner}{/repo}" + ] + }, + "subscriptions_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/subscriptions" + ] + }, + "organizations_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/orgs" + ] + }, + "repos_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/repos" + ] + }, + "events_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/events{/privacy}" + ] + }, + "received_events_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/received_events" + ] + }, + "type": { + "type": "string", + "examples": [ + "User" + ] + }, + "site_admin": { + "type": "boolean" + }, + "starred_at": { + "type": "string", + "examples": [ + "\"2020-07-09T00:17:55Z\"" + ] + }, + "user_view_type": { + "type": "string", + "examples": [ + "public" + ] + } + }, + "required": [ + "avatar_url", + "events_url", + "followers_url", + "following_url", + "gists_url", + "gravatar_id", + "html_url", + "id", + "node_id", + "login", + "organizations_url", + "received_events_url", + "repos_url", + "site_admin", + "starred_url", + "subscriptions_url", + "type", + "url" + ] + }, + { + "title": "Enterprise", + "description": "An enterprise on GitHub.", + "type": "object", + "properties": { + "description": { + "description": "A short description of the enterprise.", + "type": [ + "string", + "null" + ] + }, + "html_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/enterprises/octo-business" + ] + }, + "website_url": { + "description": "The enterprise's website URL.", + "type": [ + "string", + "null" + ], + "format": "uri" + }, + "id": { + "description": "Unique identifier of the enterprise", + "type": "integer", + "examples": [ + 42 + ] + }, + "node_id": { + "type": "string", + "examples": [ + "MDEwOlJlcG9zaXRvcnkxMjk2MjY5" + ] + }, + "name": { + "description": "The name of the enterprise.", + "type": "string", + "examples": [ + "Octo Business" + ] + }, + "slug": { + "description": "The slug url identifier for the enterprise.", + "type": "string", + "examples": [ + "octo-business" + ] + }, + "created_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "examples": [ + "2019-01-26T19:01:12Z" + ] + }, + "updated_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "examples": [ + "2019-01-26T19:14:43Z" + ] + }, + "avatar_url": { + "type": "string", + "format": "uri" + } + }, + "required": [ + "id", + "node_id", + "name", + "slug", + "html_url", + "created_at", + "updated_at", + "avatar_url" + ] + } + ], + "type": [ + "null", + "object" + ] + }, + "repository_selection": { + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", + "type": "string", + "enum": [ + "all", + "selected" + ] + }, + "access_tokens_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/app/installations/1/access_tokens" + ] + }, + "repositories_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/installation/repositories" + ] + }, + "html_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/organizations/github/settings/installations/1" + ] + }, + "app_id": { + "type": "integer", + "examples": [ + 1 + ] + }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, + "target_id": { + "description": "The ID of the user or organization this token is being scoped to.", + "type": "integer" + }, + "target_type": { + "type": "string", + "examples": [ + "Organization" + ] + }, + "permissions": { + "title": "App Permissions", + "type": "object", + "description": "The permissions granted to the user access token.", + "properties": { + "actions": { + "type": "string", + "description": "The level of permission to grant the access token for GitHub Actions workflows, workflow runs, and artifacts.", + "enum": [ + "read", + "write" + ] + }, + "administration": { + "type": "string", + "description": "The level of permission to grant the access token for repository creation, deletion, settings, teams, and collaborators creation.", + "enum": [ + "read", + "write" + ] + }, + "checks": { + "type": "string", + "description": "The level of permission to grant the access token for checks on code.", + "enum": [ + "read", + "write" + ] + }, + "codespaces": { + "type": "string", + "description": "The level of permission to grant the access token to create, edit, delete, and list Codespaces.", + "enum": [ + "read", + "write" + ] + }, + "contents": { + "type": "string", + "description": "The level of permission to grant the access token for repository contents, commits, branches, downloads, releases, and merges.", + "enum": [ + "read", + "write" + ] + }, + "dependabot_secrets": { + "type": "string", + "description": "The level of permission to grant the access token to manage Dependabot secrets.", + "enum": [ + "read", + "write" + ] + }, + "deployments": { + "type": "string", + "description": "The level of permission to grant the access token for deployments and deployment statuses.", + "enum": [ + "read", + "write" + ] + }, + "environments": { + "type": "string", + "description": "The level of permission to grant the access token for managing repository environments.", + "enum": [ + "read", + "write" + ] + }, + "issues": { + "type": "string", + "description": "The level of permission to grant the access token for issues and related comments, assignees, labels, and milestones.", + "enum": [ + "read", + "write" + ] + }, + "metadata": { + "type": "string", + "description": "The level of permission to grant the access token to search repositories, list collaborators, and access repository metadata.", + "enum": [ + "read", + "write" + ] + }, + "packages": { + "type": "string", + "description": "The level of permission to grant the access token for packages published to GitHub Packages.", + "enum": [ + "read", + "write" + ] + }, + "pages": { + "type": "string", + "description": "The level of permission to grant the access token to retrieve Pages statuses, configuration, and builds, as well as create new builds.", + "enum": [ + "read", + "write" + ] + }, + "pull_requests": { + "type": "string", + "description": "The level of permission to grant the access token for pull requests and related comments, assignees, labels, milestones, and merges.", + "enum": [ + "read", + "write" + ] + }, + "repository_custom_properties": { + "type": "string", + "description": "The level of permission to grant the access token to view and edit custom properties for a repository, when allowed by the property.", + "enum": [ + "read", + "write" + ] + }, + "repository_hooks": { + "type": "string", + "description": "The level of permission to grant the access token to manage the post-receive hooks for a repository.", + "enum": [ + "read", + "write" + ] + }, + "repository_projects": { + "type": "string", + "description": "The level of permission to grant the access token to manage repository projects, columns, and cards.", + "enum": [ + "read", + "write", + "admin" + ] + }, + "secret_scanning_alerts": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage secret scanning alerts.", + "enum": [ + "read", + "write" + ] + }, + "secrets": { + "type": "string", + "description": "The level of permission to grant the access token to manage repository secrets.", + "enum": [ + "read", + "write" + ] + }, + "security_events": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage security events like code scanning alerts.", + "enum": [ + "read", + "write" + ] + }, + "single_file": { + "type": "string", + "description": "The level of permission to grant the access token to manage just a single file.", + "enum": [ + "read", + "write" + ] + }, + "statuses": { + "type": "string", + "description": "The level of permission to grant the access token for commit statuses.", + "enum": [ + "read", + "write" + ] + }, + "vulnerability_alerts": { + "type": "string", + "description": "The level of permission to grant the access token to manage Dependabot alerts.", + "enum": [ + "read", + "write" + ] + }, + "workflows": { + "type": "string", + "description": "The level of permission to grant the access token to update GitHub Actions workflow files.", + "enum": [ + "write" + ] + }, + "members": { + "type": "string", + "description": "The level of permission to grant the access token for organization teams and members.", + "enum": [ + "read", + "write" + ] + }, + "organization_administration": { + "type": "string", + "description": "The level of permission to grant the access token to manage access to an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_custom_roles": { + "type": "string", + "description": "The level of permission to grant the access token for custom repository roles management.", + "enum": [ + "read", + "write" + ] + }, + "organization_custom_org_roles": { + "type": "string", + "description": "The level of permission to grant the access token for custom organization roles management.", + "enum": [ + "read", + "write" + ] + }, + "organization_custom_properties": { + "type": "string", + "description": "The level of permission to grant the access token for custom property management.", + "enum": [ + "read", + "write", + "admin" + ] + }, + "organization_copilot_seat_management": { + "type": "string", + "description": "The level of permission to grant the access token for managing access to GitHub Copilot for members of an organization with a Copilot Business subscription. This property is in public preview and is subject to change.", + "enum": [ + "write" + ] + }, + "organization_announcement_banners": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage announcement banners for an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_events": { + "type": "string", + "description": "The level of permission to grant the access token to view events triggered by an activity in an organization.", + "enum": [ + "read" + ] + }, + "organization_hooks": { + "type": "string", + "description": "The level of permission to grant the access token to manage the post-receive hooks for an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_personal_access_tokens": { + "type": "string", + "description": "The level of permission to grant the access token for viewing and managing fine-grained personal access token requests to an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_personal_access_token_requests": { + "type": "string", + "description": "The level of permission to grant the access token for viewing and managing fine-grained personal access tokens that have been approved by an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_plan": { + "type": "string", + "description": "The level of permission to grant the access token for viewing an organization's plan.", + "enum": [ + "read" + ] + }, + "organization_projects": { + "type": "string", + "description": "The level of permission to grant the access token to manage organization projects and projects public preview (where available).", + "enum": [ + "read", + "write", + "admin" + ] + }, + "organization_packages": { + "type": "string", + "description": "The level of permission to grant the access token for organization packages published to GitHub Packages.", + "enum": [ + "read", + "write" + ] + }, + "organization_secrets": { + "type": "string", + "description": "The level of permission to grant the access token to manage organization secrets.", + "enum": [ + "read", + "write" + ] + }, + "organization_self_hosted_runners": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage GitHub Actions self-hosted runners available to an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_user_blocking": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage users blocked by the organization.", + "enum": [ + "read", + "write" + ] + }, + "team_discussions": { + "type": "string", + "description": "The level of permission to grant the access token to manage team discussions and related comments.", + "enum": [ + "read", + "write" + ] + }, + "email_addresses": { + "type": "string", + "description": "The level of permission to grant the access token to manage the email addresses belonging to a user.", + "enum": [ + "read", + "write" + ] + }, + "followers": { + "type": "string", + "description": "The level of permission to grant the access token to manage the followers belonging to a user.", + "enum": [ + "read", + "write" + ] + }, + "git_ssh_keys": { + "type": "string", + "description": "The level of permission to grant the access token to manage git SSH keys.", + "enum": [ + "read", + "write" + ] + }, + "gpg_keys": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage GPG keys belonging to a user.", + "enum": [ + "read", + "write" + ] + }, + "interaction_limits": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage interaction limits on a repository.", + "enum": [ + "read", + "write" + ] + }, + "profile": { + "type": "string", + "description": "The level of permission to grant the access token to manage the profile settings belonging to a user.", + "enum": [ + "write" + ] + }, + "starring": { + "type": "string", + "description": "The level of permission to grant the access token to list and manage repositories a user is starring.", + "enum": [ + "read", + "write" + ] + } + }, + "example": { + "contents": "read", + "issues": "read", + "deployments": "write", + "single_file": "read" + } + }, + "events": { + "type": "array", + "items": { + "type": "string" + } + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" + }, + "single_file_name": { + "type": [ + "string", + "null" + ], + "examples": [ + "config.yaml" + ] + }, + "has_multiple_single_files": { + "type": "boolean", + "examples": [ + true + ] + }, + "single_file_paths": { + "type": "array", + "items": { + "type": "string" + }, + "examples": [ + "config.yml", + ".github/issue_TEMPLATE.md" + ] + }, + "app_slug": { + "type": "string", + "examples": [ + "github-actions" + ] + }, + "suspended_by": { + "anyOf": [ + { + "type": "null" + }, + { + "title": "Simple User", + "description": "A GitHub user.", + "type": "object", + "properties": { + "name": { + "type": [ + "string", + "null" + ] + }, + "email": { + "type": [ + "string", + "null" + ] + }, + "login": { + "type": "string", + "examples": [ + "octocat" + ] + }, + "id": { + "type": "integer", + "format": "int64", + "examples": [ + 1 + ] + }, + "node_id": { + "type": "string", + "examples": [ + "MDQ6VXNlcjE=" + ] + }, + "avatar_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/images/error/octocat_happy.gif" + ] + }, + "gravatar_id": { + "type": [ + "string", + "null" + ], + "examples": [ + "41d064eb2195891e12d0413f63227ea7" + ] + }, + "url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat" + ] + }, + "html_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/octocat" + ] + }, + "followers_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/followers" + ] + }, + "following_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/following{/other_user}" + ] + }, + "gists_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/gists{/gist_id}" + ] + }, + "starred_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/starred{/owner}{/repo}" + ] + }, + "subscriptions_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/subscriptions" + ] + }, + "organizations_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/orgs" + ] + }, + "repos_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/repos" + ] + }, + "events_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/events{/privacy}" + ] + }, + "received_events_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/received_events" + ] + }, + "type": { + "type": "string", + "examples": [ + "User" + ] + }, + "site_admin": { + "type": "boolean" + }, + "starred_at": { + "type": "string", + "examples": [ + "\"2020-07-09T00:17:55Z\"" + ] + }, + "user_view_type": { + "type": "string", + "examples": [ + "public" + ] + } + }, + "required": [ + "avatar_url", + "events_url", + "followers_url", + "following_url", + "gists_url", + "gravatar_id", + "html_url", + "id", + "node_id", + "login", + "organizations_url", + "received_events_url", + "repos_url", + "site_admin", + "starred_url", + "subscriptions_url", + "type", + "url" + ] + } + ] + }, + "suspended_at": { + "type": [ + "string", + "null" + ], + "format": "date-time" + }, + "contact_email": { + "type": [ + "string", + "null" + ], + "examples": [ + "\"test_13f1e99741e3e004@d7e1eb0bc0a1ba12.com\"" + ] + } + }, + "required": [ + "id", + "app_id", + "app_slug", + "target_id", + "target_type", + "single_file_name", + "repository_selection", + "access_tokens_url", + "html_url", + "repositories_url", + "events", + "account", + "permissions", + "created_at", + "updated_at", + "suspended_by", + "suspended_at" + ] + }, + "examples": { + "default": { + "value": { + "id": 1, + "account": { + "login": "octocat", + "id": 1, + "node_id": "MDQ6VXNlcjE=", + "avatar_url": "https://github.com/images/error/octocat_happy.gif", + "gravatar_id": "", + "url": "https://api.github.com/users/octocat", + "html_url": "https://github.com/octocat", + "followers_url": "https://api.github.com/users/octocat/followers", + "following_url": "https://api.github.com/users/octocat/following{/other_user}", + "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", + "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", + "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", + "organizations_url": "https://api.github.com/users/octocat/orgs", + "repos_url": "https://api.github.com/users/octocat/repos", + "events_url": "https://api.github.com/users/octocat/events{/privacy}", + "received_events_url": "https://api.github.com/users/octocat/received_events", + "type": "User", + "site_admin": false + }, + "access_tokens_url": "https://api.github.com/app/installations/1/access_tokens", + "repositories_url": "https://api.github.com/installation/repositories", + "html_url": "https://github.com/organizations/github/settings/installations/1", + "app_id": 1, + "target_id": 1, + "target_type": "Organization", + "permissions": { + "checks": "write", + "metadata": "read", + "contents": "read" + }, + "events": [ + "push", + "pull_request" + ], + "single_file_name": "config.yaml", + "has_multiple_single_files": true, + "single_file_paths": [ + "config.yml", + ".github/issue_TEMPLATE.md" + ], + "repository_selection": "selected", + "created_at": "2017-07-08T16:18:44-04:00", + "updated_at": "2017-07-08T16:18:44-04:00", + "app_slug": "github-actions", + "suspended_at": null, + "suspended_by": null + } + } + } + } + } + } + }, + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "client_id": { + "type": "string", + "description": "The Client ID of the GitHub App to install." + }, + "repository_selection": { + "type": "string", + "description": "The repository selection for the GitHub App. Must be one of:\n* `all` - the installation can access all repositories in the organization.\n* `selected` - the installation can access only the listed repositories.\n* `none` - no repository permissions are requested. Only use when the app does not request repository permissions.", + "enum": [ + "all", + "selected", + "none" + ] + }, + "repositories": { + "type": "array", + "description": "The names of the repositories to which the installation will be granted access. This is the simple name of the repository, not the full name (e.g., `hello-world` not `octocat/hello-world`). This is only required when `repository_selection` is `selected`.", + "items": { + "type": "string" + }, + "maxItems": 50 + } + }, + "required": [ + "client_id", + "repository_selection" + ] + }, + "examples": { + "default": { + "summary": "Example of installing a GitHub App on an organization and granting access to all of its repositories.", + "value": { + "client_id": "Iv2abc123aabbcc", + "repository_selection": "all" + } + }, + "repository_selection_selected": { + "value": { + "client_id": "Iv2abc123aabbcc", + "repository_selection": "selected", + "repositories": [ + "hello-world", + "hello-world-2" + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + } + }, + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}": { + "delete": { + "summary": "Uninstall a GitHub App from an enterprise-owned organization", + "description": "Uninstall a GitHub App from an organization. Any app installed on the organization can be removed.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/delete-installation", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#uninstall-a-github-app-from-an-enterprise-owned-organization" + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "installation_id", + "description": "The unique identifier of the installation.", + "in": "path", + "required": true, + "schema": { + "type": "integer" + }, + "examples": { + "default": { + "value": 1 + } + } + } + ], + "responses": { + "204": { + "description": "An empty response indicates that the installation was successfully removed." + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + }, + "403": { + "description": "Forbidden", "content": { "application/json": { "schema": { - "title": "Validation Error Simple", - "description": "Validation Error Simple", + "title": "Basic Error", + "description": "Basic Error", "type": "object", - "required": [ - "message", - "documentation_url" - ], "properties": { "message": { "type": "string" @@ -27100,11 +30460,11 @@ "documentation_url": { "type": "string" }, - "errors": { - "type": "array", - "items": { - "type": "string" - } + "url": { + "type": "string" + }, + "status": { + "type": "string" } } } @@ -27114,23 +30474,23 @@ }, "x-github": { "githubCloudOnly": true, - "enabledForGitHubApps": false, - "category": "actions", - "subcategory": "self-hosted-runners" + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" } } }, - "/enterprises/{enterprise}/announcement": { + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}/repositories": { "get": { - "summary": "Get announcement banner for enterprise", - "description": "Gets the announcement banner currently set for the enterprise.", + "summary": "Get the repositories accessible to a given GitHub App installation", + "description": "Lists the repositories accessible to a given GitHub App installation on an enterprise-owned organization.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", "tags": [ - "enterprise-admin" + "apps" ], - "operationId": "announcement-banners/get-announcement-banner-for-enterprise", + "operationId": "enterprise-apps/organization-installation-repositories", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/enterprise-cloud@latest//rest/announcement-banners/enterprises#get-announcement-banner-for-enterprise" + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#get-the-repositories-accessible-to-a-given-github-app-installation" }, "parameters": [ { @@ -27141,65 +30501,104 @@ "schema": { "type": "string" } + }, + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "installation_id", + "description": "The unique identifier of the installation.", + "in": "path", + "required": true, + "schema": { + "type": "integer" + }, + "examples": { + "default": { + "value": 1 + } + } + }, + { + "name": "per_page", + "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api).\"", + "in": "query", + "schema": { + "type": "integer", + "default": 30 + } + }, + { + "name": "page", + "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api).\"", + "in": "query", + "schema": { + "type": "integer", + "default": 1 + } } ], "responses": { "200": { - "description": "Response", + "description": "A list of repositories owned by the enterprise organization to which the installation has access.", "content": { "application/json": { "schema": { - "title": "Announcement Banner", - "description": "Announcement at either the repository, organization, or enterprise level", - "type": "object", - "properties": { - "announcement": { - "type": [ - "string", - "null" - ], - "description": "The announcement text in GitHub Flavored Markdown. For more information about GitHub Flavored Markdown, see \"[Basic writing and formatting syntax](https://docs.github.com/enterprise-cloud@latest//github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax).\"", - "examples": [ - "Very **important** announcement about _something_." - ] - }, - "expires_at": { - "type": [ - "string", - "null" - ], - "format": "date-time", - "description": "The time at which the announcement expires. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`. To set an announcement that never expires, omit this parameter, set it to `null`, or set it to an empty string.", - "examples": [ - "\"2021-01-01T00:00:00.000-07:00\"" - ] + "type": "array", + "items": { + "title": "Accessible Repository", + "description": "A repository that may be made accessible to a GitHub App.", + "type": "object", + "properties": { + "id": { + "description": "Unique identifier of the repository", + "type": "integer", + "format": "int64", + "examples": [ + 1 + ] + }, + "name": { + "description": "The name of the repository.", + "type": "string", + "examples": [ + "Team Environment" + ] + }, + "full_name": { + "type": "string", + "examples": [ + "octocat/Hello-World" + ] + } }, - "user_dismissible": { - "type": [ - "boolean", - "null" - ], - "description": "Whether an announcement can be dismissed by the user.", - "default": false, - "examples": [ - false - ] - } - }, - "required": [ - "announcement", - "expires_at", - "user_dismissible" - ] + "required": [ + "full_name", + "id", + "name" + ] + } }, "examples": { "default": { - "summary": "Announcement banner", - "value": { - "announcement": "Very **important** announcement about _something_.", - "expires_at": "2021-01-01T00:00:00.000+00:00", - "user_dismissible": false - } + "value": [ + { + "id": 1, + "name": "Hello World", + "full_name": "octocat/Hello-World" + }, + { + "id": 2, + "login": "Goodbye World", + "full_name": "octocat/Goodbye-World" + } + ] } } } @@ -27208,148 +30607,1136 @@ }, "x-github": { "githubCloudOnly": true, - "enabledForGitHubApps": false, - "category": "announcement-banners", - "subcategory": "enterprises" + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" } }, "patch": { - "summary": "Set announcement banner for enterprise", - "description": "Sets the announcement banner to display for the enterprise.", + "summary": "Toggle installation repository access between selected and all repositories", + "description": "Toggle repository access for a GitHub App installation between all repositories and selected repositories. You must provide at least one repository when changing the access to 'selected'. If you change the access to 'all', the repositories list must not be provided.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", "tags": [ - "enterprise-admin" + "apps" ], - "operationId": "announcement-banners/set-announcement-banner-for-enterprise", + "operationId": "enterprise-apps/change-installation-repository-access-selection", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/enterprise-cloud@latest//rest/announcement-banners/enterprises#set-announcement-banner-for-enterprise" + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#toggle-installation-repository-access-between-selected-and-all-repositories" }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "installation_id", + "description": "The unique identifier of the installation.", + "in": "path", + "required": true, + "schema": { + "type": "integer" + }, + "examples": { + "default": { + "value": 1 + } + } + } + ], "requestBody": { "required": true, "content": { "application/json": { "schema": { - "title": "Enterprise Announcement", - "description": "Enterprise global announcement", "type": "object", "properties": { - "announcement": { - "type": [ - "string", - "null" - ], - "description": "The announcement text in GitHub Flavored Markdown. For more information about GitHub Flavored Markdown, see \"[Basic writing and formatting syntax](https://docs.github.com/enterprise-cloud@latest//github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax).\"", - "examples": [ - "Very **important** announcement about _something_." - ] - }, - "expires_at": { - "type": [ - "string", - "null" - ], - "format": "date-time", - "description": "The time at which the announcement expires. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`. To set an announcement that never expires, omit this parameter, set it to `null`, or set it to an empty string.", - "examples": [ - "\"2021-01-01T00:00:00.000-07:00\"" + "repository_selection": { + "type": "string", + "description": "One of either 'all' or 'selected'", + "enum": [ + "all", + "selected" ] }, - "user_dismissible": { - "type": [ - "boolean", - "null" - ], - "description": "Whether an announcement can be dismissed by the user.", - "default": false, - "examples": [ - false - ] + "repositories": { + "type": "array", + "description": "The repository names to add to the installation. Only required when repository_selection is 'selected'", + "items": { + "type": "string" + }, + "maxItems": 50 } }, "required": [ - "announcement" + "repository_selection" ] }, "examples": { "default": { - "summary": "Announcement banner", + "summary": "Change the repositories accessible to a GitHub App from 'all repositories' to a specified subset.", "value": { - "announcement": "Very **important** announcement about _something_.", - "expires_at": "2021-01-01T00:00:00.000+00:00", - "user_dismissible": false + "repository_selection": "selected", + "repositories": [ + "hello-world", + "hello-world-2" + ] } } } } } }, - "parameters": [ - { - "name": "enterprise", - "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - } - ], "responses": { "200": { - "description": "Response", + "description": "The GitHub App installation that was updated.", "content": { "application/json": { "schema": { - "title": "Announcement Banner", - "description": "Announcement at either the repository, organization, or enterprise level", + "title": "Installation", + "description": "Installation", "type": "object", "properties": { - "announcement": { + "id": { + "description": "The ID of the installation.", + "type": "integer", + "examples": [ + 1 + ] + }, + "account": { + "anyOf": [ + { + "title": "Simple User", + "description": "A GitHub user.", + "type": "object", + "properties": { + "name": { + "type": [ + "string", + "null" + ] + }, + "email": { + "type": [ + "string", + "null" + ] + }, + "login": { + "type": "string", + "examples": [ + "octocat" + ] + }, + "id": { + "type": "integer", + "format": "int64", + "examples": [ + 1 + ] + }, + "node_id": { + "type": "string", + "examples": [ + "MDQ6VXNlcjE=" + ] + }, + "avatar_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/images/error/octocat_happy.gif" + ] + }, + "gravatar_id": { + "type": [ + "string", + "null" + ], + "examples": [ + "41d064eb2195891e12d0413f63227ea7" + ] + }, + "url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat" + ] + }, + "html_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/octocat" + ] + }, + "followers_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/followers" + ] + }, + "following_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/following{/other_user}" + ] + }, + "gists_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/gists{/gist_id}" + ] + }, + "starred_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/starred{/owner}{/repo}" + ] + }, + "subscriptions_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/subscriptions" + ] + }, + "organizations_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/orgs" + ] + }, + "repos_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/repos" + ] + }, + "events_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/events{/privacy}" + ] + }, + "received_events_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/received_events" + ] + }, + "type": { + "type": "string", + "examples": [ + "User" + ] + }, + "site_admin": { + "type": "boolean" + }, + "starred_at": { + "type": "string", + "examples": [ + "\"2020-07-09T00:17:55Z\"" + ] + }, + "user_view_type": { + "type": "string", + "examples": [ + "public" + ] + } + }, + "required": [ + "avatar_url", + "events_url", + "followers_url", + "following_url", + "gists_url", + "gravatar_id", + "html_url", + "id", + "node_id", + "login", + "organizations_url", + "received_events_url", + "repos_url", + "site_admin", + "starred_url", + "subscriptions_url", + "type", + "url" + ] + }, + { + "title": "Enterprise", + "description": "An enterprise on GitHub.", + "type": "object", + "properties": { + "description": { + "description": "A short description of the enterprise.", + "type": [ + "string", + "null" + ] + }, + "html_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/enterprises/octo-business" + ] + }, + "website_url": { + "description": "The enterprise's website URL.", + "type": [ + "string", + "null" + ], + "format": "uri" + }, + "id": { + "description": "Unique identifier of the enterprise", + "type": "integer", + "examples": [ + 42 + ] + }, + "node_id": { + "type": "string", + "examples": [ + "MDEwOlJlcG9zaXRvcnkxMjk2MjY5" + ] + }, + "name": { + "description": "The name of the enterprise.", + "type": "string", + "examples": [ + "Octo Business" + ] + }, + "slug": { + "description": "The slug url identifier for the enterprise.", + "type": "string", + "examples": [ + "octo-business" + ] + }, + "created_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "examples": [ + "2019-01-26T19:01:12Z" + ] + }, + "updated_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "examples": [ + "2019-01-26T19:14:43Z" + ] + }, + "avatar_url": { + "type": "string", + "format": "uri" + } + }, + "required": [ + "id", + "node_id", + "name", + "slug", + "html_url", + "created_at", + "updated_at", + "avatar_url" + ] + } + ], + "type": [ + "null", + "object" + ] + }, + "repository_selection": { + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", + "type": "string", + "enum": [ + "all", + "selected" + ] + }, + "access_tokens_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/app/installations/1/access_tokens" + ] + }, + "repositories_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/installation/repositories" + ] + }, + "html_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/organizations/github/settings/installations/1" + ] + }, + "app_id": { + "type": "integer", + "examples": [ + 1 + ] + }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, + "target_id": { + "description": "The ID of the user or organization this token is being scoped to.", + "type": "integer" + }, + "target_type": { + "type": "string", + "examples": [ + "Organization" + ] + }, + "permissions": { + "title": "App Permissions", + "type": "object", + "description": "The permissions granted to the user access token.", + "properties": { + "actions": { + "type": "string", + "description": "The level of permission to grant the access token for GitHub Actions workflows, workflow runs, and artifacts.", + "enum": [ + "read", + "write" + ] + }, + "administration": { + "type": "string", + "description": "The level of permission to grant the access token for repository creation, deletion, settings, teams, and collaborators creation.", + "enum": [ + "read", + "write" + ] + }, + "checks": { + "type": "string", + "description": "The level of permission to grant the access token for checks on code.", + "enum": [ + "read", + "write" + ] + }, + "codespaces": { + "type": "string", + "description": "The level of permission to grant the access token to create, edit, delete, and list Codespaces.", + "enum": [ + "read", + "write" + ] + }, + "contents": { + "type": "string", + "description": "The level of permission to grant the access token for repository contents, commits, branches, downloads, releases, and merges.", + "enum": [ + "read", + "write" + ] + }, + "dependabot_secrets": { + "type": "string", + "description": "The level of permission to grant the access token to manage Dependabot secrets.", + "enum": [ + "read", + "write" + ] + }, + "deployments": { + "type": "string", + "description": "The level of permission to grant the access token for deployments and deployment statuses.", + "enum": [ + "read", + "write" + ] + }, + "environments": { + "type": "string", + "description": "The level of permission to grant the access token for managing repository environments.", + "enum": [ + "read", + "write" + ] + }, + "issues": { + "type": "string", + "description": "The level of permission to grant the access token for issues and related comments, assignees, labels, and milestones.", + "enum": [ + "read", + "write" + ] + }, + "metadata": { + "type": "string", + "description": "The level of permission to grant the access token to search repositories, list collaborators, and access repository metadata.", + "enum": [ + "read", + "write" + ] + }, + "packages": { + "type": "string", + "description": "The level of permission to grant the access token for packages published to GitHub Packages.", + "enum": [ + "read", + "write" + ] + }, + "pages": { + "type": "string", + "description": "The level of permission to grant the access token to retrieve Pages statuses, configuration, and builds, as well as create new builds.", + "enum": [ + "read", + "write" + ] + }, + "pull_requests": { + "type": "string", + "description": "The level of permission to grant the access token for pull requests and related comments, assignees, labels, milestones, and merges.", + "enum": [ + "read", + "write" + ] + }, + "repository_custom_properties": { + "type": "string", + "description": "The level of permission to grant the access token to view and edit custom properties for a repository, when allowed by the property.", + "enum": [ + "read", + "write" + ] + }, + "repository_hooks": { + "type": "string", + "description": "The level of permission to grant the access token to manage the post-receive hooks for a repository.", + "enum": [ + "read", + "write" + ] + }, + "repository_projects": { + "type": "string", + "description": "The level of permission to grant the access token to manage repository projects, columns, and cards.", + "enum": [ + "read", + "write", + "admin" + ] + }, + "secret_scanning_alerts": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage secret scanning alerts.", + "enum": [ + "read", + "write" + ] + }, + "secrets": { + "type": "string", + "description": "The level of permission to grant the access token to manage repository secrets.", + "enum": [ + "read", + "write" + ] + }, + "security_events": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage security events like code scanning alerts.", + "enum": [ + "read", + "write" + ] + }, + "single_file": { + "type": "string", + "description": "The level of permission to grant the access token to manage just a single file.", + "enum": [ + "read", + "write" + ] + }, + "statuses": { + "type": "string", + "description": "The level of permission to grant the access token for commit statuses.", + "enum": [ + "read", + "write" + ] + }, + "vulnerability_alerts": { + "type": "string", + "description": "The level of permission to grant the access token to manage Dependabot alerts.", + "enum": [ + "read", + "write" + ] + }, + "workflows": { + "type": "string", + "description": "The level of permission to grant the access token to update GitHub Actions workflow files.", + "enum": [ + "write" + ] + }, + "members": { + "type": "string", + "description": "The level of permission to grant the access token for organization teams and members.", + "enum": [ + "read", + "write" + ] + }, + "organization_administration": { + "type": "string", + "description": "The level of permission to grant the access token to manage access to an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_custom_roles": { + "type": "string", + "description": "The level of permission to grant the access token for custom repository roles management.", + "enum": [ + "read", + "write" + ] + }, + "organization_custom_org_roles": { + "type": "string", + "description": "The level of permission to grant the access token for custom organization roles management.", + "enum": [ + "read", + "write" + ] + }, + "organization_custom_properties": { + "type": "string", + "description": "The level of permission to grant the access token for custom property management.", + "enum": [ + "read", + "write", + "admin" + ] + }, + "organization_copilot_seat_management": { + "type": "string", + "description": "The level of permission to grant the access token for managing access to GitHub Copilot for members of an organization with a Copilot Business subscription. This property is in public preview and is subject to change.", + "enum": [ + "write" + ] + }, + "organization_announcement_banners": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage announcement banners for an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_events": { + "type": "string", + "description": "The level of permission to grant the access token to view events triggered by an activity in an organization.", + "enum": [ + "read" + ] + }, + "organization_hooks": { + "type": "string", + "description": "The level of permission to grant the access token to manage the post-receive hooks for an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_personal_access_tokens": { + "type": "string", + "description": "The level of permission to grant the access token for viewing and managing fine-grained personal access token requests to an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_personal_access_token_requests": { + "type": "string", + "description": "The level of permission to grant the access token for viewing and managing fine-grained personal access tokens that have been approved by an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_plan": { + "type": "string", + "description": "The level of permission to grant the access token for viewing an organization's plan.", + "enum": [ + "read" + ] + }, + "organization_projects": { + "type": "string", + "description": "The level of permission to grant the access token to manage organization projects and projects public preview (where available).", + "enum": [ + "read", + "write", + "admin" + ] + }, + "organization_packages": { + "type": "string", + "description": "The level of permission to grant the access token for organization packages published to GitHub Packages.", + "enum": [ + "read", + "write" + ] + }, + "organization_secrets": { + "type": "string", + "description": "The level of permission to grant the access token to manage organization secrets.", + "enum": [ + "read", + "write" + ] + }, + "organization_self_hosted_runners": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage GitHub Actions self-hosted runners available to an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_user_blocking": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage users blocked by the organization.", + "enum": [ + "read", + "write" + ] + }, + "team_discussions": { + "type": "string", + "description": "The level of permission to grant the access token to manage team discussions and related comments.", + "enum": [ + "read", + "write" + ] + }, + "email_addresses": { + "type": "string", + "description": "The level of permission to grant the access token to manage the email addresses belonging to a user.", + "enum": [ + "read", + "write" + ] + }, + "followers": { + "type": "string", + "description": "The level of permission to grant the access token to manage the followers belonging to a user.", + "enum": [ + "read", + "write" + ] + }, + "git_ssh_keys": { + "type": "string", + "description": "The level of permission to grant the access token to manage git SSH keys.", + "enum": [ + "read", + "write" + ] + }, + "gpg_keys": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage GPG keys belonging to a user.", + "enum": [ + "read", + "write" + ] + }, + "interaction_limits": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage interaction limits on a repository.", + "enum": [ + "read", + "write" + ] + }, + "profile": { + "type": "string", + "description": "The level of permission to grant the access token to manage the profile settings belonging to a user.", + "enum": [ + "write" + ] + }, + "starring": { + "type": "string", + "description": "The level of permission to grant the access token to list and manage repositories a user is starring.", + "enum": [ + "read", + "write" + ] + } + }, + "example": { + "contents": "read", + "issues": "read", + "deployments": "write", + "single_file": "read" + } + }, + "events": { + "type": "array", + "items": { + "type": "string" + } + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" + }, + "single_file_name": { "type": [ "string", "null" ], - "description": "The announcement text in GitHub Flavored Markdown. For more information about GitHub Flavored Markdown, see \"[Basic writing and formatting syntax](https://docs.github.com/enterprise-cloud@latest//github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax).\"", "examples": [ - "Very **important** announcement about _something_." + "config.yaml" ] }, - "expires_at": { + "has_multiple_single_files": { + "type": "boolean", + "examples": [ + true + ] + }, + "single_file_paths": { + "type": "array", + "items": { + "type": "string" + }, + "examples": [ + "config.yml", + ".github/issue_TEMPLATE.md" + ] + }, + "app_slug": { + "type": "string", + "examples": [ + "github-actions" + ] + }, + "suspended_by": { + "anyOf": [ + { + "type": "null" + }, + { + "title": "Simple User", + "description": "A GitHub user.", + "type": "object", + "properties": { + "name": { + "type": [ + "string", + "null" + ] + }, + "email": { + "type": [ + "string", + "null" + ] + }, + "login": { + "type": "string", + "examples": [ + "octocat" + ] + }, + "id": { + "type": "integer", + "format": "int64", + "examples": [ + 1 + ] + }, + "node_id": { + "type": "string", + "examples": [ + "MDQ6VXNlcjE=" + ] + }, + "avatar_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/images/error/octocat_happy.gif" + ] + }, + "gravatar_id": { + "type": [ + "string", + "null" + ], + "examples": [ + "41d064eb2195891e12d0413f63227ea7" + ] + }, + "url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat" + ] + }, + "html_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/octocat" + ] + }, + "followers_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/followers" + ] + }, + "following_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/following{/other_user}" + ] + }, + "gists_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/gists{/gist_id}" + ] + }, + "starred_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/starred{/owner}{/repo}" + ] + }, + "subscriptions_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/subscriptions" + ] + }, + "organizations_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/orgs" + ] + }, + "repos_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/repos" + ] + }, + "events_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/events{/privacy}" + ] + }, + "received_events_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/received_events" + ] + }, + "type": { + "type": "string", + "examples": [ + "User" + ] + }, + "site_admin": { + "type": "boolean" + }, + "starred_at": { + "type": "string", + "examples": [ + "\"2020-07-09T00:17:55Z\"" + ] + }, + "user_view_type": { + "type": "string", + "examples": [ + "public" + ] + } + }, + "required": [ + "avatar_url", + "events_url", + "followers_url", + "following_url", + "gists_url", + "gravatar_id", + "html_url", + "id", + "node_id", + "login", + "organizations_url", + "received_events_url", + "repos_url", + "site_admin", + "starred_url", + "subscriptions_url", + "type", + "url" + ] + } + ] + }, + "suspended_at": { "type": [ "string", "null" ], - "format": "date-time", - "description": "The time at which the announcement expires. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`. To set an announcement that never expires, omit this parameter, set it to `null`, or set it to an empty string.", - "examples": [ - "\"2021-01-01T00:00:00.000-07:00\"" - ] + "format": "date-time" }, - "user_dismissible": { + "contact_email": { "type": [ - "boolean", + "string", "null" ], - "description": "Whether an announcement can be dismissed by the user.", - "default": false, "examples": [ - false + "\"test_13f1e99741e3e004@d7e1eb0bc0a1ba12.com\"" ] } }, "required": [ - "announcement", - "expires_at", - "user_dismissible" + "id", + "app_id", + "app_slug", + "target_id", + "target_type", + "single_file_name", + "repository_selection", + "access_tokens_url", + "html_url", + "repositories_url", + "events", + "account", + "permissions", + "created_at", + "updated_at", + "suspended_by", + "suspended_at" ] }, "examples": { "default": { - "summary": "Announcement banner", "value": { - "announcement": "Very **important** announcement about _something_.", - "expires_at": "2021-01-01T00:00:00.000+00:00", - "user_dismissible": false + "id": 1, + "account": { + "login": "octocat", + "id": 1, + "node_id": "MDQ6VXNlcjE=", + "avatar_url": "https://github.com/images/error/octocat_happy.gif", + "gravatar_id": "", + "url": "https://api.github.com/users/octocat", + "html_url": "https://github.com/octocat", + "followers_url": "https://api.github.com/users/octocat/followers", + "following_url": "https://api.github.com/users/octocat/following{/other_user}", + "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", + "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", + "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", + "organizations_url": "https://api.github.com/users/octocat/orgs", + "repos_url": "https://api.github.com/users/octocat/repos", + "events_url": "https://api.github.com/users/octocat/events{/privacy}", + "received_events_url": "https://api.github.com/users/octocat/received_events", + "type": "User", + "site_admin": false + }, + "access_tokens_url": "https://api.github.com/app/installations/1/access_tokens", + "repositories_url": "https://api.github.com/installation/repositories", + "html_url": "https://github.com/organizations/github/settings/installations/1", + "app_id": 1, + "target_id": 1, + "target_type": "Organization", + "permissions": { + "checks": "write", + "metadata": "read", + "contents": "read" + }, + "events": [ + "push", + "pull_request" + ], + "single_file_name": "config.yaml", + "has_multiple_single_files": true, + "single_file_paths": [ + "config.yml", + ".github/issue_TEMPLATE.md" + ], + "repository_selection": "selected", + "created_at": "2017-07-08T16:18:44-04:00", + "updated_at": "2017-07-08T16:18:44-04:00", + "app_slug": "github-actions", + "suspended_at": null, + "suspended_by": null } } } @@ -27359,21 +31746,23 @@ }, "x-github": { "githubCloudOnly": true, - "enabledForGitHubApps": false, - "category": "announcement-banners", - "subcategory": "enterprises" + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" } - }, - "delete": { - "summary": "Remove announcement banner from enterprise", - "description": "Removes the announcement banner currently set for the enterprise.", + } + }, + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}/repositories/add": { + "patch": { + "summary": "Grant repository access to an organization installation", + "description": "Grant repository access to an organization installation. You can add up to 50 repositories at a time. If the installation already has access to the repository, it will not be added again.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", "tags": [ - "enterprise-admin" + "apps" ], - "operationId": "announcement-banners/remove-announcement-banner-for-enterprise", + "operationId": "enterprise-apps/grant-repository-access-to-installation", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/enterprise-cloud@latest//rest/announcement-banners/enterprises#remove-announcement-banner-from-enterprise" + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#grant-repository-access-to-an-organization-installation" }, "parameters": [ { @@ -27384,18 +31773,319 @@ "schema": { "type": "string" } + }, + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "installation_id", + "description": "The unique identifier of the installation.", + "in": "path", + "required": true, + "schema": { + "type": "integer" + }, + "examples": { + "default": { + "value": 1 + } + } } ], "responses": { - "204": { - "description": "Response" + "200": { + "description": "A list of repositories which the authenticated GitHub App should be granted access to.", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "title": "Accessible Repository", + "description": "A repository that may be made accessible to a GitHub App.", + "type": "object", + "properties": { + "id": { + "description": "Unique identifier of the repository", + "type": "integer", + "format": "int64", + "examples": [ + 1 + ] + }, + "name": { + "description": "The name of the repository.", + "type": "string", + "examples": [ + "Team Environment" + ] + }, + "full_name": { + "type": "string", + "examples": [ + "octocat/Hello-World" + ] + } + }, + "required": [ + "full_name", + "id", + "name" + ] + } + }, + "examples": { + "default": { + "value": [ + { + "id": 1, + "name": "Hello World", + "full_name": "octocat/Hello-World" + }, + { + "id": 2, + "login": "Goodbye World", + "full_name": "octocat/Goodbye-World" + } + ] + } + } + } + } + } + }, + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "repositories": { + "type": "array", + "description": "The repository names to add to the installation.", + "items": { + "type": "string" + }, + "maxItems": 50 + } + }, + "required": [ + "repositories" + ] + }, + "examples": { + "repositories": { + "value": { + "repositories": [ + "hello-world", + "hello-world-2" + ] + } + } + } + } } }, "x-github": { "githubCloudOnly": true, - "enabledForGitHubApps": false, - "category": "announcement-banners", - "subcategory": "enterprises" + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + } + }, + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}/repositories/remove": { + "patch": { + "summary": "Remove repository access from an organization installation", + "description": "Remove repository access from a GitHub App installed on an organization. You can remove up to 50 repositories at a time. You cannot remove repositories from an app installed on `all` repositories, nor can you remove the last repository for an app. If you attempt to do so, the API will return a 422 Unprocessable Entity error.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/remove-repository-access-to-installation", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#remove-repository-access-from-an-organization-installation" + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "installation_id", + "description": "The unique identifier of the installation.", + "in": "path", + "required": true, + "schema": { + "type": "integer" + }, + "examples": { + "default": { + "value": 1 + } + } + } + ], + "responses": { + "200": { + "description": "A list of repositories which the authenticated GitHub App has lost access to.", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "title": "Accessible Repository", + "description": "A repository that may be made accessible to a GitHub App.", + "type": "object", + "properties": { + "id": { + "description": "Unique identifier of the repository", + "type": "integer", + "format": "int64", + "examples": [ + 1 + ] + }, + "name": { + "description": "The name of the repository.", + "type": "string", + "examples": [ + "Team Environment" + ] + }, + "full_name": { + "type": "string", + "examples": [ + "octocat/Hello-World" + ] + } + }, + "required": [ + "full_name", + "id", + "name" + ] + } + }, + "examples": { + "default": { + "value": [ + { + "id": 1, + "name": "Hello World", + "full_name": "octocat/Hello-World" + }, + { + "id": 2, + "login": "Goodbye World", + "full_name": "octocat/Goodbye-World" + } + ] + } + } + } + } + }, + "422": { + "description": "The request was well-formed but was unable to be followed due to semantic errors. This can happen if you attempt to remove a repository from an installation that has access to `all` repositories, or if you attempt to remove the last repository from an installation.", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + }, + "examples": { + "default": { + "value": [ + { + "message": "Cannot remove the last repository from this installation. Uninstall this application instead." + }, + { + "documentation_url": "https://docs.github.com/rest/enterprise-admin/organization-installations#remove-repository-access-to-an-organization-installation" + }, + { + "status": 422 + } + ] + } + } + } + } + } + }, + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "repositories": { + "type": "array", + "description": "The repository names to remove from the installation.", + "items": { + "type": "string" + }, + "maxItems": 50 + } + }, + "required": [ + "repositories" + ] + }, + "examples": { + "repositories": { + "value": { + "repositories": [ + "hello-world", + "hello-world-2" + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" } } }, @@ -142524,7 +147214,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -142558,6 +147248,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -143624,7 +148320,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -143658,6 +148354,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -150485,7 +155187,7 @@ }, "delete": { "summary": "Remove an organization member", - "description": "Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories.", + "description": "Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories.\n\n> [!NOTE]\n> If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team.", "tags": [ "orgs" ], @@ -156725,7 +161427,7 @@ }, "delete": { "summary": "Remove organization membership for a user", - "description": "In order to remove a user's membership with an organization, the authenticated user must be an organization owner.\n\nIf the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases.", + "description": "In order to remove a user's membership with an organization, the authenticated user must be an organization owner.\n\nIf the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases.\n\n> [!NOTE]\n> If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team.", "tags": [ "orgs" ], @@ -380546,7 +385248,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -380580,6 +385282,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -635111,7 +639819,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -635145,6 +639853,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -686454,7 +691168,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -686488,6 +691202,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -908100,7 +912820,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -908134,6 +912854,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -911160,7 +915886,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -911194,6 +915920,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -914125,7 +918857,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -914159,6 +918891,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -917090,7 +921828,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -917124,6 +921862,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -920189,7 +924933,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -920223,6 +924967,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -923295,7 +928045,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -923329,6 +928079,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -928396,7 +933152,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -928430,6 +933186,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" diff --git a/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.yaml b/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.yaml index d0ef9b9ec2..b4cce4f297 100644 --- a/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.yaml +++ b/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.yaml @@ -442,7 +442,7 @@ paths: The EPSS percentile represents the relative rank of the CVE's likelihood of being exploited compared to other CVEs. schema: type: string - - &84 + - &87 name: before description: A cursor, as given in the [Link header](https://docs.github.com/enterprise-cloud@latest//rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for results before this cursor. For @@ -451,7 +451,7 @@ paths: required: false schema: type: string - - &85 + - &88 name: after description: A cursor, as given in the [Link header](https://docs.github.com/enterprise-cloud@latest//rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for results after this cursor. For @@ -460,7 +460,7 @@ paths: required: false schema: type: string - - &86 + - &89 name: direction description: The direction to sort the results by. in: query @@ -699,7 +699,7 @@ paths: required: - vector_string - score - cvss_severities: &98 + cvss_severities: &101 type: - object - 'null' @@ -746,7 +746,7 @@ paths: required: - vector_string - score - epss: &99 + epss: &102 type: - object - 'null' @@ -909,7 +909,7 @@ paths: - subscriptions_url - type - url - type: &335 + type: &337 type: string description: The type of credit the user is receiving. enum: @@ -1042,7 +1042,7 @@ paths: description: Validation failed, or the endpoint has been spammed. content: application/json: - schema: &177 + schema: &179 title: Validation Error Simple description: Validation Error Simple type: object @@ -1075,7 +1075,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/global-advisories#get-a-global-security-advisory parameters: - - &674 + - &676 name: ghsa_id description: The GHSA (GitHub Security Advisory) identifier of the advisory. in: path @@ -1660,7 +1660,7 @@ paths: schema: type: integer default: 30 - - &260 + - &262 name: cursor description: 'Used for pagination: the starting delivery from which the page of deliveries is fetched. Refer to the `link` header for the next and previous @@ -1676,7 +1676,7 @@ paths: application/json: schema: type: array - items: &261 + items: &263 title: Simple webhook delivery description: Delivery made by a webhook, without request and response information. @@ -1772,7 +1772,7 @@ paths: - installation_id - repository_id examples: - default: &262 + default: &264 value: - id: 12345678 guid: 0b989ba4-242f-11e5-81e1-c7b6966d2516 @@ -1804,7 +1804,7 @@ paths: application/json: schema: *3 application/scim+json: - schema: &684 + schema: &686 title: Scim Error description: Scim Error type: object @@ -1835,7 +1835,7 @@ paths: description: Validation failed, or the endpoint has been spammed. content: application/json: - schema: &176 + schema: &178 title: Validation Error description: Validation Error type: object @@ -1907,7 +1907,7 @@ paths: description: Response content: application/json: - schema: &263 + schema: &265 title: Webhook delivery description: Delivery made by a webhook. type: object @@ -2042,7 +2042,7 @@ paths: - request - response examples: - default: &264 + default: &266 value: id: 12345678 guid: 0b989ba4-242f-11e5-81e1-c7b6966d2516 @@ -2246,7 +2246,7 @@ paths: parameters: - *17 - *19 - - &141 + - &144 name: since description: 'Only show results that were last updated after the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) @@ -2288,7 +2288,8 @@ paths: - object repository_selection: description: Describe whether all repositories have been selected - or there's a selection involved + or there's a selection involved. For enterprise installations + this is `selected`. type: string enum: - all @@ -2312,6 +2313,10 @@ paths: type: integer examples: - 1 + client_id: + type: string + examples: + - Iv1.ab1112223334445c target_id: description: The ID of the user or organization this token is being scoped to. @@ -2832,7 +2837,7 @@ paths: application/json: schema: *20 examples: - default: + default: &72 value: id: 1 account: @@ -2887,7 +2892,7 @@ paths: delete: summary: Delete an installation for the authenticated app description: |- - Uninstalls a GitHub App on a user, organization, or business account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the "[Suspend an app installation](https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#suspend-an-app-installation)" endpoint. + Uninstalls a GitHub App on a user, organization, or enterprise account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the "[Suspend an app installation](https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#suspend-an-app-installation)" endpoint. You must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. tags: @@ -2911,12 +2916,14 @@ paths: post: summary: Create an installation access token for an app description: |- - Creates an installation access token that enables a GitHub App to make authenticated API requests for the app's installation on an organization or individual account. Installation tokens expire one hour from the time you create them. Using an expired token produces a status code of `401 - Unauthorized`, and requires creating a new installation token. By default the installation token has access to all repositories that the installation can access. + Creates an installation access token that enables a GitHub App to make authenticated API requests for the app's installation on an enterprise, organization, or individual account. Installation tokens expire one hour from the time you create them. Using an expired token produces a status code of `401 - Unauthorized`, and requires creating a new installation token. By default the installation token has access to all repositories that the installation can access. Optionally, you can use the `repositories` or `repository_ids` body parameters to specify individual repositories that the installation access token can access. If you don't use `repositories` or `repository_ids` to grant access to specific repositories, the installation access token will have access to all repositories that the installation was granted access to. The installation access token cannot be granted access to repositories that the installation was not granted access to. Up to 500 repositories can be listed in this manner. Optionally, use the `permissions` body parameter to specify the permissions that the installation access token should have. If `permissions` is not specified, the installation access token will have all of the permissions that were granted to the app. The installation access token cannot be granted permissions that the app was not granted. + Enterprise account installations do not have access to repositories and cannot be scoped down using the `permissions` parameter. + You must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. tags: - apps @@ -2966,7 +2973,7 @@ paths: schema: title: Installation Token description: Authentication token for a GitHub App installed on a - user or org. + user, org, or enterprise. type: object properties: token: @@ -3008,7 +3015,7 @@ paths: license: anyOf: - type: 'null' - - &152 + - &155 title: License Simple description: License Simple type: object @@ -3746,7 +3753,7 @@ paths: put: summary: Suspend an app installation description: |- - Suspends a GitHub App on a user, organization, or business account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub Enterprise Cloud API or webhook events is blocked for that account. + Suspends a GitHub App on a user, organization, or enterprise account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub Enterprise Cloud API or webhook events is blocked for that account. You must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. tags: @@ -5386,7 +5393,7 @@ paths: responses: '202': *37 '422': *7 - '500': &83 + '500': &86 description: Internal Error content: application/json: @@ -7672,7 +7679,7 @@ paths: description: Response content: application/json: - schema: &178 + schema: &180 type: object properties: total_active_caches_count: @@ -7687,7 +7694,7 @@ paths: - total_active_caches_count - total_active_caches_size_in_bytes examples: - default: &179 + default: &181 value: total_active_caches_size_in_bytes: 3344284 total_active_caches_count: 5 @@ -7892,7 +7899,7 @@ paths: - public_ip_enabled - platform examples: - default: &180 + default: &182 value: total_count: 2 runners: @@ -8182,7 +8189,7 @@ paths: description: Response content: application/json: - schema: &181 + schema: &183 type: object properties: public_ips: @@ -8209,7 +8216,7 @@ paths: required: - public_ips examples: - default: &182 + default: &184 value: public_ips: current_usage: 17 @@ -8249,7 +8256,7 @@ paths: type: array items: *43 examples: - default: &183 + default: &185 value: id: 4-core cpu_cores: 4 @@ -8507,7 +8514,7 @@ paths: - all - local_only - selected - selected_actions_url: &186 + selected_actions_url: &188 type: string description: The API URL to use to get or set the actions and reusable workflows that are allowed to run, when `allowed_actions` @@ -8888,7 +8895,7 @@ paths: description: Success response content: application/json: - schema: &189 + schema: &191 type: object properties: default_workflow_permissions: &51 @@ -8936,7 +8943,7 @@ paths: required: true content: application/json: - schema: &190 + schema: &192 type: object properties: default_workflow_permissions: *51 @@ -9781,7 +9788,7 @@ paths: application/json: schema: type: array - items: &194 + items: &196 title: Runner Application description: Runner Application type: object @@ -9806,7 +9813,7 @@ paths: - download_url - filename examples: - default: &195 + default: &197 value: - os: osx architecture: x64 @@ -9890,7 +9897,7 @@ paths: - no-gpu work_folder: _work responses: - '201': &196 + '201': &198 description: Response content: application/json: @@ -9929,7 +9936,7 @@ paths: encoded_jit_config: abc123 '404': *6 '422': *7 - '409': &94 + '409': &97 description: Conflict content: application/json: @@ -10009,7 +10016,7 @@ paths: - token - expires_at examples: - default: &197 + default: &199 value: token: LLBF3JGZDX3P5PMEXLND6TS6FCWO6 expires_at: '2020-01-22T12:13:35.123-08:00' @@ -10049,7 +10056,7 @@ paths: application/json: schema: *63 examples: - default: &198 + default: &200 value: token: AABF3JGZDX3P5PMEXLND6TS6FCWO6 expires_at: '2020-01-29T12:13:35.123-08:00' @@ -10081,7 +10088,7 @@ paths: application/json: schema: *60 examples: - default: &199 + default: &201 value: id: 23 name: MBP @@ -10297,7 +10304,7 @@ paths: - *39 - *59 responses: - '200': &200 + '200': &202 description: Response content: application/json: @@ -10353,7 +10360,7 @@ paths: parameters: - *39 - *59 - - &201 + - &203 name: name description: The name of a self-hosted runner's custom label. in: path @@ -10450,7 +10457,7 @@ paths: required: true content: application/json: - schema: &208 + schema: &210 title: Enterprise Announcement description: Enterprise global announcement type: object @@ -10496,6 +10503,585 @@ paths: enabledForGitHubApps: false category: announcement-banners subcategory: enterprises + "/enterprises/{enterprise}/apps/installable_organizations": + get: + summary: Get enterprise-owned organizations that can have GitHub Apps installed + description: |- + List the organizations owned by the enterprise, intended for use by GitHub Apps that are managing applications across the enterprise. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/installable-organizations + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#get-enterprise-owned-organizations-that-can-have-github-apps-installed + parameters: + - *39 + - *17 + - *19 + responses: + '200': + description: A list of organizations owned by the enterprise on which the + authenticated GitHub App is installed. + content: + application/json: + schema: + type: array + items: + title: Installable Organization + description: A GitHub organization on which a GitHub App can be + installed. + type: object + properties: + id: + type: integer + examples: + - 1 + login: + type: string + examples: + - github + accessible_repositories_url: + type: string + format: uri + examples: + - https://api.github.com/enterprises/biz-name/apps/organizations/org-login/accessible_repositories + required: + - id + - login + examples: + default: + value: + - id: 1 + login: github + - id: 2 + login: microsoft + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + "/enterprises/{enterprise}/apps/installable_organizations/{org}/accessible_repositories": + get: + summary: Get repositories belonging to an enterprise-owned organization + description: |- + List the repositories belonging to an enterprise-owned organization that can be made accessible to a GitHub App installed on that organization. This API provides a shallow list of repositories in the organization, allowing the caller to then add or remove those repositories to an installation in that organization. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/installable-organization-accessible-repositories + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#get-repositories-belonging-to-an-enterprise-owned-organization + parameters: + - *39 + - &71 + name: org + description: The organization name. The name is not case sensitive. + in: path + required: true + schema: + type: string + - *17 + - *19 + responses: + '200': + description: A list of repositories owned by the enterprise organization + on which the authenticated GitHub App is installed. + content: + application/json: + schema: + type: array + items: &73 + title: Accessible Repository + description: A repository that may be made accessible to a GitHub + App. + type: object + properties: + id: + description: Unique identifier of the repository + type: integer + format: int64 + examples: + - 1 + name: + description: The name of the repository. + type: string + examples: + - Team Environment + full_name: + type: string + examples: + - octocat/Hello-World + required: + - full_name + - id + - name + examples: + default: + value: + - id: 1 + name: Hello World + full_name: octocat/Hello-World + - id: 2 + login: Goodbye World + full_name: octocat/Goodbye-World + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + "/enterprises/{enterprise}/apps/organizations/{org}/installations": + get: + summary: List GitHub Apps installed on an enterprise-owned organization + description: |- + Lists the GitHub App installations associated with the given enterprise-owned organization. This lists all GitHub Apps that have been installed on the organization, regardless of who owns the application. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/organization-installations + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#list-github-apps-installed-on-an-enterprise-owned-organization + parameters: + - *39 + - *71 + - *17 + - *19 + responses: + '200': + description: A list of GitHub App installations that have been granted access + to the organization + content: + application/json: + schema: + type: array + items: + title: Enterprise Organization Installation + description: A GitHub App Installation on an enterprise-owned organization + type: object + properties: + id: + description: The ID of the installation. + type: integer + examples: + - 1 + app_slug: + type: string + examples: + - github/github-actions + client_id: + type: string + examples: + - Iv1.ab1112223334445c + repository_selection: + description: Describe whether all repositories have been selected + or there's a selection involved + type: string + enum: + - all + - selected + repositories_url: + type: string + format: uri + examples: + - https://api.github.com/enterprises/acme-corp/apps/organizations/some-org/installations/1/repositories + permissions: *22 + events: + type: array + items: + type: string + created_at: + type: string + format: date-time + updated_at: + type: string + format: date-time + required: + - id + - client_id + - repository_selection + - repositories_url + - permissions + - created_at + - updated_at + examples: + default: + value: + - value: + id: 1 + app_slug: monalisa/orbit + repository_selection: selected + repositories_url: https://api.github.com/enterprises/acme-corp/apps/organizations/some-org/installations/1/repositories + permissions: + checks: write + metadata: read + contents: read + events: + - push + - pull_request + created_at: '2017-07-08T16:18:44-04:00' + updated_at: '2017-07-08T16:18:44-04:00' + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + post: + summary: Install a GitHub App on an enterprise-owned organization + description: |- + Installs any valid GitHub App on the specified organization owned by the enterprise. If the app is already installed on the organization, and is suspended, it will be unsuspended. + If the app has a pending installation request, they will all be approved. + + If the app is already installed and has a pending update request, it will be updated to the latest version. If the app is now requesting repository permissions, it will be given access to the repositories listed in the request or fail if no `repository_selection` is provided. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/create-installation + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#install-a-github-app-on-an-enterprise-owned-organization + parameters: + - *39 + - *71 + responses: + '200': + description: A GitHub App installation that was installed previously. + content: + application/json: + schema: *20 + examples: + default: *72 + '201': + description: A GitHub App installation. + content: + application/json: + schema: *20 + examples: + default: *72 + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + client_id: + type: string + description: The Client ID of the GitHub App to install. + repository_selection: + type: string + description: |- + The repository selection for the GitHub App. Must be one of: + * `all` - the installation can access all repositories in the organization. + * `selected` - the installation can access only the listed repositories. + * `none` - no repository permissions are requested. Only use when the app does not request repository permissions. + enum: + - all + - selected + - none + repositories: + type: array + description: The names of the repositories to which the installation + will be granted access. This is the simple name of the repository, + not the full name (e.g., `hello-world` not `octocat/hello-world`). + This is only required when `repository_selection` is `selected`. + items: + type: string + maxItems: 50 + required: + - client_id + - repository_selection + examples: + default: + summary: Example of installing a GitHub App on an organization and + granting access to all of its repositories. + value: + client_id: Iv2abc123aabbcc + repository_selection: all + repository_selection_selected: + value: + client_id: Iv2abc123aabbcc + repository_selection: selected + repositories: + - hello-world + - hello-world-2 + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}": + delete: + summary: Uninstall a GitHub App from an enterprise-owned organization + description: |- + Uninstall a GitHub App from an organization. Any app installed on the organization can be removed. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/delete-installation + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#uninstall-a-github-app-from-an-enterprise-owned-organization + parameters: + - *39 + - *71 + - *21 + responses: + '204': + description: An empty response indicates that the installation was successfully + removed. + '404': *6 + '403': *27 + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}/repositories": + get: + summary: Get the repositories accessible to a given GitHub App installation + description: |- + Lists the repositories accessible to a given GitHub App installation on an enterprise-owned organization. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/organization-installation-repositories + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#get-the-repositories-accessible-to-a-given-github-app-installation + parameters: + - *39 + - *71 + - *21 + - *17 + - *19 + responses: + '200': + description: A list of repositories owned by the enterprise organization + to which the installation has access. + content: + application/json: + schema: + type: array + items: *73 + examples: + default: + value: + - id: 1 + name: Hello World + full_name: octocat/Hello-World + - id: 2 + login: Goodbye World + full_name: octocat/Goodbye-World + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + patch: + summary: Toggle installation repository access between selected and all repositories + description: |- + Toggle repository access for a GitHub App installation between all repositories and selected repositories. You must provide at least one repository when changing the access to 'selected'. If you change the access to 'all', the repositories list must not be provided. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/change-installation-repository-access-selection + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#toggle-installation-repository-access-between-selected-and-all-repositories + parameters: + - *39 + - *71 + - *21 + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + repository_selection: + type: string + description: One of either 'all' or 'selected' + enum: + - all + - selected + repositories: + type: array + description: The repository names to add to the installation. Only + required when repository_selection is 'selected' + items: + type: string + maxItems: 50 + required: + - repository_selection + examples: + default: + summary: Change the repositories accessible to a GitHub App from 'all + repositories' to a specified subset. + value: + repository_selection: selected + repositories: + - hello-world + - hello-world-2 + responses: + '200': + description: The GitHub App installation that was updated. + content: + application/json: + schema: *20 + examples: + default: *72 + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}/repositories/add": + patch: + summary: Grant repository access to an organization installation + description: |- + Grant repository access to an organization installation. You can add up to 50 repositories at a time. If the installation already has access to the repository, it will not be added again. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/grant-repository-access-to-installation + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#grant-repository-access-to-an-organization-installation + parameters: + - *39 + - *71 + - *21 + responses: + '200': + description: A list of repositories which the authenticated GitHub App should + be granted access to. + content: + application/json: + schema: + type: array + items: *73 + examples: + default: + value: + - id: 1 + name: Hello World + full_name: octocat/Hello-World + - id: 2 + login: Goodbye World + full_name: octocat/Goodbye-World + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + repositories: + type: array + description: The repository names to add to the installation. + items: + type: string + maxItems: 50 + required: + - repositories + examples: + repositories: + value: + repositories: + - hello-world + - hello-world-2 + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}/repositories/remove": + patch: + summary: Remove repository access from an organization installation + description: |- + Remove repository access from a GitHub App installed on an organization. You can remove up to 50 repositories at a time. You cannot remove repositories from an app installed on `all` repositories, nor can you remove the last repository for an app. If you attempt to do so, the API will return a 422 Unprocessable Entity error. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/remove-repository-access-to-installation + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#remove-repository-access-from-an-organization-installation + parameters: + - *39 + - *71 + - *21 + responses: + '200': + description: A list of repositories which the authenticated GitHub App has + lost access to. + content: + application/json: + schema: + type: array + items: *73 + examples: + default: + value: + - id: 1 + name: Hello World + full_name: octocat/Hello-World + - id: 2 + login: Goodbye World + full_name: octocat/Goodbye-World + '422': + description: The request was well-formed but was unable to be followed due + to semantic errors. This can happen if you attempt to remove a repository + from an installation that has access to `all` repositories, or if you + attempt to remove the last repository from an installation. + content: + application/json: + schema: *3 + examples: + default: + value: + - message: Cannot remove the last repository from this installation. + Uninstall this application instead. + - documentation_url: https://docs.github.com/rest/enterprise-admin/organization-installations#remove-repository-access-to-an-organization-installation + - status: 422 + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + repositories: + type: array + description: The repository names to remove from the installation. + items: + type: string + maxItems: 50 + required: + - repositories + examples: + repositories: + value: + repositories: + - hello-world + - hello-world-2 + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations "/enterprises/{enterprise}/audit-log": get: summary: Get the audit log for an enterprise @@ -10522,7 +11108,7 @@ paths: required: false schema: type: string - - &209 + - &211 name: include description: |- The event types to include: @@ -10540,7 +11126,7 @@ paths: - web - git - all - - &210 + - &212 name: after description: A cursor, as given in the [Link header](https://docs.github.com/enterprise-cloud@latest//rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for events after this cursor. @@ -10548,7 +11134,7 @@ paths: required: false schema: type: string - - &211 + - &213 name: before description: A cursor, as given in the [Link header](https://docs.github.com/enterprise-cloud@latest//rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for events before this cursor. @@ -10556,7 +11142,7 @@ paths: required: false schema: type: string - - &212 + - &214 name: order description: |- The order of audit log events. To list newest events first, specify `desc`. To list oldest events first, specify `asc`. @@ -10578,7 +11164,7 @@ paths: application/json: schema: type: array - items: &213 + items: &215 type: object properties: "@timestamp": @@ -10700,7 +11286,7 @@ paths: description: The repository visibility, for example `public` or `private`. examples: - default: &214 + default: &216 value: - "@timestamp": 1606929874512 action: team.add_member @@ -10880,7 +11466,7 @@ paths: vendor_specific: type: object oneOf: - - &74 + - &77 title: AzureBlobConfig description: Azure Blob Config for audit log streaming configuration. type: object @@ -10894,7 +11480,7 @@ paths: required: - key_id - encrypted_sas_url - - &75 + - &78 title: AzureHubConfig description: Azure Event Hubs Config for audit log streaming configuration. type: object @@ -10913,7 +11499,7 @@ paths: - name - encrypted_connstring - key_id - - &76 + - &79 title: AmazonS3OIDCConfig description: Amazon S3 OIDC Config for audit log streaming configuration. type: object @@ -10941,7 +11527,7 @@ paths: - bucket - key_id - region - - &77 + - &80 title: AmazonS3AccessKeysConfig description: Amazon S3 Access Keys Config for audit log streaming configuration. @@ -10975,7 +11561,7 @@ paths: - encrypted_secret_key - key_id - region - - &78 + - &81 title: SplunkConfig description: Splunk Config for Audit Log Stream Configuration type: object @@ -11003,7 +11589,7 @@ paths: - key_id - port - ssl_verify - - &79 + - &82 title: HecConfig description: Hec Config for Audit Log Stream Configuration type: object @@ -11035,7 +11621,7 @@ paths: - key_id - port - ssl_verify - - &80 + - &83 title: GoogleCloudConfig description: Google Cloud Config for audit log streaming configuration. type: object @@ -11053,7 +11639,7 @@ paths: - bucket - key_id - encrypted_json_credentials - - &81 + - &84 title: DatadogConfig description: Datadog Config for audit log streaming configuration. type: object @@ -11084,7 +11670,7 @@ paths: - stream_type - vendor_specific examples: - default: &82 + default: &85 value: enabled: false stream_type: Azure Event Hubs @@ -11098,7 +11684,7 @@ paths: description: The audit log stream configuration was created successfully. content: application/json: - schema: &71 + schema: &74 title: Get an audit log streaming configuration description: Get an audit log streaming configuration for an enterprise. type: object @@ -11130,7 +11716,7 @@ paths: - created_at - updated_at examples: - default: &72 + default: &75 value: id: 1 stream_type: Splunk @@ -11159,7 +11745,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/audit-log#list-one-audit-log-streaming-configuration-via-a-stream-id parameters: - *39 - - &73 + - &76 name: stream_id description: The ID of the audit log stream configuration. in: path @@ -11171,9 +11757,9 @@ paths: description: Lists one audit log stream configuration via stream ID. content: application/json: - schema: *71 + schema: *74 examples: - default: *72 + default: *75 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -11193,7 +11779,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/audit-log#update-an-existing-audit-log-stream-configuration parameters: - *39 - - *73 + - *76 requestBody: required: true content: @@ -11219,28 +11805,28 @@ paths: vendor_specific: type: object oneOf: - - *74 - - *75 - - *76 - *77 - *78 - *79 - *80 - *81 + - *82 + - *83 + - *84 required: - enabled - stream_type - vendor_specific examples: - default: *82 + default: *85 responses: '200': description: Successful update content: application/json: - schema: *71 + schema: *74 examples: - default: *72 + default: *75 '422': description: Validation error content: @@ -11271,7 +11857,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/audit-log#delete-an-audit-log-streaming-configuration-for-an-enterprise parameters: - *39 - - *73 + - *76 responses: '204': description: The audit log stream configuration was deleted successfully. @@ -11303,7 +11889,7 @@ paths: in: query schema: type: string - - &216 + - &218 name: reviewer description: Filter bypass requests by the handle of the GitHub user who reviewed the bypass request. @@ -11311,7 +11897,7 @@ paths: required: false schema: type: string - - &217 + - &219 name: requester description: Filter bypass requests by the handle of the GitHub user who requested the bypass. @@ -11319,7 +11905,7 @@ paths: required: false schema: type: string - - &218 + - &220 name: time_period description: |- The time period to filter by. @@ -11335,7 +11921,7 @@ paths: - week - month default: day - - &219 + - &221 name: request_status description: The status of the bypass request to filter on. When specified, only requests with this status will be returned. @@ -11362,7 +11948,7 @@ paths: application/json: schema: type: array - items: &220 + items: &222 title: Push rule bypass request description: A bypass request made by a user asking to be exempted from a push rule in this repository. @@ -11488,7 +12074,7 @@ paths: - array - 'null' description: The responses to the bypass request. - items: &223 + items: &225 title: Bypass response description: A response made by a delegated bypasser to a bypass request. @@ -11534,7 +12120,7 @@ paths: examples: - https://github.com/octo-org/smile/exemptions/1 examples: - default: &221 + default: &223 value: - id: 21 number: 42 @@ -11603,7 +12189,7 @@ paths: url: https://api.github.com/repos/octo-org/smile/bypass-requests/push-rules/2 html_url: https://github.com/octo-org/smile/exemptions/2 '404': *6 - '500': *83 + '500': *86 "/enterprises/{enterprise}/code-scanning/alerts": get: summary: List code scanning alerts for an enterprise @@ -11621,17 +12207,17 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#list-code-scanning-alerts-for-an-enterprise parameters: - *39 - - &228 + - &230 name: tool_name description: The name of a code scanning tool. Only results by this tool will be listed. You can specify the tool by using either `tool_name` or `tool_guid`, but not both. in: query required: false - schema: &87 + schema: &90 type: string description: The name of the tool used to generate the code scanning analysis. - - &229 + - &231 name: tool_guid description: The GUID of a code scanning tool. Only results by this tool will be listed. Note that some code scanning tools may not include a GUID in @@ -11639,23 +12225,23 @@ paths: or `tool_name`, but not both. in: query required: false - schema: &88 + schema: &91 type: - string - 'null' description: The GUID of the tool used to generate the code scanning analysis, if provided in the uploaded SARIF data. - - *84 - - *85 + - *87 + - *88 - *19 - *17 - - *86 + - *89 - name: state description: If specified, only code scanning alerts with this state will be returned. in: query required: false - schema: &230 + schema: &232 type: string description: State of a code scanning alert. enum: @@ -11680,42 +12266,42 @@ paths: application/json: schema: type: array - items: &231 + items: &233 type: object properties: - number: &96 + number: &99 type: integer description: The security alert number. readOnly: true - created_at: &103 + created_at: &106 type: string description: 'The time that the alert was created in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.' format: date-time readOnly: true - updated_at: &104 + updated_at: &107 type: string description: 'The time that the alert was last updated in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.' format: date-time readOnly: true - url: &101 + url: &104 type: string description: The REST API URL of the alert resource. format: uri readOnly: true - html_url: &102 + html_url: &105 type: string description: The GitHub URL of the alert resource. format: uri readOnly: true - instances_url: &450 + instances_url: &452 type: string description: The REST API URL for fetching the list of instances for an alert. format: uri readOnly: true - state: &89 + state: &92 type: - string - 'null' @@ -11725,7 +12311,7 @@ paths: - dismissed - fixed - - fixed_at: &106 + fixed_at: &109 type: - string - 'null' @@ -11737,7 +12323,7 @@ paths: anyOf: - type: 'null' - *4 - dismissed_at: &105 + dismissed_at: &108 type: - string - 'null' @@ -11745,7 +12331,7 @@ paths: format: `YYYY-MM-DDTHH:MM:SSZ`.' format: date-time readOnly: true - dismissed_reason: &451 + dismissed_reason: &453 type: - string - 'null' @@ -11756,14 +12342,14 @@ paths: - won't fix - used in tests - - dismissed_comment: &452 + dismissed_comment: &454 type: - string - 'null' description: The dismissal comment associated with the dismissal of the alert. maxLength: 280 - rule: &453 + rule: &455 type: object properties: id: @@ -11824,26 +12410,26 @@ paths: - 'null' description: A link to the documentation for the rule used to detect the alert. - tool: &454 + tool: &456 type: object properties: - name: *87 + name: *90 version: type: - string - 'null' description: The version of the tool used to generate the code scanning analysis. - guid: *88 - most_recent_instance: &455 + guid: *91 + most_recent_instance: &457 type: object properties: - ref: &448 + ref: &450 type: string description: |- The Git reference, formatted as `refs/pull//merge`, `refs/pull//head`, `refs/heads/` or simply ``. - analysis_key: &465 + analysis_key: &467 type: string description: Identifies the configuration under which the analysis was executed. For example, in GitHub Actions @@ -11854,13 +12440,13 @@ paths: the environment in which the analysis that generated this alert instance was performed, such as the language that was analyzed. - category: &466 + category: &468 type: string description: Identifies the configuration under which the analysis was executed. Used to distinguish between multiple analyses for the same tool and commit, but performed on different languages or different parts of the code. - state: *89 + state: *92 commit_sha: type: string message: @@ -11901,7 +12487,7 @@ paths: - test - library - - repository: &95 + repository: &98 title: Simple Repository description: A GitHub repository. type: object @@ -12242,7 +12828,7 @@ paths: - most_recent_instance - repository examples: - default: &232 + default: &234 value: - number: 4 created_at: '2020-02-13T12:29:18Z' @@ -12473,7 +13059,7 @@ paths: headers: Link: *38 '404': *6 - '503': &130 + '503': &133 description: Service unavailable content: application/json: @@ -12517,8 +13103,8 @@ paths: schema: type: integer default: 30 - - *84 - - *85 + - *87 + - *88 responses: '200': description: Response @@ -12526,7 +13112,7 @@ paths: application/json: schema: type: array - items: &90 + items: &93 type: object description: A code security configuration properties: @@ -12894,7 +13480,7 @@ paths: - disabled - not_set default: disabled - code_scanning_default_setup_options: &93 + code_scanning_default_setup_options: &96 type: - object - 'null' @@ -13006,9 +13592,9 @@ paths: description: Successfully created code security configuration content: application/json: - schema: *90 + schema: *93 examples: - default: &91 + default: &94 value: id: 1325 target_type: enterprise @@ -13066,7 +13652,7 @@ paths: description: Response content: application/json: - schema: &234 + schema: &236 type: array description: A list of default code security configurations items: @@ -13080,9 +13666,9 @@ paths: description: The visibility of newly created repositories for which the code security configuration will be applied to by default - configuration: *90 + configuration: *93 examples: - default: &235 + default: &237 value: - default_for_new_repos: public configuration: @@ -13167,7 +13753,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#retrieve-a-code-security-configuration-of-an-enterprise parameters: - *39 - - &92 + - &95 name: configuration_id description: The unique identifier of the code security configuration. in: path @@ -13179,9 +13765,9 @@ paths: description: Response content: application/json: - schema: *90 + schema: *93 examples: - default: *91 + default: *94 '304': *35 '403': *27 '404': *6 @@ -13206,7 +13792,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#update-a-custom-code-security-configuration-for-an-enterprise parameters: - *39 - - *92 + - *95 requestBody: required: true content: @@ -13276,7 +13862,7 @@ paths: - enabled - disabled - not_set - code_scanning_default_setup_options: *93 + code_scanning_default_setup_options: *96 code_scanning_delegated_alert_dismissal: type: string description: The enablement status of code scanning delegated alert @@ -13357,13 +13943,13 @@ paths: description: Response content: application/json: - schema: *90 + schema: *93 examples: - default: *91 + default: *94 '304': *35 '403': *27 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -13387,14 +13973,14 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#delete-a-code-security-configuration-for-an-enterprise parameters: - *39 - - *92 + - *95 responses: - '204': &116 + '204': &119 description: A header with no content is returned. '400': *14 '403': *27 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -13419,7 +14005,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#attach-an-enterprise-configuration-to-repositories parameters: - *39 - - *92 + - *95 requestBody: required: true content: @@ -13446,7 +14032,7 @@ paths: '202': *37 '403': *27 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -13471,7 +14057,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#set-a-code-security-configuration-as-a-default-for-an-enterprise parameters: - *39 - - *92 + - *95 requestBody: required: true content: @@ -13511,12 +14097,12 @@ paths: - none - private_and_internal - public - configuration: *90 + configuration: *93 examples: default: value: default_for_new_repos: all - configuration: &233 + configuration: &235 value: id: 1325 target_type: organization @@ -13571,7 +14157,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#get-repositories-associated-with-an-enterprise-code-security-configuration parameters: - *39 - - *92 + - *95 - name: per_page description: The number of results per page (max 100). For more information, see "[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api)." @@ -13580,8 +14166,8 @@ paths: schema: type: integer default: 30 - - *84 - - *85 + - *87 + - *88 - name: status description: |- A comma-separated list of statuses. If specified, only repositories with these attachment statuses will be returned. @@ -13599,7 +14185,7 @@ paths: application/json: schema: type: array - items: &236 + items: &238 type: object description: Repositories associated with a code security configuration and attachment status @@ -13617,13 +14203,13 @@ paths: - failed - updating - removed_by_enterprise - repository: *95 + repository: *98 examples: default: summary: Example of code security configuration repositories value: - status: attached - repository: &237 + repository: &239 value: id: 1296269 node_id: MDEwOlJlcG9zaXRvcnkxMjk2MjY5 @@ -14106,7 +14692,7 @@ paths: or enterprise teams are only counted once. seats: type: array - items: &107 + items: &110 title: Copilot Business Seat Detail description: Information about a Copilot Business seat assignment for a user, team, or organization. @@ -14124,7 +14710,7 @@ paths: description: The team through which the assignee is granted access to GitHub Copilot, if applicable. oneOf: - - &224 + - &226 title: Team description: Groups of organization members that gives permissions on specified repositories. @@ -14183,7 +14769,7 @@ paths: parent: anyOf: - type: 'null' - - &297 + - &299 title: Team Simple description: Groups of organization members that gives permissions on specified repositories. @@ -14391,7 +14977,7 @@ paths: - created_at additionalProperties: false examples: - default: &108 + default: &111 value: total_seats: 2 seats: @@ -14460,7 +15046,7 @@ paths: site_admin: false headers: Link: *38 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -14522,7 +15108,7 @@ paths: application/json: schema: type: array - items: &134 + items: &137 title: Copilot Usage Metrics description: Copilot usage metrics for a given day. type: object @@ -14837,7 +15423,7 @@ paths: - date additionalProperties: true examples: - default: &135 + default: &138 value: - date: '2024-06-24' total_active_users: 24 @@ -14936,10 +15522,10 @@ paths: custom_model_training_date: '2024-02-01' total_pr_summaries_created: 10 total_engaged_users: 4 - '500': *83 + '500': *86 '403': *27 '404': *6 - '422': &136 + '422': &139 description: Copilot Usage Merics API setting is disabled at the organization or enterprise level. content: @@ -14969,7 +15555,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/alerts#list-dependabot-alerts-for-an-enterprise parameters: - *39 - - &244 + - &246 name: state in: query description: |- @@ -14978,7 +15564,7 @@ paths: Can be: `auto_dismissed`, `dismissed`, `fixed`, `open` schema: type: string - - &245 + - &247 name: severity in: query description: |- @@ -14987,7 +15573,7 @@ paths: Can be: `low`, `medium`, `high`, `critical` schema: type: string - - &246 + - &248 name: ecosystem in: query description: |- @@ -14996,14 +15582,14 @@ paths: Can be: `composer`, `go`, `maven`, `npm`, `nuget`, `pip`, `pub`, `rubygems`, `rust` schema: type: string - - &247 + - &249 name: package in: query description: A comma-separated list of package names. If specified, only alerts for these packages will be returned. schema: type: string - - &248 + - &250 name: epss_percentage in: query description: |- @@ -15015,7 +15601,7 @@ paths: Filters the list of alerts based on EPSS percentages. If specified, only alerts with the provided EPSS percentages will be returned. schema: type: string - - &249 + - &251 name: has in: query description: |- @@ -15029,7 +15615,7 @@ paths: type: string enum: - patch - - &250 + - &252 name: scope in: query description: The scope of the vulnerable dependency. If specified, only alerts @@ -15039,7 +15625,7 @@ paths: enum: - development - runtime - - &251 + - &253 name: sort in: query description: |- @@ -15054,10 +15640,10 @@ paths: - updated - epss_percentage default: created - - *86 - - *84 - - *85 - - &252 + - *89 + - *87 + - *88 + - &254 name: first description: |- **Deprecated**. The number of results per page (max 100), starting from the first matching result. @@ -15070,7 +15656,7 @@ paths: minimum: 1 maximum: 100 default: 30 - - &253 + - &255 name: last description: |- **Deprecated**. The number of results per page (max 100), starting from the last matching result. @@ -15090,11 +15676,11 @@ paths: application/json: schema: type: array - items: &254 + items: &256 type: object description: A Dependabot alert. properties: - number: *96 + number: *99 state: type: string description: The state of the Dependabot alert. @@ -15109,7 +15695,7 @@ paths: description: Details for the vulnerable dependency. readOnly: true properties: - package: &97 + package: &100 type: object description: Details for the vulnerable package. readOnly: true @@ -15157,7 +15743,7 @@ paths: - direct - transitive - - security_advisory: &502 + security_advisory: &504 type: object description: Details for the GitHub Security Advisory. readOnly: true @@ -15188,13 +15774,13 @@ paths: description: Vulnerable version range information for the advisory. readOnly: true - items: &100 + items: &103 type: object description: Details pertaining to one vulnerable version range for the advisory. readOnly: true properties: - package: *97 + package: *100 severity: type: string description: The severity of the vulnerability. @@ -15262,8 +15848,8 @@ paths: - score - vector_string additionalProperties: false - cvss_severities: *98 - epss: *99 + cvss_severities: *101 + epss: *102 cwes: type: array description: Details for the advisory pertaining to Common @@ -15363,12 +15949,12 @@ paths: - updated_at - withdrawn_at additionalProperties: false - security_vulnerability: *100 - url: *101 - html_url: *102 - created_at: *103 - updated_at: *104 - dismissed_at: *105 + security_vulnerability: *103 + url: *104 + html_url: *105 + created_at: *106 + updated_at: *107 + dismissed_at: *108 dismissed_by: anyOf: - type: 'null' @@ -15392,8 +15978,8 @@ paths: description: An optional comment associated with the alert's dismissal. maxLength: 280 - fixed_at: *106 - auto_dismissed_at: &503 + fixed_at: *109 + auto_dismissed_at: &505 type: - string - 'null' @@ -15401,7 +15987,7 @@ paths: ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.' format: date-time readOnly: true - repository: *95 + repository: *98 required: - number - state @@ -15420,7 +16006,7 @@ paths: - repository additionalProperties: false examples: - default: &255 + default: &257 value: - number: 2 state: dismissed @@ -15837,7 +16423,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/copilot/copilot-user-management#get-copilot-seat-assignment-details-for-an-enterprise-user parameters: - *39 - - &215 + - &217 name: username description: The handle for the GitHub user account. in: path @@ -15859,10 +16445,10 @@ paths: teams or multiple organizations are only counted once. seats: type: array - items: *107 + items: *110 examples: - default: *108 - '500': *83 + default: *111 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -15904,7 +16490,7 @@ paths: type: integer network_configurations: type: array - items: &109 + items: &112 title: Hosted compute network configuration description: A hosted compute network configuration. type: object @@ -15949,7 +16535,7 @@ paths: - name - created_on examples: - default: &345 + default: &347 value: total_count: 2 network_configurations: @@ -16027,9 +16613,9 @@ paths: description: Response content: application/json: - schema: *109 + schema: *112 examples: - default: &110 + default: &113 value: id: 123456789ABCDEF name: My network configuration @@ -16056,7 +16642,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/network-configurations#get-a-hosted-compute-network-configuration-for-an-enterprise parameters: - *39 - - &111 + - &114 name: network_configuration_id description: Unique identifier of the hosted compute network configuration. in: path @@ -16068,9 +16654,9 @@ paths: description: Response content: application/json: - schema: *109 + schema: *112 examples: - default: *110 + default: *113 headers: Link: *38 x-github: @@ -16090,7 +16676,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/network-configurations#update-a-hosted-compute-network-configuration-for-an-enterprise parameters: - *39 - - *111 + - *114 requestBody: required: true content: @@ -16129,9 +16715,9 @@ paths: description: Response content: application/json: - schema: *109 + schema: *112 examples: - default: *110 + default: *113 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -16149,7 +16735,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/network-configurations#delete-a-hosted-compute-network-configuration-from-an-enterprise parameters: - *39 - - *111 + - *114 responses: '204': description: Response @@ -16172,7 +16758,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/network-configurations#get-a-hosted-compute-network-settings-resource-for-an-enterprise parameters: - *39 - - &346 + - &348 name: network_settings_id description: Unique identifier of the hosted compute network settings. in: path @@ -16184,7 +16770,7 @@ paths: description: Response content: application/json: - schema: &347 + schema: &349 title: Hosted compute network settings resource description: A hosted compute network settings resource. type: object @@ -16223,7 +16809,7 @@ paths: - subnet_id - region examples: - default: &348 + default: &350 value: id: 220F78DACB92BBFBC5E6F22DE1CCF52309D network_configuration_id: 934E208B3EE0BD60CF5F752C426BFB53562 @@ -16258,7 +16844,7 @@ paths: application/json: schema: type: array - items: &112 + items: &115 title: Organization Custom Property description: Custom property defined on an organization type: object @@ -16334,7 +16920,7 @@ paths: - property_name - value_type examples: - default: &113 + default: &116 value: - property_name: environment url: https://api.github.com/orgs/github/properties/schema/environment @@ -16391,7 +16977,7 @@ paths: properties: type: array description: The array of custom properties to create or update. - items: *112 + items: *115 minItems: 1 maxItems: 100 required: @@ -16421,9 +17007,9 @@ paths: application/json: schema: type: array - items: *112 + items: *115 examples: - default: *113 + default: *116 '403': *27 '404': *6 x-github: @@ -16446,14 +17032,8 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/custom-properties#promote-a-custom-property-to-an-enterprise parameters: - *39 - - &167 - name: org - description: The organization name. The name is not case sensitive. - in: path - required: true - schema: - type: string - - &114 + - *71 + - &117 name: custom_property_name description: The custom property name in: path @@ -16465,9 +17045,9 @@ paths: description: Response content: application/json: - schema: *112 + schema: *115 examples: - default: &115 + default: &118 value: property_name: environment url: https://api.github.com/orgs/github/properties/schema/environment @@ -16500,15 +17080,15 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/custom-properties#get-a-custom-property-for-an-enterprise parameters: - *39 - - *114 + - *117 responses: '200': description: Response content: application/json: - schema: *112 + schema: *115 examples: - default: *115 + default: *118 '403': *27 '404': *6 x-github: @@ -16530,12 +17110,12 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/custom-properties#create-or-update-a-custom-property-for-an-enterprise parameters: - *39 - - *114 + - *117 requestBody: required: true content: application/json: - schema: &316 + schema: &318 title: Custom Property Set Payload description: Custom property set payload type: object @@ -16608,9 +17188,9 @@ paths: description: Response content: application/json: - schema: *112 + schema: *115 examples: - default: *115 + default: *118 '403': *27 '404': *6 x-github: @@ -16632,9 +17212,9 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/custom-properties#remove-a-custom-property-for-an-enterprise parameters: - *39 - - *114 + - *117 responses: - '204': *116 + '204': *119 '403': *27 '404': *6 x-github: @@ -16674,7 +17254,7 @@ paths: - push - repository default: branch - enforcement: &123 + enforcement: &126 type: string description: The enforcement level of the ruleset. `evaluate` allows admins to test rules before enforcing them. Admins can view insights @@ -16687,7 +17267,7 @@ paths: bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: &124 + items: &127 title: Repository Ruleset Bypass Actor type: object description: An actor that can bypass rules in a ruleset @@ -16725,7 +17305,7 @@ paths: - always - pull_request default: always - conditions: &128 + conditions: &131 title: Enterprise ruleset conditions type: object description: Conditions for an enterprise ruleset. The conditions @@ -16739,7 +17319,7 @@ paths: description: Conditions to target organizations by name and all repositories allOf: - - &117 + - &120 title: Repository ruleset conditions for organization names type: object description: Parameters for an organization name condition @@ -16765,7 +17345,7 @@ paths: type: string required: - organization_name - - &120 + - &123 title: Repository ruleset conditions for repository names type: object description: Parameters for a repository name condition @@ -16794,7 +17374,7 @@ paths: is prevented. required: - repository_name - - &119 + - &122 title: Repository ruleset conditions for ref names type: object description: Parameters for a repository ruleset ref name condition @@ -16822,8 +17402,8 @@ paths: description: Conditions to target organizations by name and repositories by property allOf: - - *117 - - &122 + - *120 + - &125 title: Repository ruleset conditions for repository properties type: object description: Parameters for a repository property condition @@ -16836,7 +17416,7 @@ paths: description: The repository properties and values to include. All of these properties must match for the condition to pass. - items: &118 + items: &121 title: Repository ruleset property targeting definition type: object description: Parameters for a targeting a repository @@ -16867,16 +17447,16 @@ paths: description: The repository properties and values to exclude. The condition will not pass if any of these properties match. - items: *118 + items: *121 required: - repository_property - - *119 + - *122 - type: object title: organization_id_and_repository_name description: Conditions to target organizations by id and all repositories allOf: - - &121 + - &124 title: Repository ruleset conditions for organization IDs type: object description: Parameters for an organization ID condition @@ -16893,25 +17473,25 @@ paths: type: integer required: - organization_id - - *120 - - *119 + - *123 + - *122 - type: object title: organization_id_and_repository_property description: Conditions to target organization by id and repositories by property allOf: - - *121 + - *124 + - *125 - *122 - - *119 rules: type: array description: An array of rules within the ruleset. - items: &125 + items: &128 title: Repository Rule type: object description: A repository rule. oneOf: - - &618 + - &620 title: creation description: Only allow users with bypass permission to create matching refs. @@ -16923,7 +17503,7 @@ paths: type: string enum: - creation - - &619 + - &621 title: update description: Only allow users with bypass permission to update matching refs. @@ -16944,7 +17524,7 @@ paths: repository required: - update_allows_fetch_and_merge - - &621 + - &623 title: deletion description: Only allow users with bypass permissions to delete matching refs. @@ -16956,7 +17536,7 @@ paths: type: string enum: - deletion - - &622 + - &624 title: required_linear_history description: Prevent merge commits from being pushed to matching refs. @@ -16968,7 +17548,7 @@ paths: type: string enum: - required_linear_history - - &623 + - &625 title: merge_queue description: Merges must be performed via a merge queue. type: object @@ -17044,7 +17624,7 @@ paths: - merge_method - min_entries_to_merge - min_entries_to_merge_wait_minutes - - &624 + - &626 title: required_deployments description: Choose which environments must be successfully deployed to before refs can be pushed into a ref that matches @@ -17068,7 +17648,7 @@ paths: type: string required: - required_deployment_environments - - &625 + - &627 title: required_signatures description: Commits pushed to matching refs must have verified signatures. @@ -17080,7 +17660,7 @@ paths: type: string enum: - required_signatures - - &626 + - &628 title: pull_request description: Require all commits be made to a non-target branch and submitted via a pull request before they can be merged. @@ -17140,7 +17720,7 @@ paths: - require_last_push_approval - required_approving_review_count - required_review_thread_resolution - - &627 + - &629 title: required_status_checks description: Choose which status checks must pass before the ref is updated. When enabled, commits must first be pushed @@ -17187,7 +17767,7 @@ paths: required: - required_status_checks - strict_required_status_checks_policy - - &628 + - &630 title: non_fast_forward description: Prevent users with push access from force pushing to refs. @@ -17199,7 +17779,7 @@ paths: type: string enum: - non_fast_forward - - &629 + - &631 title: commit_message_pattern description: Parameters to be used for the commit_message_pattern rule @@ -17235,7 +17815,7 @@ paths: required: - operator - pattern - - &630 + - &632 title: commit_author_email_pattern description: Parameters to be used for the commit_author_email_pattern rule @@ -17271,7 +17851,7 @@ paths: required: - operator - pattern - - &631 + - &633 title: committer_email_pattern description: Parameters to be used for the committer_email_pattern rule @@ -17307,7 +17887,7 @@ paths: required: - operator - pattern - - &632 + - &634 title: branch_name_pattern description: Parameters to be used for the branch_name_pattern rule @@ -17343,7 +17923,7 @@ paths: required: - operator - pattern - - &633 + - &635 title: tag_name_pattern description: Parameters to be used for the tag_name_pattern rule @@ -17379,7 +17959,7 @@ paths: required: - operator - pattern - - &634 + - &636 title: file_path_restriction description: Prevent commits that include changes in specified file and folder paths from being pushed to the commit graph. @@ -17403,7 +17983,7 @@ paths: type: string required: - restricted_file_paths - - &635 + - &637 title: max_file_path_length description: Prevent commits that include file paths that exceed the specified character limit from being pushed to the commit @@ -17427,7 +18007,7 @@ paths: maximum: 32767 required: - max_file_path_length - - &636 + - &638 title: file_extension_restriction description: Prevent commits that include files with specified file extensions from being pushed to the commit graph. @@ -17450,7 +18030,7 @@ paths: type: string required: - restricted_file_extensions - - &637 + - &639 title: max_file_size description: Prevent commits with individual files that exceed the specified limit from being pushed to the commit graph. @@ -17474,7 +18054,7 @@ paths: maximum: 100 required: - max_file_size - - &638 + - &640 title: workflows description: Require all changes made to a targeted branch to pass the specified workflows before they can be merged. @@ -17523,7 +18103,7 @@ paths: - repository_id required: - workflows - - &639 + - &641 title: code_scanning description: Choose which tools must provide code scanning results before the reference is updated. When configured, code scanning @@ -17609,7 +18189,7 @@ paths: description: Response content: application/json: - schema: &126 + schema: &129 title: Repository ruleset type: object description: A set of rules to apply when specified conditions are @@ -17644,11 +18224,11 @@ paths: source: type: string description: The name of the source - enforcement: *123 + enforcement: *126 bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: *124 + items: *127 current_user_can_bypass: type: string description: |- @@ -17679,8 +18259,8 @@ paths: description: The html URL of the ruleset conditions: anyOf: - - *119 - - &321 + - *122 + - &323 title: Organization ruleset conditions type: object description: |- @@ -17694,14 +18274,14 @@ paths: description: Conditions to target repositories by name and refs by name allOf: - - *119 - - *120 + - *122 + - *123 - type: object title: repository_id_and_ref_name description: Conditions to target repositories by id and refs by name allOf: - - *119 + - *122 - title: Repository ruleset conditions for repository IDs type: object description: Parameters for a repository ID condition @@ -17723,14 +18303,14 @@ paths: description: Conditions to target repositories by property and refs by name allOf: - - *119 - *122 + - *125 type: - 'null' - object rules: type: array - items: *125 + items: *128 created_at: type: string format: date-time @@ -17738,7 +18318,7 @@ paths: type: string format: date-time examples: - default: &127 + default: &130 value: id: 21 name: super cool ruleset @@ -17764,7 +18344,7 @@ paths: created_at: '2024-08-15T08:43:03Z' updated_at: '2024-09-23T16:29:47Z' '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -17797,11 +18377,11 @@ paths: description: Response content: application/json: - schema: *126 + schema: *129 examples: - default: *127 + default: *130 '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -17843,16 +18423,16 @@ paths: - tag - push - repository - enforcement: *123 + enforcement: *126 bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: *124 - conditions: *128 + items: *127 + conditions: *131 rules: description: An array of rules within the ruleset. type: array - items: *125 + items: *128 examples: default: value: @@ -17876,11 +18456,11 @@ paths: description: Response content: application/json: - schema: *126 + schema: *129 examples: - default: *127 + default: *130 '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -17907,7 +18487,7 @@ paths: '204': description: Response '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -17940,7 +18520,7 @@ paths: application/json: schema: type: array - items: &129 + items: &132 title: Ruleset version type: object description: The historical version of a ruleset @@ -17964,7 +18544,7 @@ paths: type: string format: date-time examples: - default: &323 + default: &325 value: - version_id: 3 actor: @@ -17982,7 +18562,7 @@ paths: type: User updated_at: '2024-08-23T16:29:47Z' '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -18017,9 +18597,9 @@ paths: description: Response content: application/json: - schema: &324 + schema: &326 allOf: - - *129 + - *132 - type: object required: - state @@ -18052,7 +18632,7 @@ paths: rules: - type: repository_delete '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -18072,7 +18652,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/secret-scanning/secret-scanning#list-secret-scanning-alerts-for-an-enterprise parameters: - *39 - - &325 + - &327 name: state in: query description: Set to `open` or `resolved` to only list secret scanning alerts @@ -18083,7 +18663,7 @@ paths: enum: - open - resolved - - &326 + - &328 name: secret_type in: query description: A comma-separated list of secret types to return. All default @@ -18093,7 +18673,7 @@ paths: required: false schema: type: string - - &327 + - &329 name: resolution in: query description: A comma-separated list of resolutions. Only secret scanning alerts @@ -18102,7 +18682,7 @@ paths: required: false schema: type: string - - &328 + - &330 name: sort description: The property to sort the results by. `created` means when the alert was created. `updated` means when the alert was updated or resolved. @@ -18114,11 +18694,11 @@ paths: - created - updated default: created - - *86 + - *89 - *17 - - *84 - - *85 - - &329 + - *87 + - *88 + - &331 name: validity in: query description: A comma-separated list of validities that, when present, will @@ -18127,7 +18707,7 @@ paths: required: false schema: type: string - - &330 + - &332 name: is_publicly_leaked in: query description: A boolean value representing whether or not to filter alerts @@ -18136,7 +18716,7 @@ paths: schema: type: boolean default: false - - &331 + - &333 name: is_multi_repo in: query description: A boolean value representing whether or not to filter alerts @@ -18145,7 +18725,7 @@ paths: schema: type: boolean default: false - - &332 + - &334 name: hide_secret in: query description: A boolean value representing whether or not to hide literal secrets @@ -18161,30 +18741,30 @@ paths: application/json: schema: type: array - items: &333 + items: &335 type: object properties: - number: *96 - created_at: *103 + number: *99 + created_at: *106 updated_at: anyOf: - type: 'null' - - *104 - url: *101 - html_url: *102 + - *107 + url: *104 + html_url: *105 locations_url: type: string format: uri description: The REST API URL of the code locations for this alert. - state: &652 + state: &654 description: Sets the state of the secret scanning alert. You must provide `resolution` when you set the state to `resolved`. type: string enum: - open - resolved - resolution: &653 + resolution: &655 type: - string - 'null' @@ -18218,7 +18798,7 @@ paths: secret: type: string description: The secret that was detected. - repository: *95 + repository: *98 push_protection_bypassed: type: - boolean @@ -18291,14 +18871,14 @@ paths: first_location_detected: anyOf: - type: 'null' - - &654 + - &656 description: 'Details on the location where the token was initially detected. This can be a commit, wiki commit, issue, discussion, pull request. ' oneOf: - - &656 + - &658 description: Represents a 'commit' secret scanning location type. This location type shows that a secret was detected inside a commit to a repository. @@ -18355,7 +18935,7 @@ paths: - blob_url - commit_sha - commit_url - - &657 + - &659 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. @@ -18416,7 +18996,7 @@ paths: - page_url - commit_sha - commit_url - - &658 + - &660 description: Represents an 'issue_title' secret scanning location type. This location type shows that a secret was detected in the title of an issue. @@ -18431,7 +19011,7 @@ paths: - https://api.github.com/repos/octocat/Hello-World/issues/1347 required: - issue_title_url - - &659 + - &661 description: Represents an 'issue_body' secret scanning location type. This location type shows that a secret was detected in the body of an issue. @@ -18446,7 +19026,7 @@ paths: - https://api.github.com/repos/octocat/Hello-World/issues/1347 required: - issue_body_url - - &660 + - &662 description: Represents an 'issue_comment' secret scanning location type. This location type shows that a secret was detected in a comment on an issue. @@ -18461,7 +19041,7 @@ paths: - https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451 required: - issue_comment_url - - &661 + - &663 description: Represents a 'discussion_title' secret scanning location type. This location type shows that a secret was detected in the title of a discussion. @@ -18476,7 +19056,7 @@ paths: - https://github.com/community/community/discussions/39082 required: - discussion_title_url - - &662 + - &664 description: Represents a 'discussion_body' secret scanning location type. This location type shows that a secret was detected in the body of a discussion. @@ -18491,7 +19071,7 @@ paths: - https://github.com/community/community/discussions/39082#discussion-4566270 required: - discussion_body_url - - &663 + - &665 description: Represents a 'discussion_comment' secret scanning location type. This location type shows that a secret was detected in a comment on a discussion. @@ -18506,7 +19086,7 @@ paths: - https://github.com/community/community/discussions/39082#discussioncomment-4158232 required: - discussion_comment_url - - &664 + - &666 description: Represents a 'pull_request_title' secret scanning location type. This location type shows that a secret was detected in the title of a pull request. @@ -18521,7 +19101,7 @@ paths: - https://api.github.com/repos/octocat/Hello-World/pulls/2846 required: - pull_request_title_url - - &665 + - &667 description: Represents a 'pull_request_body' secret scanning location type. This location type shows that a secret was detected in the body of a pull request. @@ -18536,7 +19116,7 @@ paths: - https://api.github.com/repos/octocat/Hello-World/pulls/2846 required: - pull_request_body_url - - &666 + - &668 description: Represents a 'pull_request_comment' secret scanning location type. This location type shows that a secret was detected in a comment on a pull request. @@ -18551,7 +19131,7 @@ paths: - https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451 required: - pull_request_comment_url - - &667 + - &669 description: Represents a 'pull_request_review' secret scanning location type. This location type shows that a secret was detected in a review on a pull request. @@ -18566,7 +19146,7 @@ paths: - https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80 required: - pull_request_review_url - - &668 + - &670 description: Represents a 'pull_request_review_comment' secret scanning location type. This location type shows that a secret was detected in a review comment on a pull @@ -18587,7 +19167,7 @@ paths: description: A boolean value representing whether or not the token in the alert was detected in more than one location. examples: - default: &334 + default: &336 value: - number: 2 created_at: '2020-11-06T18:48:51Z' @@ -18838,7 +19418,7 @@ paths: headers: Link: *38 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -18869,7 +19449,7 @@ paths: description: Response content: application/json: - schema: &336 + schema: &338 type: object properties: total_minutes_used: @@ -18939,7 +19519,7 @@ paths: - included_minutes - minutes_used_breakdown examples: - default: &337 + default: &339 value: total_minutes_used: 305 total_paid_minutes_used: 0 @@ -18970,7 +19550,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#get-github-advanced-security-active-committers-for-an-enterprise parameters: - *39 - - &338 + - &340 name: advanced_security_product in: query description: | @@ -18990,7 +19570,7 @@ paths: description: Success content: application/json: - schema: &339 + schema: &341 type: object properties: total_advanced_security_committers: @@ -19053,7 +19633,7 @@ paths: required: - repositories examples: - default: &340 + default: &342 value: total_advanced_security_committers: 2 total_count: 2 @@ -19149,8 +19729,8 @@ paths: name: octocat/hello-world '400': *14 '403': *27 - '500': *83 - '503': *130 + '500': *86 + '503': *133 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -19169,7 +19749,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#get-a-cost-center-by-id parameters: - *39 - - &133 + - &136 name: cost_center_id description: The ID corresponding to the cost center. in: path @@ -19181,7 +19761,7 @@ paths: description: Response when getting a cost center content: application/json: - schema: &131 + schema: &134 type: object properties: id: @@ -19209,7 +19789,7 @@ paths: - name - resources examples: - default: &132 + default: &135 value: - id: 2eeb8ffe-6903-11ee-8c99-0242ac120002 name: Cost Center Name @@ -19220,8 +19800,8 @@ paths: name: octocat/hello-world '400': *14 '403': *27 - '500': *83 - '503': *130 + '500': *86 + '503': *133 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -19271,15 +19851,15 @@ paths: description: Response when updating a cost center content: application/json: - schema: *131 + schema: *134 examples: - default: *132 + default: *135 '400': *14 '403': *27 '404': *6 - '409': *94 - '500': *83 - '503': *130 + '409': *97 + '500': *86 + '503': *133 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -19297,7 +19877,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#delete-a-cost-center parameters: - *39 - - *133 + - *136 responses: '200': description: Response when deleting a cost center @@ -19335,8 +19915,8 @@ paths: '400': *14 '404': *6 '403': *27 - '500': *83 - '503': *130 + '500': *86 + '503': *133 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -19357,7 +19937,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#add-users-to-a-cost-center parameters: - *39 - - *133 + - *136 requestBody: required: true content: @@ -19392,9 +19972,9 @@ paths: message: Resources successfully added to the cost center. '400': *14 '403': *27 - '409': *94 - '500': *83 - '503': *130 + '409': *97 + '500': *86 + '503': *133 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -19414,7 +19994,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#remove-users-from-a-cost-center parameters: - *39 - - *133 + - *136 requestBody: required: true content: @@ -19450,8 +20030,8 @@ paths: message: Resources successfully removed from the cost center. '400': *14 '403': *27 - '500': *83 - '503': *130 + '500': *86 + '503': *133 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -19482,7 +20062,7 @@ paths: description: Response content: application/json: - schema: &341 + schema: &343 type: object properties: total_gigabytes_bandwidth_used: @@ -19500,7 +20080,7 @@ paths: - total_paid_gigabytes_bandwidth_used - included_gigabytes_bandwidth examples: - default: &342 + default: &344 value: total_gigabytes_bandwidth_used: 50 total_paid_gigabytes_bandwidth_used: 40 @@ -19535,7 +20115,7 @@ paths: description: Response content: application/json: - schema: &343 + schema: &345 type: object properties: days_left_in_billing_cycle: @@ -19553,7 +20133,7 @@ paths: - estimated_paid_storage_for_month - estimated_storage_for_month examples: - default: &344 + default: &346 value: days_left_in_billing_cycle: 20 estimated_paid_storage_for_month: 15 @@ -19578,7 +20158,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#get-billing-usage-report-for-an-enterprise parameters: - *39 - - &168 + - &170 name: year description: If specified, only return results for a single year. The value of `year` is an integer with four digits representing a year. For example, @@ -19587,7 +20167,7 @@ paths: required: false schema: type: integer - - &169 + - &171 name: month description: If specified, only return results for a single month. The value of `month` is an integer between `1` and `12`. If no year is specified the @@ -19596,7 +20176,7 @@ paths: required: false schema: type: integer - - &170 + - &172 name: day description: If specified, only return results for a single day. The value of `day` is an integer between `1` and `31`. If no `year` or `month` is @@ -19605,7 +20185,7 @@ paths: required: false schema: type: integer - - &171 + - &173 name: hour description: If specified, only return results for a single hour. The value of `hour` is an integer between `0` and `23`. If no `year`, `month`, or @@ -19626,7 +20206,7 @@ paths: description: Response when getting a billing usage report content: application/json: - schema: &172 + schema: &174 type: object properties: usageItems: @@ -19679,7 +20259,7 @@ paths: - netAmount - organizationName examples: - default: &173 + default: &175 value: usageItems: - date: '2023-08-01' @@ -19695,8 +20275,8 @@ paths: repositoryName: github/example '400': *14 '403': *27 - '500': *83 - '503': *130 + '500': *86 + '503': *133 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -19767,13 +20347,13 @@ paths: application/json: schema: type: array - items: *134 + items: *137 examples: - default: *135 - '500': *83 + default: *138 + '500': *86 '403': *27 '404': *6 - '422': *136 + '422': *139 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -19862,7 +20442,7 @@ paths: application/json: schema: type: array - items: &162 + items: &165 title: Event description: Event type: object @@ -19873,7 +20453,7 @@ paths: type: - string - 'null' - actor: &137 + actor: &140 title: Actor description: Actor type: object @@ -19914,13 +20494,13 @@ paths: - id - name - url - org: *137 + org: *140 payload: type: object properties: action: type: string - issue: &151 + issue: &154 title: Issue description: Issues are a great way to keep track of tasks, enhancements, and bugs for your projects. @@ -20040,7 +20620,7 @@ paths: milestone: anyOf: - type: 'null' - - &490 + - &492 title: Milestone description: A collection of related issues and pull requests. @@ -20212,7 +20792,7 @@ paths: timeline_url: type: string format: uri - type: &282 + type: &284 title: Issue Type description: The type of issue. type: @@ -20270,7 +20850,7 @@ paths: anyOf: - type: 'null' - *5 - author_association: &138 + author_association: &141 title: author_association type: string description: How the author is associated with the repository. @@ -20285,7 +20865,7 @@ paths: - OWNER examples: - OWNER - reactions: &139 + reactions: &142 title: Reaction Rollup type: object properties: @@ -20357,7 +20937,7 @@ paths: - author_association - created_at - updated_at - comment: &558 + comment: &560 title: Issue Comment description: Comments provide a way for people to collaborate on an issue. @@ -20407,12 +20987,12 @@ paths: issue_url: type: string format: uri - author_association: *138 + author_association: *141 performed_via_github_app: anyOf: - type: 'null' - *5 - reactions: *139 + reactions: *142 required: - id - node_id @@ -20509,7 +21089,7 @@ paths: created_at: '2022-06-07T07:50:26Z' '304': *35 '403': *27 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -20599,7 +21179,7 @@ paths: _links: type: object properties: - timeline: &140 + timeline: &143 title: Link With Type description: Hypermedia Link with Type type: object @@ -20611,17 +21191,17 @@ paths: required: - href - type - user: *140 - security_advisories: *140 - current_user: *140 - current_user_public: *140 - current_user_actor: *140 - current_user_organization: *140 + user: *143 + security_advisories: *143 + current_user: *143 + current_user_public: *143 + current_user_actor: *143 + current_user_organization: *143 current_user_organizations: type: array - items: *140 - repository_discussions: *140 - repository_discussions_category: *140 + items: *143 + repository_discussions: *143 + repository_discussions_category: *143 required: - timeline - user @@ -20683,7 +21263,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#list-gists-for-the-authenticated-user parameters: - - *141 + - *144 - *17 - *19 responses: @@ -20693,7 +21273,7 @@ paths: application/json: schema: type: array - items: &142 + items: &145 title: Base Gist description: Base Gist type: object @@ -20790,7 +21370,7 @@ paths: - created_at - updated_at examples: - default: &143 + default: &146 value: - url: https://api.github.com/gists/aa5a315d61ae9438b18d forks_url: https://api.github.com/gists/aa5a315d61ae9438b18d/forks @@ -20914,7 +21494,7 @@ paths: description: Response content: application/json: - schema: &144 + schema: &147 title: Gist Simple description: Gist Simple type: object @@ -20932,7 +21512,7 @@ paths: url: type: string format: uri - user: &723 + user: &725 title: Public User description: Public User type: object @@ -21306,7 +21886,7 @@ paths: truncated: type: boolean examples: - default: &145 + default: &148 value: url: https://api.github.com/gists/2decf6c462d9b4418f2 forks_url: https://api.github.com/gists/2decf6c462d9b4418f2/forks @@ -21410,7 +21990,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#list-public-gists parameters: - - *141 + - *144 - *17 - *19 responses: @@ -21420,9 +22000,9 @@ paths: application/json: schema: type: array - items: *142 + items: *145 examples: - default: *143 + default: *146 headers: Link: *38 '422': *15 @@ -21444,7 +22024,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#list-starred-gists parameters: - - *141 + - *144 - *17 - *19 responses: @@ -21454,9 +22034,9 @@ paths: application/json: schema: type: array - items: *142 + items: *145 examples: - default: *143 + default: *146 headers: Link: *38 '401': *23 @@ -21484,7 +22064,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#get-a-gist parameters: - - &146 + - &149 name: gist_id description: The unique identifier of the gist. in: path @@ -21496,10 +22076,10 @@ paths: description: Response content: application/json: - schema: *144 + schema: *147 examples: - default: *145 - '403': &149 + default: *148 + '403': &152 description: Forbidden Gist content: application/json: @@ -21548,7 +22128,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#update-a-gist parameters: - - *146 + - *149 requestBody: required: true content: @@ -21612,9 +22192,9 @@ paths: description: Response content: application/json: - schema: *144 + schema: *147 examples: - updateGist: *145 + updateGist: *148 deleteFile: value: url: https://api.github.com/gists/2decf6c462d9b4418f2 @@ -21772,7 +22352,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#delete-a-gist parameters: - - *146 + - *149 responses: '204': description: Response @@ -21801,7 +22381,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/comments#list-gist-comments parameters: - - *146 + - *149 - *17 - *19 responses: @@ -21811,7 +22391,7 @@ paths: application/json: schema: type: array - items: &147 + items: &150 title: Gist Comment description: A comment made to a gist. type: object @@ -21849,7 +22429,7 @@ paths: format: date-time examples: - '2011-04-18T23:23:56Z' - author_association: *138 + author_association: *141 required: - url - id @@ -21914,7 +22494,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/comments#create-a-gist-comment parameters: - - *146 + - *149 requestBody: required: true content: @@ -21940,9 +22520,9 @@ paths: description: Response content: application/json: - schema: *147 + schema: *150 examples: - default: &148 + default: &151 value: id: 1 node_id: MDExOkdpc3RDb21tZW50MQ== @@ -22000,8 +22580,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/comments#get-a-gist-comment parameters: - - *146 - - &150 + - *149 + - &153 name: comment_id description: The unique identifier of the comment. in: path @@ -22014,12 +22594,12 @@ paths: description: Response content: application/json: - schema: *147 + schema: *150 examples: - default: *148 + default: *151 '304': *35 '404': *6 - '403': *149 + '403': *152 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -22041,8 +22621,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/comments#update-a-gist-comment parameters: - - *146 - - *150 + - *149 + - *153 requestBody: required: true content: @@ -22068,9 +22648,9 @@ paths: description: Response content: application/json: - schema: *147 + schema: *150 examples: - default: *148 + default: *151 '404': *6 x-github: githubCloudOnly: false @@ -22087,8 +22667,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/comments#delete-a-gist-comment parameters: - - *146 - - *150 + - *149 + - *153 responses: '204': description: Response @@ -22111,7 +22691,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#list-gist-commits parameters: - - *146 + - *149 - *17 - *19 responses: @@ -22212,7 +22792,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#list-gist-forks parameters: - - *146 + - *149 - *17 - *19 responses: @@ -22222,7 +22802,7 @@ paths: application/json: schema: type: array - items: *144 + items: *147 examples: default: value: @@ -22287,13 +22867,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#fork-a-gist parameters: - - *146 + - *149 responses: '201': description: Response content: application/json: - schema: *142 + schema: *145 examples: default: value: @@ -22364,7 +22944,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#check-if-a-gist-is-starred parameters: - - *146 + - *149 responses: '204': description: Response if gist is starred @@ -22394,7 +22974,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#star-a-gist parameters: - - *146 + - *149 responses: '204': description: Response @@ -22416,7 +22996,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#unstar-a-gist parameters: - - *146 + - *149 responses: '204': description: Response @@ -22445,7 +23025,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#get-a-gist-revision parameters: - - *146 + - *149 - name: sha in: path required: true @@ -22456,9 +23036,9 @@ paths: description: Response content: application/json: - schema: *144 + schema: *147 examples: - default: *145 + default: *148 '422': *15 '404': *6 '403': *27 @@ -22827,7 +23407,7 @@ paths: - closed - all default: open - - &285 + - &287 name: labels description: 'A list of comma separated label names. Example: `bug,ui,@high`' in: query @@ -22845,8 +23425,8 @@ paths: - updated - comments default: created - - *86 - - *141 + - *89 + - *144 - name: collab in: query required: false @@ -22876,9 +23456,9 @@ paths: application/json: schema: type: array - items: *151 + items: *154 examples: - default: &286 + default: &288 value: - id: 1 node_id: MDU6SXNzdWUx @@ -23158,7 +23738,7 @@ paths: application/json: schema: type: array - items: *152 + items: *155 examples: default: value: @@ -23456,7 +24036,7 @@ paths: example: '279' schema: type: string - X-CommonMarker-Version: &153 + X-CommonMarker-Version: &156 example: 0.17.4 schema: type: string @@ -23511,7 +24091,7 @@ paths: '200': description: Response headers: - X-CommonMarker-Version: *153 + X-CommonMarker-Version: *156 content: text/html: schema: @@ -23540,7 +24120,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/apps/marketplace#get-a-subscription-plan-for-an-account parameters: - - &156 + - &159 name: account_id description: account_id parameter in: path @@ -23552,7 +24132,7 @@ paths: description: Response content: application/json: - schema: &155 + schema: &158 title: Marketplace Purchase description: Marketplace Purchase type: object @@ -23586,7 +24166,7 @@ paths: - 'null' id: type: integer - plan: &154 + plan: &157 title: Marketplace Listing Plan description: Marketplace Listing Plan type: object @@ -23689,7 +24269,7 @@ paths: - 'null' updated_at: type: string - plan: *154 + plan: *157 required: - url - id @@ -23697,7 +24277,7 @@ paths: - login - marketplace_purchase examples: - default: &157 + default: &160 value: url: https://api.github.com/orgs/github type: Organization @@ -23782,9 +24362,9 @@ paths: application/json: schema: type: array - items: *154 + items: *157 examples: - default: &158 + default: &161 value: - url: https://api.github.com/marketplace_listing/plans/1313 accounts_url: https://api.github.com/marketplace_listing/plans/1313/accounts @@ -23824,14 +24404,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/apps/marketplace#list-accounts-for-a-plan parameters: - - &159 + - &162 name: plan_id description: The unique identifier of the plan. in: path required: true schema: type: integer - - &160 + - &163 name: sort description: The property to sort the results by. in: query @@ -23861,9 +24441,9 @@ paths: application/json: schema: type: array - items: *155 + items: *158 examples: - default: &161 + default: &164 value: - url: https://api.github.com/orgs/github type: Organization @@ -23937,15 +24517,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/apps/marketplace#get-a-subscription-plan-for-an-account-stubbed parameters: - - *156 + - *159 responses: '200': description: Response content: application/json: - schema: *155 + schema: *158 examples: - default: *157 + default: *160 '404': description: Not Found when the account has not purchased the listing '401': *23 @@ -23977,9 +24557,9 @@ paths: application/json: schema: type: array - items: *154 + items: *157 examples: - default: *158 + default: *161 headers: Link: *38 '401': *23 @@ -24002,8 +24582,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/apps/marketplace#list-accounts-for-a-plan-stubbed parameters: - - *159 - - *160 + - *162 + - *163 - name: direction description: To return the oldest accounts first, set to `asc`. Ignored without the `sort` parameter. @@ -24023,9 +24603,9 @@ paths: application/json: schema: type: array - items: *155 + items: *158 examples: - default: *161 + default: *164 headers: Link: *38 '401': *23 @@ -24290,14 +24870,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/events#list-public-events-for-a-network-of-repositories parameters: - - &368 + - &370 name: owner description: The account owner of the repository. The name is not case sensitive. in: path required: true schema: type: string - - &369 + - &371 name: repo description: The name of the repository without the `.git` extension. The name is not case sensitive. @@ -24314,7 +24894,7 @@ paths: application/json: schema: type: array - items: *162 + items: *165 examples: default: value: @@ -24368,7 +24948,7 @@ paths: '404': *6 '403': *27 '304': *35 - '301': &382 + '301': &384 description: Moved permanently content: application/json: @@ -24390,7 +24970,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/notifications#list-notifications-for-the-authenticated-user parameters: - - &587 + - &589 name: all description: If `true`, show notifications marked as read. in: query @@ -24398,7 +24978,7 @@ paths: schema: type: boolean default: false - - &588 + - &590 name: participating description: If `true`, only shows notifications in which the user is directly participating or mentioned. @@ -24407,8 +24987,8 @@ paths: schema: type: boolean default: false - - *141 - - &589 + - *144 + - &591 name: before description: 'Only show notifications updated before the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: @@ -24433,14 +25013,14 @@ paths: application/json: schema: type: array - items: &163 + items: &166 title: Thread description: Thread type: object properties: id: type: string - repository: &193 + repository: &195 title: Minimal Repository description: Minimal Repository type: object @@ -24779,7 +25359,7 @@ paths: type: boolean examples: - false - security_and_analysis: &318 + security_and_analysis: &320 type: - object - 'null' @@ -24948,7 +25528,7 @@ paths: - url - subscription_url examples: - default: &590 + default: &592 value: - id: '1' repository: @@ -25114,7 +25694,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/notifications#get-a-thread parameters: - - &164 + - &167 name: thread_id description: The unique identifier of the notification thread. This corresponds to the value returned in the `id` field when you retrieve notifications @@ -25128,7 +25708,7 @@ paths: description: Response content: application/json: - schema: *163 + schema: *166 examples: default: value: @@ -25231,7 +25811,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/notifications#mark-a-thread-as-read parameters: - - *164 + - *167 responses: '205': description: Reset Content @@ -25254,7 +25834,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/notifications#mark-a-thread-as-done parameters: - - *164 + - *167 responses: '204': description: No content @@ -25277,13 +25857,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/notifications#get-a-thread-subscription-for-the-authenticated-user parameters: - - *164 + - *167 responses: '200': description: Response content: application/json: - schema: &165 + schema: &168 title: Thread Subscription description: Thread Subscription type: object @@ -25327,7 +25907,7 @@ paths: - url - subscribed examples: - default: &166 + default: &169 value: subscribed: true ignored: false @@ -25358,7 +25938,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/notifications#set-a-thread-subscription parameters: - - *164 + - *167 requestBody: required: false content: @@ -25379,9 +25959,9 @@ paths: description: Response content: application/json: - schema: *165 + schema: *168 examples: - default: *166 + default: *169 '304': *35 '403': *27 '401': *23 @@ -25404,7 +25984,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/notifications#delete-a-thread-subscription parameters: - - *164 + - *167 responses: '204': description: Response @@ -25501,7 +26081,7 @@ paths: type: array items: *57 examples: - default: &740 + default: &742 value: - login: github id: 1 @@ -25566,7 +26146,7 @@ paths: - 3 custom_roles: type: array - items: &239 + items: &241 title: Organization Custom Repository Role description: Custom repository roles created by organization owners @@ -25615,7 +26195,7 @@ paths: - created_at - updated_at examples: - default: &240 + default: &242 value: id: 8030 name: Security Engineer @@ -25662,7 +26242,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/repository-access#lists-the-repositories-dependabot-can-access-in-an-organization parameters: - - *167 + - *71 - name: page in: query description: The page number of results to fetch. @@ -25708,7 +26288,7 @@ paths: items: anyOf: - type: 'null' - - *95 + - *98 additionalProperties: false examples: default: @@ -25813,7 +26393,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/repository-access#updates-dependabots-repository-access-list-for-an-organization parameters: - - *167 + - *71 requestBody: required: true content: @@ -25879,7 +26459,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/repository-access#set-the-default-repository-access-level-for-dependabot parameters: - - *167 + - *71 requestBody: required: true content: @@ -25927,23 +26507,23 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/billing/enhanced-billing#get-billing-usage-report-for-an-organization parameters: - - *167 - - *168 - - *169 + - *71 - *170 - *171 + - *172 + - *173 responses: '200': description: Billing usage report response for an organization content: application/json: - schema: *172 + schema: *174 examples: - default: *173 + default: *175 '400': *14 '403': *27 - '500': *83 - '503': *130 + '500': *86 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -25969,13 +26549,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/orgs#get-an-organization parameters: - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: &174 + schema: &176 title: Organization Full description: |- Prevents users in the organization from using insecure methods of two-factor authentication to fulfill a two-factor requirement. @@ -26385,7 +26965,7 @@ paths: - updated_at - archived_at examples: - default-response: &175 + default-response: &177 value: login: github id: 1 @@ -26487,7 +27067,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/orgs#update-an-organization parameters: - - *167 + - *71 requestBody: required: false content: @@ -26711,18 +27291,18 @@ paths: description: Response content: application/json: - schema: *174 + schema: *176 examples: - default: *175 + default: *177 '422': description: Validation failed content: application/json: schema: oneOf: - - *176 - - *177 - '409': *94 + - *178 + - *179 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -26745,7 +27325,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/orgs#delete-an-organization parameters: - - *167 + - *71 responses: '202': *37 '404': *6 @@ -26770,15 +27350,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/cache#get-github-actions-cache-usage-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: *178 + schema: *180 examples: - default: *179 + default: *181 headers: Link: *38 x-github: @@ -26801,7 +27381,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/cache#list-repositories-with-github-actions-cache-usage-for-an-organization parameters: - - *167 + - *71 - *17 - *19 responses: @@ -26819,7 +27399,7 @@ paths: type: integer repository_cache_usages: type: array - items: &387 + items: &389 title: Actions Cache Usage by repository description: GitHub Actions Cache Usage by repository. type: object @@ -26877,7 +27457,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/hosted-runners#list-github-hosted-runners-for-an-organization parameters: - - *167 + - *71 - *17 - *19 responses: @@ -26897,7 +27477,7 @@ paths: type: array items: *40 examples: - default: *180 + default: *182 headers: Link: *38 x-github: @@ -26917,7 +27497,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/hosted-runners#create-a-github-hosted-runner-for-an-organization parameters: - - *167 + - *71 requestBody: required: true content: @@ -27004,7 +27584,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/hosted-runners#get-github-owned-images-for-github-hosted-runners-in-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -27040,7 +27620,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/hosted-runners#get-partner-images-for-github-hosted-runners-in-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -27075,15 +27655,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/hosted-runners#get-limits-on-github-hosted-runners-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: *181 + schema: *183 examples: - default: *182 + default: *184 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -27101,7 +27681,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/hosted-runners#get-github-hosted-runners-machine-specs-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -27119,7 +27699,7 @@ paths: type: array items: *43 examples: - default: *183 + default: *185 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -27137,7 +27717,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/hosted-runners#get-platforms-for-github-hosted-runners-in-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -27181,7 +27761,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/hosted-runners#get-a-github-hosted-runner-for-an-organization parameters: - - *167 + - *71 - *45 responses: '200': @@ -27210,7 +27790,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/hosted-runners#update-a-github-hosted-runner-for-an-organization parameters: - - *167 + - *71 - *45 requestBody: required: true @@ -27267,7 +27847,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/hosted-runners#delete-a-github-hosted-runner-for-an-organization parameters: - - *167 + - *71 - *45 responses: '202': @@ -27296,13 +27876,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/oidc#get-the-customization-template-for-an-oidc-subject-claim-for-an-organization parameters: - - *167 + - *71 responses: '200': description: A JSON serialized template for OIDC subject claim customization content: application/json: - schema: &184 + schema: &186 title: Actions OIDC Subject customization description: Actions OIDC Subject customization type: object @@ -27316,7 +27896,7 @@ paths: required: - include_claim_keys examples: - default: &185 + default: &187 value: include_claim_keys: - repo @@ -27338,20 +27918,20 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/oidc#set-the-customization-template-for-an-oidc-subject-claim-for-an-organization parameters: - - *167 + - *71 requestBody: required: true content: application/json: - schema: *184 + schema: *186 examples: - default: *185 + default: *187 responses: '201': description: Empty response content: application/json: - schema: &204 + schema: &206 title: Empty Object description: An object without any properties. type: object @@ -27381,7 +27961,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#get-github-actions-permissions-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -27390,7 +27970,7 @@ paths: schema: type: object properties: - enabled_repositories: &187 + enabled_repositories: &189 type: string description: The policy that controls the repositories in the organization that are allowed to run GitHub Actions. @@ -27404,7 +27984,7 @@ paths: that are allowed to run GitHub Actions, when `enabled_repositories` is set to `selected`. allowed_actions: *47 - selected_actions_url: *186 + selected_actions_url: *188 required: - enabled_repositories examples: @@ -27433,7 +28013,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#set-github-actions-permissions-for-an-organization parameters: - - *167 + - *71 responses: '204': description: Response @@ -27444,7 +28024,7 @@ paths: schema: type: object properties: - enabled_repositories: *187 + enabled_repositories: *189 allowed_actions: *47 required: - enabled_repositories @@ -27472,7 +28052,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#list-selected-repositories-enabled-for-github-actions-in-an-organization parameters: - - *167 + - *71 - *17 - *19 responses: @@ -27492,7 +28072,7 @@ paths: type: array items: *62 examples: - default: &734 + default: &736 value: total_count: 1 repositories: @@ -27632,7 +28212,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#set-selected-repositories-enabled-for-github-actions-in-an-organization parameters: - - *167 + - *71 responses: '204': description: Response @@ -27676,8 +28256,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#enable-a-selected-repository-for-github-actions-in-an-organization parameters: - - *167 - - &188 + - *71 + - &190 name: repository_id description: The unique identifier of the repository. in: path @@ -27705,8 +28285,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#disable-a-selected-repository-for-github-actions-in-an-organization parameters: - - *167 - - *188 + - *71 + - *190 responses: '204': description: Response @@ -27729,7 +28309,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#get-allowed-actions-and-reusable-workflows-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -27760,7 +28340,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#set-allowed-actions-and-reusable-workflows-for-an-organization parameters: - - *167 + - *71 responses: '204': description: Response @@ -27792,13 +28372,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#get-default-workflow-permissions-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: *189 + schema: *191 examples: default: *53 x-github: @@ -27821,7 +28401,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#set-default-workflow-permissions-for-an-organization parameters: - - *167 + - *71 responses: '204': description: Success response @@ -27832,7 +28412,7 @@ paths: required: false content: application/json: - schema: *190 + schema: *192 examples: default: *53 x-github: @@ -27854,7 +28434,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#list-self-hosted-runner-groups-for-an-organization parameters: - - *167 + - *71 - *17 - *19 - name: visible_to_repository @@ -27879,7 +28459,7 @@ paths: type: number runner_groups: type: array - items: &191 + items: &193 type: object properties: id: @@ -27996,7 +28576,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#create-a-self-hosted-runner-group-for-an-organization parameters: - - *167 + - *71 requestBody: required: true content: @@ -28069,9 +28649,9 @@ paths: description: Response content: application/json: - schema: *191 + schema: *193 examples: - default: &192 + default: &194 value: id: 2 name: octo-runner-group @@ -28106,14 +28686,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#get-a-self-hosted-runner-group-for-an-organization parameters: - - *167 + - *71 - *56 responses: '200': description: Response content: application/json: - schema: *191 + schema: *193 examples: default: value: @@ -28149,7 +28729,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#update-a-self-hosted-runner-group-for-an-organization parameters: - - *167 + - *71 - *56 requestBody: required: true @@ -28206,9 +28786,9 @@ paths: description: Response content: application/json: - schema: *191 + schema: *193 examples: - default: *192 + default: *194 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -28227,7 +28807,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#delete-a-self-hosted-runner-group-from-an-organization parameters: - - *167 + - *71 - *56 responses: '204': @@ -28251,7 +28831,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#list-github-hosted-runners-in-a-group-for-an-organization parameters: - - *167 + - *71 - *56 - *17 - *19 @@ -28272,7 +28852,7 @@ paths: type: array items: *40 examples: - default: *180 + default: *182 headers: Link: *38 x-github: @@ -28294,7 +28874,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#list-repository-access-to-a-self-hosted-runner-group-in-an-organization parameters: - - *167 + - *71 - *56 - *19 - *17 @@ -28313,9 +28893,9 @@ paths: type: number repositories: type: array - items: *193 + items: *195 examples: - default: &726 + default: &728 value: total_count: 1 repositories: @@ -28567,7 +29147,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#set-repository-access-for-a-self-hosted-runner-group-in-an-organization parameters: - - *167 + - *71 - *56 requestBody: required: true @@ -28612,9 +29192,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#add-repository-access-to-a-self-hosted-runner-group-in-an-organization parameters: - - *167 + - *71 - *56 - - *188 + - *190 responses: '204': description: Response @@ -28636,9 +29216,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#remove-repository-access-to-a-self-hosted-runner-group-in-an-organization parameters: - - *167 + - *71 - *56 - - *188 + - *190 responses: '204': description: Response @@ -28661,7 +29241,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#list-self-hosted-runners-in-a-group-for-an-organization parameters: - - *167 + - *71 - *56 - *17 - *19 @@ -28703,7 +29283,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#set-self-hosted-runners-in-a-group-for-an-organization parameters: - - *167 + - *71 - *56 requestBody: required: true @@ -28748,7 +29328,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#add-a-self-hosted-runner-to-a-group-for-an-organization parameters: - - *167 + - *71 - *56 - *59 responses: @@ -28772,7 +29352,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#remove-a-self-hosted-runner-from-a-group-for-an-organization parameters: - - *167 + - *71 - *56 - *59 responses: @@ -28804,7 +29384,7 @@ paths: in: query schema: type: string - - *167 + - *71 - *17 - *19 responses: @@ -28848,7 +29428,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#list-runner-applications-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -28856,9 +29436,9 @@ paths: application/json: schema: type: array - items: *194 + items: *196 examples: - default: *195 + default: *197 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -28880,7 +29460,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#create-configuration-for-a-just-in-time-runner-for-an-organization parameters: - - *167 + - *71 requestBody: required: true content: @@ -28923,10 +29503,10 @@ paths: - no-gpu work_folder: _work responses: - '201': *196 + '201': *198 '404': *6 '422': *7 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -28954,7 +29534,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#create-a-registration-token-for-an-organization parameters: - - *167 + - *71 responses: '201': description: Response @@ -28962,7 +29542,7 @@ paths: application/json: schema: *63 examples: - default: *197 + default: *199 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -28990,7 +29570,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#create-a-remove-token-for-an-organization parameters: - - *167 + - *71 responses: '201': description: Response @@ -28998,7 +29578,7 @@ paths: application/json: schema: *63 examples: - default: *198 + default: *200 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -29020,7 +29600,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#get-a-self-hosted-runner-for-an-organization parameters: - - *167 + - *71 - *59 responses: '200': @@ -29029,7 +29609,7 @@ paths: application/json: schema: *60 examples: - default: *199 + default: *201 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -29050,7 +29630,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#delete-a-self-hosted-runner-from-an-organization parameters: - - *167 + - *71 - *59 responses: '204': @@ -29077,7 +29657,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#list-labels-for-a-self-hosted-runner-for-an-organization parameters: - - *167 + - *71 - *59 responses: '200': *65 @@ -29102,7 +29682,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#add-custom-labels-to-a-self-hosted-runner-for-an-organization parameters: - - *167 + - *71 - *59 requestBody: required: true @@ -29151,7 +29731,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#set-custom-labels-for-a-self-hosted-runner-for-an-organization parameters: - - *167 + - *71 - *59 requestBody: required: true @@ -29201,10 +29781,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#remove-all-custom-labels-from-a-self-hosted-runner-for-an-organization parameters: - - *167 + - *71 - *59 responses: - '200': *200 + '200': *202 '404': *6 x-github: githubCloudOnly: false @@ -29231,9 +29811,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#remove-a-custom-label-from-a-self-hosted-runner-for-an-organization parameters: - - *167 + - *71 - *59 - - *201 + - *203 responses: '200': *65 '404': *6 @@ -29260,7 +29840,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#list-organization-secrets parameters: - - *167 + - *71 - *17 - *19 responses: @@ -29278,7 +29858,7 @@ paths: type: integer secrets: type: array - items: &202 + items: &204 title: Actions Secret for an Organization description: Secrets for GitHub Actions for an organization. type: object @@ -29353,13 +29933,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#get-an-organization-public-key parameters: - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: &407 + schema: &409 title: ActionsPublicKey description: The public key used for setting Actions Secrets. type: object @@ -29394,7 +29974,7 @@ paths: - key_id - key examples: - default: &408 + default: &410 value: key_id: '012345678912345678' key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -29419,8 +29999,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#get-an-organization-secret parameters: - - *167 - - &203 + - *71 + - &205 name: secret_name description: The name of the secret. in: path @@ -29432,7 +30012,7 @@ paths: description: Response content: application/json: - schema: *202 + schema: *204 examples: default: value: @@ -29462,8 +30042,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#create-or-update-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 requestBody: required: true content: @@ -29520,7 +30100,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -29546,8 +30126,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#delete-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 responses: '204': description: Response @@ -29573,8 +30153,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#list-selected-repositories-for-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 - *19 - *17 responses: @@ -29592,9 +30172,9 @@ paths: type: integer repositories: type: array - items: *193 + items: *195 examples: - default: &207 + default: &209 value: total_count: 1 repositories: @@ -29686,8 +30266,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#set-selected-repositories-for-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 requestBody: required: true content: @@ -29739,8 +30319,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#add-selected-repository-to-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 - name: repository_id in: path required: true @@ -29773,8 +30353,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#remove-selected-repository-from-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 - name: repository_id in: path required: true @@ -29806,8 +30386,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#list-organization-variables parameters: - - *167 - - &392 + - *71 + - &394 name: per_page description: The number of results per page (max 30). For more information, see "[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api)." @@ -29831,7 +30411,7 @@ paths: type: integer variables: type: array - items: &205 + items: &207 title: Actions Variable for an Organization description: Organization variable for GitHub Actions. type: object @@ -29921,7 +30501,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#create-an-organization-variable parameters: - - *167 + - *71 requestBody: required: true content: @@ -29969,7 +30549,7 @@ paths: description: Response when creating a variable content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -29994,8 +30574,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#get-an-organization-variable parameters: - - *167 - - &206 + - *71 + - &208 name: name description: The name of the variable. in: path @@ -30007,7 +30587,7 @@ paths: description: Response content: application/json: - schema: *205 + schema: *207 examples: default: value: @@ -30037,8 +30617,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#update-an-organization-variable parameters: - - *167 - - *206 + - *71 + - *208 requestBody: required: true content: @@ -30100,8 +30680,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#delete-an-organization-variable parameters: - - *167 - - *206 + - *71 + - *208 responses: '204': description: Response @@ -30127,8 +30707,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#list-selected-repositories-for-an-organization-variable parameters: - - *167 - - *206 + - *71 + - *208 - *19 - *17 responses: @@ -30146,9 +30726,9 @@ paths: type: integer repositories: type: array - items: *193 + items: *195 examples: - default: *207 + default: *209 '409': description: Response when the visibility of the variable is not set to `selected` @@ -30174,8 +30754,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#set-selected-repositories-for-an-organization-variable parameters: - - *167 - - *206 + - *71 + - *208 requestBody: required: true content: @@ -30224,8 +30804,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#add-selected-repository-to-an-organization-variable parameters: - - *167 - - *206 + - *71 + - *208 - name: repository_id in: path required: true @@ -30259,8 +30839,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#remove-selected-repository-from-an-organization-variable parameters: - - *167 - - *206 + - *71 + - *208 - name: repository_id in: path required: true @@ -30291,7 +30871,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/announcement-banners/organizations#get-announcement-banner-for-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -30318,11 +30898,11 @@ paths: required: true content: application/json: - schema: *208 + schema: *210 examples: default: *69 parameters: - - *167 + - *71 responses: '200': description: Response @@ -30346,7 +30926,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/announcement-banners/organizations#remove-announcement-banner-from-organization parameters: - - *167 + - *71 responses: '204': description: Response @@ -30372,9 +30952,9 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/orgs#list-attestations-by-bulk-subject-digests parameters: - *17 - - *84 - - *85 - - *167 + - *87 + - *88 + - *71 requestBody: required: true content: @@ -30397,12 +30977,12 @@ paths: required: - subject_digests examples: - default: &755 + default: &757 value: subject_digests: - sha256:abc123 - sha512:def456 - withPredicateType: &756 + withPredicateType: &758 value: subject_digests: - sha256:abc123 @@ -30461,7 +31041,7 @@ paths: description: The cursor to the previous page. description: Information about the current page. examples: - default: &757 + default: &759 value: attestations_subject_digests: - sha256:abc: @@ -30570,7 +31150,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/attestations#delete-attestations-in-bulk parameters: - - *167 + - *71 requestBody: required: true content: @@ -30635,7 +31215,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/attestations#delete-attestations-by-subject-digest parameters: - - *167 + - *71 - name: subject_digest description: Subject Digest in: path @@ -30666,7 +31246,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/attestations#delete-attestations-by-id parameters: - - *167 + - *71 - name: attestation_id description: Attestation ID in: path @@ -30702,9 +31282,9 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/orgs#list-attestations parameters: - *17 - - *84 - - *85 - - *167 + - *87 + - *88 + - *71 - name: subject_digest description: The parameter should be set to the attestation's subject's SHA256 digest, in the form `sha256:HEX_DIGEST`. @@ -30755,7 +31335,7 @@ paths: bundle_url: type: string examples: - default: &421 + default: &423 value: attestations: - bundle: @@ -30873,7 +31453,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/orgs#get-the-audit-log-for-an-organization parameters: - - *167 + - *71 - name: phrase description: A search phrase. For more information, see [Searching the audit log](https://docs.github.com/enterprise-cloud@latest//github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization#searching-the-audit-log). @@ -30881,10 +31461,10 @@ paths: required: false schema: type: string - - *209 - - *210 - *211 - *212 + - *213 + - *214 - *17 responses: '200': @@ -30893,9 +31473,9 @@ paths: application/json: schema: type: array - items: *213 + items: *215 examples: - default: *214 + default: *216 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -30912,7 +31492,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/blocking#list-users-blocked-by-an-organization parameters: - - *167 + - *71 - *17 - *19 responses: @@ -30924,7 +31504,7 @@ paths: type: array items: *4 examples: - default: &287 + default: &289 value: - login: octocat id: 1 @@ -30962,8 +31542,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/blocking#check-if-a-user-is-blocked-by-an-organization parameters: - - *167 - - *215 + - *71 + - *217 responses: '204': description: If the user is blocked @@ -30988,8 +31568,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/blocking#block-a-user-from-an-organization parameters: - - *167 - - *215 + - *71 + - *217 responses: '204': description: Response @@ -31009,8 +31589,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/blocking#unblock-a-user-from-an-organization parameters: - - *167 - - *215 + - *71 + - *217 responses: '204': description: Response @@ -31036,17 +31616,17 @@ paths: category: orgs subcategory: bypass-requests parameters: - - *167 - - &222 + - *71 + - &224 name: repository_name description: The name of the repository to filter on. in: query schema: type: string - - *216 - - *217 - *218 - *219 + - *220 + - *221 - *17 - *19 responses: @@ -31056,11 +31636,11 @@ paths: application/json: schema: type: array - items: *220 + items: *222 examples: - default: *221 + default: *223 '404': *6 - '500': *83 + '500': *86 "/orgs/{org}/bypass-requests/secret-scanning": get: summary: List bypass requests for secret scanning for an org @@ -31081,12 +31661,12 @@ paths: category: secret-scanning subcategory: delegated-bypass parameters: - - *167 - - *222 - - *216 - - *217 + - *71 + - *224 - *218 - *219 + - *220 + - *221 - *17 - *19 responses: @@ -31096,7 +31676,7 @@ paths: application/json: schema: type: array - items: &438 + items: &440 title: Secret scanning bypass request description: A bypass request made by a user asking to be exempted from push protection in this repository. @@ -31214,7 +31794,7 @@ paths: - array - 'null' description: The responses to the bypass request. - items: *223 + items: *225 url: type: string format: uri @@ -31227,7 +31807,7 @@ paths: examples: - https://github.com/octo-org/smile/exemptions/1 examples: - default: &439 + default: &441 value: - id: 21 number: 42 @@ -31294,7 +31874,7 @@ paths: url: https://api.github.com/repos/octo-org/smile/bypass-requests/secret-scanning/2 html_url: https://github.com/octo-org/smile/exemptions/2 '404': *6 - '500': *83 + '500': *86 "/orgs/{org}/campaigns": get: summary: List campaigns for an organization @@ -31311,15 +31891,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/campaigns/campaigns#list-campaigns-for-an-organization parameters: - - *167 + - *71 - *19 - *17 - - *86 + - *89 - name: state description: If specified, only campaigns with this state will be returned. in: query required: false - schema: &225 + schema: &227 title: Campaign state description: Indicates whether a campaign is open or closed type: string @@ -31345,7 +31925,7 @@ paths: application/json: schema: type: array - items: &226 + items: &228 title: Campaign summary description: The campaign metadata and alert stats. type: object @@ -31376,7 +31956,7 @@ paths: team_managers: description: The campaign team managers type: array - items: *224 + items: *226 published_at: description: The date and time the campaign was published, in ISO 8601 format':' YYYY-MM-DDTHH:MM:SSZ. @@ -31395,7 +31975,7 @@ paths: - string - 'null' format: date-time - state: *225 + state: *227 contact_link: description: The contact link of the campaign. type: @@ -31493,7 +32073,7 @@ paths: headers: Link: *38 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -31517,7 +32097,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/campaigns/campaigns#create-a-campaign-for-an-organization parameters: - - *167 + - *71 requestBody: required: true content: @@ -31612,9 +32192,9 @@ paths: description: Response content: application/json: - schema: *226 + schema: *228 examples: - default: &227 + default: &229 value: number: 3 created_at: '2024-02-14T12:29:18Z' @@ -31663,7 +32243,7 @@ paths: schema: *3 '429': description: Too Many Requests - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -31685,7 +32265,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/campaigns/campaigns#get-a-campaign-for-an-organization parameters: - - *167 + - *71 - name: campaign_number description: The campaign number. in: path @@ -31697,16 +32277,16 @@ paths: description: Response content: application/json: - schema: *226 + schema: *228 examples: - default: *227 + default: *229 '404': *6 '422': description: Unprocessable Entity content: application/json: schema: *3 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -31727,7 +32307,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/campaigns/campaigns#update-a-campaign parameters: - - *167 + - *71 - name: campaign_number description: The campaign number. in: path @@ -31777,7 +32357,7 @@ paths: - string - 'null' format: uri - state: *225 + state: *227 examples: default: value: @@ -31787,9 +32367,9 @@ paths: description: Response content: application/json: - schema: *226 + schema: *228 examples: - default: *227 + default: *229 '400': description: Bad Request content: @@ -31801,7 +32381,7 @@ paths: content: application/json: schema: *3 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -31822,7 +32402,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/campaigns/campaigns#delete-a-campaign-for-an-organization parameters: - - *167 + - *71 - name: campaign_number description: The campaign number. in: path @@ -31833,7 +32413,7 @@ paths: '204': description: Deletion successful '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -31855,20 +32435,20 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#list-code-scanning-alerts-for-an-organization parameters: - - *167 - - *228 - - *229 - - *84 - - *85 + - *71 + - *230 + - *231 + - *87 + - *88 - *19 - *17 - - *86 + - *89 - name: state description: If specified, only code scanning alerts with this state will be returned. in: query required: false - schema: *230 + schema: *232 - name: sort description: The property by which to sort the results. in: query @@ -31884,7 +32464,7 @@ paths: be returned. in: query required: false - schema: &449 + schema: &451 type: string description: Severity of a code scanning alert. enum: @@ -31902,13 +32482,13 @@ paths: application/json: schema: type: array - items: *231 + items: *233 examples: - default: *232 + default: *234 headers: Link: *38 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -31930,7 +32510,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#get-code-security-configurations-for-an-organization parameters: - - *167 + - *71 - name: target_type in: query description: The target type of the code security configuration @@ -31949,8 +32529,8 @@ paths: schema: type: integer default: 30 - - *84 - - *85 + - *87 + - *88 responses: '200': description: Response @@ -31958,7 +32538,7 @@ paths: application/json: schema: type: array - items: *90 + items: *93 examples: default: value: @@ -32041,7 +32621,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#create-a-code-security-configuration parameters: - - *167 + - *71 requestBody: required: true content: @@ -32118,7 +32698,7 @@ paths: - disabled - not_set default: disabled - code_scanning_default_setup_options: *93 + code_scanning_default_setup_options: *96 code_scanning_delegated_alert_dismissal: type: string description: The enablement status of code scanning delegated alert @@ -32243,9 +32823,9 @@ paths: description: Successfully created code security configuration content: application/json: - schema: *90 + schema: *93 examples: - default: *233 + default: *235 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -32267,15 +32847,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#get-default-code-security-configurations parameters: - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: *234 + schema: *236 examples: - default: *235 + default: *237 '304': *35 '403': *27 '404': *6 @@ -32301,7 +32881,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#detach-configurations-from-repositories parameters: - - *167 + - *71 requestBody: required: true content: @@ -32324,11 +32904,11 @@ paths: - 32 - 91 responses: - '204': *116 + '204': *119 '400': *14 '403': *27 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -32350,16 +32930,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#get-a-code-security-configuration parameters: - - *167 - - *92 + - *71 + - *95 responses: '200': description: Response content: application/json: - schema: *90 + schema: *93 examples: - default: *233 + default: *235 '304': *35 '403': *27 '404': *6 @@ -32383,8 +32963,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#update-a-code-security-configuration parameters: - - *167 - - *92 + - *71 + - *95 requestBody: required: true content: @@ -32454,7 +33034,7 @@ paths: - enabled - disabled - not_set - code_scanning_default_setup_options: *93 + code_scanning_default_setup_options: *96 code_scanning_delegated_alert_dismissal: type: string description: The enablement status of code scanning delegated alert @@ -32565,7 +33145,7 @@ paths: description: Response when a configuration is updated content: application/json: - schema: *90 + schema: *93 examples: default: value: @@ -32622,14 +33202,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#delete-a-code-security-configuration parameters: - - *167 - - *92 + - *71 + - *95 responses: - '204': *116 + '204': *119 '400': *14 '403': *27 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -32653,8 +33233,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#attach-a-configuration-to-repositories parameters: - - *167 - - *92 + - *71 + - *95 requestBody: required: true content: @@ -32717,8 +33297,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#set-a-code-security-configuration-as-a-default-for-an-organization parameters: - - *167 - - *92 + - *71 + - *95 requestBody: required: true content: @@ -32758,12 +33338,12 @@ paths: - none - private_and_internal - public - configuration: *90 + configuration: *93 examples: default: value: default_for_new_repos: all - configuration: *233 + configuration: *235 '403': *27 '404': *6 x-github: @@ -32787,8 +33367,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#get-repositories-associated-with-a-code-security-configuration parameters: - - *167 - - *92 + - *71 + - *95 - name: per_page description: The number of results per page (max 100). For more information, see "[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api)." @@ -32797,8 +33377,8 @@ paths: schema: type: integer default: 30 - - *84 - - *85 + - *87 + - *88 - name: status description: |- A comma-separated list of statuses. If specified, only repositories with these attachment statuses will be returned. @@ -32816,13 +33396,13 @@ paths: application/json: schema: type: array - items: *236 + items: *238 examples: default: summary: Example of code security configuration repositories value: - status: attached - repository: *237 + repository: *239 '403': *27 '404': *6 x-github: @@ -32846,7 +33426,7 @@ paths: parameters: - *17 - *19 - - *167 + - *71 responses: '200': description: Response @@ -32862,7 +33442,7 @@ paths: type: integer codespaces: type: array - items: &288 + items: &290 type: object title: Codespace description: A codespace. @@ -32893,11 +33473,11 @@ paths: - 26a7c758-7299-4a73-b978-5a92a7ae98a0 owner: *4 billable_owner: *4 - repository: *193 + repository: *195 machine: anyOf: - type: 'null' - - &478 + - &480 type: object title: Codespace machine description: A description of the machine powering a codespace. @@ -33184,7 +33764,7 @@ paths: - pulls_url - recent_folders examples: - default: &289 + default: &291 value: total_count: 3 codespaces: @@ -33594,7 +34174,7 @@ paths: stop_url: https://api.github.com/user/codespaces/monalisa-octocat-hello-world-f8adfad99a/stop recent_folders: [] '304': *35 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -33616,7 +34196,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organizations#manage-access-control-for-organization-codespaces parameters: - - *167 + - *71 deprecated: true requestBody: required: true @@ -33660,7 +34240,7 @@ paths: description: Users are neither members nor collaborators of this organization. '404': *6 '422': *15 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -33683,7 +34263,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organizations#add-users-to-codespaces-access-for-an-organization parameters: - - *167 + - *71 deprecated: true requestBody: required: true @@ -33715,7 +34295,7 @@ paths: description: Users are neither members nor collaborators of this organization. '404': *6 '422': *15 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -33738,7 +34318,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organizations#remove-users-from-codespaces-access-for-an-organization deprecated: true parameters: - - *167 + - *71 requestBody: required: true content: @@ -33769,7 +34349,7 @@ paths: description: Users are neither members nor collaborators of this organization. '404': *6 '422': *15 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -33790,7 +34370,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#list-organization-secrets parameters: - - *167 + - *71 - *17 - *19 responses: @@ -33808,7 +34388,7 @@ paths: type: integer secrets: type: array - items: &238 + items: &240 title: Codespaces Secret description: Secrets for a GitHub Codespace. type: object @@ -33849,7 +34429,7 @@ paths: - updated_at - visibility examples: - default: &479 + default: &481 value: total_count: 2 secrets: @@ -33881,13 +34461,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#get-an-organization-public-key parameters: - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: &480 + schema: &482 title: CodespacesPublicKey description: The public key used for setting Codespaces secrets. type: object @@ -33922,7 +34502,7 @@ paths: - key_id - key examples: - default: &481 + default: &483 value: key_id: '012345678912345678' key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -33945,16 +34525,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#get-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 responses: '200': description: Response content: application/json: - schema: *238 + schema: *240 examples: - default: &483 + default: &485 value: name: GH_TOKEN created_at: '2019-08-10T14:59:22Z' @@ -33981,8 +34561,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#create-or-update-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 requestBody: required: true content: @@ -34037,7 +34617,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -34063,8 +34643,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#delete-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 responses: '204': description: Response @@ -34089,8 +34669,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#list-selected-repositories-for-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 - *19 - *17 responses: @@ -34108,9 +34688,9 @@ paths: type: integer repositories: type: array - items: *193 + items: *195 examples: - default: *207 + default: *209 '404': *6 x-github: githubCloudOnly: false @@ -34132,8 +34712,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#set-selected-repositories-for-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 requestBody: required: true content: @@ -34183,8 +34763,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#add-selected-repository-to-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 - name: repository_id in: path required: true @@ -34217,8 +34797,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#remove-selected-repository-from-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 - name: repository_id in: path required: true @@ -34257,7 +34837,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/copilot/copilot-user-management#get-copilot-seat-information-and-settings-for-an-organization parameters: - - *167 + - *71 responses: '200': description: OK @@ -34366,7 +34946,7 @@ paths: cli: enabled public_code_suggestions: block plan_type: business - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -34398,7 +34978,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/copilot/copilot-user-management#list-all-copilot-seat-assignments-for-an-organization parameters: - - *167 + - *71 - *19 - name: per_page description: The number of results per page (max 100). For more information, @@ -34421,12 +35001,12 @@ paths: currently being billed. seats: type: array - items: *107 + items: *110 examples: - default: *108 + default: *111 headers: Link: *38 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -34459,7 +35039,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/copilot/copilot-user-management#add-teams-to-the-copilot-subscription-for-an-organization parameters: - - *167 + - *71 requestBody: content: application/json: @@ -34501,7 +35081,7 @@ paths: default: value: seats_created: 5 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -34537,7 +35117,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/copilot/copilot-user-management#remove-teams-from-the-copilot-subscription-for-an-organization parameters: - - *167 + - *71 requestBody: content: application/json: @@ -34579,7 +35159,7 @@ paths: default: value: seats_cancelled: 5 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -34617,7 +35197,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/copilot/copilot-user-management#add-users-to-the-copilot-subscription-for-an-organization parameters: - - *167 + - *71 requestBody: content: application/json: @@ -34658,7 +35238,7 @@ paths: default: value: seats_created: 5 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -34694,7 +35274,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/copilot/copilot-user-management#remove-users-from-the-copilot-subscription-for-an-organization parameters: - - *167 + - *71 requestBody: content: application/json: @@ -34736,7 +35316,7 @@ paths: default: value: seats_cancelled: 5 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -34775,7 +35355,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/copilot/copilot-metrics#get-copilot-metrics-for-an-organization parameters: - - *167 + - *71 - name: since description: Show usage metrics since this date. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format (`YYYY-MM-DDTHH:MM:SSZ`). @@ -34807,13 +35387,13 @@ paths: application/json: schema: type: array - items: *134 + items: *137 examples: - default: *135 - '500': *83 + default: *138 + '500': *86 '403': *27 '404': *6 - '422': *136 + '422': *139 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -34835,7 +35415,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/orgs#list-saml-sso-authorizations-for-an-organization parameters: - - *167 + - *71 - *17 - name: page description: Page token @@ -34994,7 +35574,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/orgs#remove-a-saml-sso-authorization-for-an-organization parameters: - - *167 + - *71 - name: credential_id in: path required: true @@ -35025,7 +35605,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-roles#list-custom-repository-roles-in-an-organization parameters: - - *167 + - *71 responses: '200': description: Response - list of custom role names @@ -35041,7 +35621,7 @@ paths: - 3 custom_roles: type: array - items: *239 + items: *241 examples: default: value: @@ -35128,12 +35708,12 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-roles#create-a-custom-repository-role parameters: - - *167 + - *71 requestBody: required: true content: application/json: - schema: &242 + schema: &244 type: object properties: name: @@ -35175,9 +35755,9 @@ paths: description: Response content: application/json: - schema: *239 + schema: *241 examples: - default: *240 + default: *242 '422': *15 '404': *6 x-github: @@ -35201,8 +35781,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-roles#get-a-custom-repository-role parameters: - - *167 - - &241 + - *71 + - &243 name: role_id description: The unique identifier of the role. in: path @@ -35214,9 +35794,9 @@ paths: description: Response content: application/json: - schema: *239 + schema: *241 examples: - default: *240 + default: *242 '404': *6 x-github: githubCloudOnly: true @@ -35238,13 +35818,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-roles#update-a-custom-repository-role parameters: - - *167 - - *241 + - *71 + - *243 requestBody: required: true content: application/json: - schema: &243 + schema: &245 type: object properties: name: @@ -35283,9 +35863,9 @@ paths: description: Response content: application/json: - schema: *239 + schema: *241 examples: - default: *240 + default: *242 '422': *15 '404': *6 x-github: @@ -35309,8 +35889,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-roles#delete-a-custom-repository-role parameters: - - *167 - - *241 + - *71 + - *243 responses: '204': description: Response @@ -35338,12 +35918,12 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-roles#closing-down---create-a-custom-role parameters: - - *167 + - *71 requestBody: required: true content: application/json: - schema: *242 + schema: *244 examples: default: value: @@ -35357,9 +35937,9 @@ paths: description: Response content: application/json: - schema: *239 + schema: *241 examples: - default: *240 + default: *242 '422': *15 '404': *6 x-github: @@ -35389,16 +35969,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-roles#closing-down---get-a-custom-role parameters: - - *167 - - *241 + - *71 + - *243 responses: '200': description: Response content: application/json: - schema: *239 + schema: *241 examples: - default: *240 + default: *242 '404': *6 x-github: githubCloudOnly: true @@ -35426,13 +36006,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-roles#closing-down---update-a-custom-role parameters: - - *167 - - *241 + - *71 + - *243 requestBody: required: true content: application/json: - schema: *243 + schema: *245 examples: default: value: @@ -35447,9 +36027,9 @@ paths: description: Response content: application/json: - schema: *239 + schema: *241 examples: - default: *240 + default: *242 '422': *15 '404': *6 x-github: @@ -35479,8 +36059,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-roles#closing-down---delete-a-custom-role parameters: - - *167 - - *241 + - *71 + - *243 responses: '204': description: Response @@ -35508,20 +36088,20 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/alerts#list-dependabot-alerts-for-an-organization parameters: - - *167 - - *244 - - *245 + - *71 - *246 - *247 - *248 - *249 - *250 - *251 - - *86 - - *84 - - *85 - *252 - *253 + - *89 + - *87 + - *88 + - *254 + - *255 - *17 responses: '200': @@ -35530,9 +36110,9 @@ paths: application/json: schema: type: array - items: *254 + items: *256 examples: - default: *255 + default: *257 '304': *35 '400': *14 '403': *27 @@ -35558,7 +36138,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#list-organization-secrets parameters: - - *167 + - *71 - *17 - *19 responses: @@ -35576,7 +36156,7 @@ paths: type: integer secrets: type: array - items: &256 + items: &258 title: Dependabot Secret for an Organization description: Secrets for GitHub Dependabot for an organization. type: object @@ -35649,13 +36229,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#get-an-organization-public-key parameters: - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: &506 + schema: &508 title: DependabotPublicKey description: The public key used for setting Dependabot Secrets. type: object @@ -35674,7 +36254,7 @@ paths: - key_id - key examples: - default: &507 + default: &509 value: key_id: '012345678912345678' key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -35697,14 +36277,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#get-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 responses: '200': description: Response content: application/json: - schema: *256 + schema: *258 examples: default: value: @@ -35732,8 +36312,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#create-or-update-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 requestBody: required: true content: @@ -35788,7 +36368,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -35812,8 +36392,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#delete-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 responses: '204': description: Response @@ -35837,8 +36417,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#list-selected-repositories-for-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 - *19 - *17 responses: @@ -35856,9 +36436,9 @@ paths: type: integer repositories: type: array - items: *193 + items: *195 examples: - default: *207 + default: *209 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -35879,8 +36459,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#set-selected-repositories-for-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 requestBody: required: true content: @@ -35930,8 +36510,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#add-selected-repository-to-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 - name: repository_id in: path required: true @@ -35962,8 +36542,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#remove-selected-repository-from-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 - name: repository_id in: path required: true @@ -35999,8 +36579,8 @@ paths: category: code-scanning subcategory: alert-dismissal-requests parameters: - - *167 - - &515 + - *71 + - &517 name: reviewer description: Filter alert dismissal requests by the handle of the GitHub user who reviewed the dismissal request. @@ -36008,7 +36588,7 @@ paths: required: false schema: type: string - - &516 + - &518 name: requester description: Filter alert dismissal requests by the handle of the GitHub user who requested the dismissal. @@ -36016,7 +36596,7 @@ paths: required: false schema: type: string - - &517 + - &519 name: time_period description: |- The time period to filter by. @@ -36032,7 +36612,7 @@ paths: - week - month default: month - - &518 + - &520 name: request_status description: Filter alert dismissal requests by status. When specified, only requests with this status will be returned. @@ -36047,7 +36627,7 @@ paths: - denied - all default: all - - *222 + - *224 - *17 - *19 responses: @@ -36057,7 +36637,7 @@ paths: application/json: schema: type: array - items: &519 + items: &521 title: Code scanning alert dismissal request description: Alert dismisal request made by a user asking to dismiss a code scanning alert. @@ -36220,7 +36800,7 @@ paths: examples: - https://github.com/octo-org/smile/code-scanning/alerts/1 examples: - default: &520 + default: &522 value: - id: 21 number: 42 @@ -36285,7 +36865,7 @@ paths: '404': *6 '403': *27 '422': *15 - '500': *83 + '500': *86 "/orgs/{org}/dismissal-requests/secret-scanning": get: summary: List alert dismissal requests for secret scanning for an org @@ -36306,12 +36886,12 @@ paths: category: secret-scanning subcategory: alert-dismissal-requests parameters: - - *167 - - *222 - - *216 - - *217 + - *71 + - *224 - *218 - - &521 + - *219 + - *220 + - &523 name: request_status description: The status of the dismissal request to filter on. When specified, only requests with this status will be returned. @@ -36337,7 +36917,7 @@ paths: application/json: schema: type: array - items: &522 + items: &524 title: Secret scanning alert dismissal request description: A dismissal request made by a user asking to close a secret scanning alert in this repository. @@ -36451,7 +37031,7 @@ paths: - array - 'null' description: The responses to the dismissal request. - items: *223 + items: *225 url: type: string format: uri @@ -36464,7 +37044,7 @@ paths: examples: - https://github.com/octo-org/smile/security/secret-scanning/17 examples: - default: &523 + default: &525 value: - id: 21 number: 42 @@ -36529,7 +37109,7 @@ paths: html_url: https://github.com/octo-org/smile/security/secret-scanning/19 '404': *6 '403': *27 - '500': *83 + '500': *86 "/orgs/{org}/docker/conflicts": get: summary: Get list of conflicting packages during Docker migration for organization @@ -36544,7 +37124,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#get-list-of-conflicting-packages-during-docker-migration-for-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -36552,7 +37132,7 @@ paths: application/json: schema: type: array - items: &299 + items: &301 title: Package description: A software package type: object @@ -36605,7 +37185,7 @@ paths: repository: anyOf: - type: 'null' - - *193 + - *195 created_at: type: string format: date-time @@ -36623,7 +37203,7 @@ paths: - created_at - updated_at examples: - default: &300 + default: &302 value: - id: 197 name: hello_docker @@ -36701,7 +37281,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/events#list-public-organization-events parameters: - - *167 + - *71 - *17 - *19 responses: @@ -36711,7 +37291,7 @@ paths: application/json: schema: type: array - items: *162 + items: *165 examples: 200-response: value: @@ -36781,7 +37361,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/external-groups#get-an-external-group parameters: - - *167 + - *71 - name: group_id description: The unique identifier of the group. in: path @@ -36807,7 +37387,7 @@ paths: description: Response content: application/json: - schema: &363 + schema: &365 title: ExternalGroup description: Information about an external group's usage and its members type: object @@ -36897,7 +37477,7 @@ paths: member_name: Octo Lisa member_email: octo_lisa@github.com examples: - default: &364 + default: &366 value: group_id: '123' group_name: Octocat admins @@ -36935,7 +37515,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/external-groups#list-external-groups-in-an-organization parameters: - - *167 + - *71 - *17 - name: page description: Page token @@ -36952,7 +37532,7 @@ paths: description: Response content: application/json: - schema: &361 + schema: &363 title: ExternalGroups description: A list of external groups available to be connected to a team @@ -36992,7 +37572,7 @@ paths: group_name: group-azuread-test2 updated_at: 2021-06-03 22:27:15:000 -700 examples: - default: &362 + default: &364 value: groups: - group_id: '123' @@ -37026,7 +37606,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#list-failed-organization-invitations parameters: - - *167 + - *71 - *17 - *19 responses: @@ -37036,7 +37616,7 @@ paths: application/json: schema: type: array - items: &279 + items: &281 title: Organization Invitation description: Organization Invitation type: object @@ -37090,7 +37670,7 @@ paths: - invitation_teams_url - node_id examples: - default: &280 + default: &282 value: - id: 1 login: monalisa @@ -37149,7 +37729,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-roles#closing-down---list-fine-grained-permissions-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -37157,7 +37737,7 @@ paths: application/json: schema: type: array - items: &319 + items: &321 title: Repository Fine-Grained Permission description: A fine-grained permission that protects repository resources. @@ -37171,7 +37751,7 @@ paths: - name - description examples: - default: &320 + default: &322 value: - name: add_assignee description: Assign or remove a user @@ -37202,7 +37782,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#list-organization-webhooks parameters: - - *167 + - *71 - *17 - *19 responses: @@ -37212,7 +37792,7 @@ paths: application/json: schema: type: array - items: &257 + items: &259 title: Org Hook description: Org Hook type: object @@ -37333,7 +37913,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#create-an-organization-webhook parameters: - - *167 + - *71 requestBody: required: true content: @@ -37395,9 +37975,9 @@ paths: description: Response content: application/json: - schema: *257 + schema: *259 examples: - default: &258 + default: &260 value: id: 1 url: https://api.github.com/orgs/octocat/hooks/1 @@ -37441,8 +38021,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#get-an-organization-webhook parameters: - - *167 - - &259 + - *71 + - &261 name: hook_id description: The unique identifier of the hook. You can find this value in the `X-GitHub-Hook-ID` header of a webhook delivery. @@ -37455,9 +38035,9 @@ paths: description: Response content: application/json: - schema: *257 + schema: *259 examples: - default: *258 + default: *260 '404': *6 x-github: githubCloudOnly: false @@ -37478,8 +38058,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#update-an-organization-webhook parameters: - - *167 - - *259 + - *71 + - *261 requestBody: required: false content: @@ -37525,7 +38105,7 @@ paths: description: Response content: application/json: - schema: *257 + schema: *259 examples: default: value: @@ -37564,8 +38144,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#delete-an-organization-webhook parameters: - - *167 - - *259 + - *71 + - *261 responses: '204': description: Response @@ -37590,8 +38170,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#get-a-webhook-configuration-for-an-organization parameters: - - *167 - - *259 + - *71 + - *261 responses: '200': description: Response @@ -37619,8 +38199,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#update-a-webhook-configuration-for-an-organization parameters: - - *167 - - *259 + - *71 + - *261 requestBody: required: false content: @@ -37668,10 +38248,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#list-deliveries-for-an-organization-webhook parameters: - - *167 - - *259 + - *71 + - *261 - *17 - - *260 + - *262 responses: '200': description: Response @@ -37679,9 +38259,9 @@ paths: application/json: schema: type: array - items: *261 + items: *263 examples: - default: *262 + default: *264 '400': *14 '422': *15 x-github: @@ -37704,17 +38284,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#get-a-webhook-delivery-for-an-organization-webhook parameters: - - *167 - - *259 + - *71 + - *261 - *16 responses: '200': description: Response content: application/json: - schema: *263 + schema: *265 examples: - default: *264 + default: *266 '400': *14 '422': *15 x-github: @@ -37737,8 +38317,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#redeliver-a-delivery-for-an-organization-webhook parameters: - - *167 - - *259 + - *71 + - *261 - *16 responses: '202': *37 @@ -37764,8 +38344,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#ping-an-organization-webhook parameters: - - *167 - - *259 + - *71 + - *261 responses: '204': description: Response @@ -37787,8 +38367,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-route-stats-by-actor parameters: - - *167 - - &269 + - *71 + - &271 name: actor_type in: path description: The type of the actor @@ -37801,14 +38381,14 @@ paths: - fine_grained_pat - oauth_app - github_app_user_to_server - - &270 + - &272 name: actor_id in: path description: The ID of the actor required: true schema: type: integer - - &265 + - &267 name: min_timestamp description: 'The minimum timestamp to query for stats. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`.' @@ -37816,7 +38396,7 @@ paths: required: true schema: type: string - - &266 + - &268 name: max_timestamp description: 'The maximum timestamp to query for stats. Defaults to the time 30 days ago. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) @@ -37827,7 +38407,7 @@ paths: type: string - *19 - *17 - - *86 + - *89 - name: sort description: The property to sort the results by. in: query @@ -37910,13 +38490,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-subject-stats parameters: - - *167 - - *265 - - *266 + - *71 + - *267 + - *268 - *19 - *17 - - *86 - - &275 + - *89 + - &277 name: sort description: The property to sort the results by. in: query @@ -37995,15 +38575,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-summary-stats parameters: - - *167 - - *265 - - *266 + - *71 + - *267 + - *268 responses: '200': description: Response content: application/json: - schema: &267 + schema: &269 title: Summary Stats description: API Insights usage summary stats for an organization type: object @@ -38019,7 +38599,7 @@ paths: type: integer format: int64 examples: - default: &268 + default: &270 value: total_request_count: 34225 rate_limited_request_count: 23 @@ -38039,24 +38619,24 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-summary-stats-by-user parameters: - - *167 - - &271 + - *71 + - &273 name: user_id in: path description: The ID of the user to query for stats required: true schema: type: string - - *265 - - *266 + - *267 + - *268 responses: '200': description: Response content: application/json: - schema: *267 + schema: *269 examples: - default: *268 + default: *270 x-github: enabledForGitHubApps: true category: orgs @@ -38074,19 +38654,19 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-summary-stats-by-actor parameters: - - *167 - - *265 - - *266 - - *269 - - *270 + - *71 + - *267 + - *268 + - *271 + - *272 responses: '200': description: Response content: application/json: - schema: *267 + schema: *269 examples: - default: *268 + default: *270 x-github: enabledForGitHubApps: true category: orgs @@ -38103,10 +38683,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-time-stats parameters: - - *167 - - *265 - - *266 - - &272 + - *71 + - *267 + - *268 + - &274 name: timestamp_increment description: The increment of time used to breakdown the query results (5m, 10m, 1h, etc.) @@ -38119,7 +38699,7 @@ paths: description: Response content: application/json: - schema: &273 + schema: &275 title: Time Stats description: API Insights usage time stats for an organization type: array @@ -38135,7 +38715,7 @@ paths: type: integer format: int64 examples: - default: &274 + default: &276 value: - timestamp: '2024-09-11T15:00:00Z' total_request_count: 34225 @@ -38171,19 +38751,19 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-time-stats-by-user parameters: - - *167 - - *271 - - *265 - - *266 - - *272 + - *71 + - *273 + - *267 + - *268 + - *274 responses: '200': description: Response content: application/json: - schema: *273 + schema: *275 examples: - default: *274 + default: *276 x-github: enabledForGitHubApps: true category: orgs @@ -38200,20 +38780,20 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-time-stats-by-actor parameters: - - *167 - - *269 - - *270 - - *265 - - *266 + - *71 + - *271 - *272 + - *267 + - *268 + - *274 responses: '200': description: Response content: application/json: - schema: *273 + schema: *275 examples: - default: *274 + default: *276 x-github: enabledForGitHubApps: true category: orgs @@ -38230,14 +38810,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-user-stats parameters: - - *167 - - *271 - - *265 - - *266 + - *71 + - *273 + - *267 + - *268 - *19 - *17 - - *86 - - *275 + - *89 + - *277 - name: actor_name_substring in: query description: Providing a substring will filter results where the actor name @@ -38313,7 +38893,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#get-an-organization-installation-for-the-authenticated-app parameters: - - *167 + - *71 responses: '200': description: Response @@ -38321,7 +38901,7 @@ paths: application/json: schema: *20 examples: - default: &554 + default: &556 value: id: 1 account: @@ -38390,7 +38970,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/orgs#list-app-installations-for-an-organization parameters: - - *167 + - *71 - *17 - *19 responses: @@ -38479,7 +39059,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/interactions/orgs#get-interaction-restrictions-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -38487,12 +39067,12 @@ paths: application/json: schema: anyOf: - - &277 + - &279 title: Interaction Limits description: Interaction limit settings. type: object properties: - limit: &276 + limit: &278 type: string description: The type of GitHub user that can comment, open issues, or create pull requests while the interaction limit @@ -38520,7 +39100,7 @@ paths: properties: {} additionalProperties: false examples: - default: &278 + default: &280 value: limit: collaborators_only origin: organization @@ -38544,18 +39124,18 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/interactions/orgs#set-interaction-restrictions-for-an-organization parameters: - - *167 + - *71 requestBody: required: true content: application/json: - schema: &555 + schema: &557 title: Interaction Restrictions description: Limit interactions to a specific type of user for a specified duration type: object properties: - limit: *276 + limit: *278 expiry: type: string description: 'The duration of the interaction restriction. Default: @@ -38580,9 +39160,9 @@ paths: description: Response content: application/json: - schema: *277 + schema: *279 examples: - default: *278 + default: *280 '422': *15 x-github: githubCloudOnly: false @@ -38600,7 +39180,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/interactions/orgs#remove-interaction-restrictions-for-an-organization parameters: - - *167 + - *71 responses: '204': description: Response @@ -38626,7 +39206,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#list-pending-organization-invitations parameters: - - *167 + - *71 - *17 - *19 - name: role @@ -38660,9 +39240,9 @@ paths: application/json: schema: type: array - items: *279 + items: *281 examples: - default: *280 + default: *282 headers: Link: *38 '404': *6 @@ -38686,7 +39266,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#create-an-organization-invitation parameters: - - *167 + - *71 requestBody: required: false content: @@ -38740,7 +39320,7 @@ paths: description: Response content: application/json: - schema: *279 + schema: *281 examples: default: value: @@ -38796,8 +39376,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#cancel-an-organization-invitation parameters: - - *167 - - &281 + - *71 + - &283 name: invitation_id description: The unique identifier of the invitation. in: path @@ -38830,8 +39410,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#list-organization-invitation-teams parameters: - - *167 - - *281 + - *71 + - *283 - *17 - *19 responses: @@ -38841,9 +39421,9 @@ paths: application/json: schema: type: array - items: *224 + items: *226 examples: - default: &298 + default: &300 value: - id: 1 node_id: MDQ6VGVhbTE= @@ -38878,7 +39458,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/issue-types#list-issue-types-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -38886,7 +39466,7 @@ paths: application/json: schema: type: array - items: *282 + items: *284 examples: default: value: @@ -38924,7 +39504,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/issue-types#create-issue-type-for-an-organization parameters: - - *167 + - *71 requestBody: required: true content: @@ -38974,9 +39554,9 @@ paths: description: Response content: application/json: - schema: *282 + schema: *284 examples: - default: &283 + default: &285 value: id: 410 node_id: IT_kwDNAd3NAZo @@ -39008,8 +39588,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/issue-types#update-issue-type-for-an-organization parameters: - - *167 - - &284 + - *71 + - &286 name: issue_type_id description: The unique identifier of the issue type. in: path @@ -39065,9 +39645,9 @@ paths: description: Response content: application/json: - schema: *282 + schema: *284 examples: - default: *283 + default: *285 '404': *6 '422': *7 x-github: @@ -39091,8 +39671,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/issue-types#delete-issue-type-for-an-organization parameters: - - *167 - - *284 + - *71 + - *286 responses: '204': description: Response @@ -39125,7 +39705,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#list-organization-issues-assigned-to-the-authenticated-user parameters: - - *167 + - *71 - name: filter description: Indicates which sorts of issues to return. `assigned` means issues assigned to you. `created` means issues created by you. `mentioned` means @@ -39155,7 +39735,7 @@ paths: - closed - all default: open - - *285 + - *287 - name: type description: Can be the name of an issue type. in: query @@ -39173,8 +39753,8 @@ paths: - updated - comments default: created - - *86 - - *141 + - *89 + - *144 - *17 - *19 responses: @@ -39184,9 +39764,9 @@ paths: application/json: schema: type: array - items: *151 + items: *154 examples: - default: *286 + default: *288 headers: Link: *38 '404': *6 @@ -39208,7 +39788,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#list-organization-members parameters: - - *167 + - *71 - name: filter description: Filter members returned in the list. `2fa_disabled` means that only members without [two-factor authentication](https://github.com/blog/1614-two-factor-authentication) @@ -39246,7 +39826,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: *38 '422': *15 @@ -39266,8 +39846,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#check-organization-membership-for-a-user parameters: - - *167 - - *215 + - *71 + - *217 responses: '204': description: Response if requester is an organization member and user is @@ -39289,8 +39869,11 @@ paths: subcategory: members delete: summary: Remove an organization member - description: Removing a user from this list will remove them from all teams - and they will no longer have any access to the organization's repositories. + description: |- + Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories. + + > [!NOTE] + > If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team. tags: - orgs operationId: orgs/remove-member @@ -39298,8 +39881,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#remove-an-organization-member parameters: - - *167 - - *215 + - *71 + - *217 responses: '204': description: Response @@ -39325,8 +39908,8 @@ paths: parameters: - *17 - *19 - - *167 - - *215 + - *71 + - *217 responses: '200': description: Response @@ -39342,11 +39925,11 @@ paths: type: integer codespaces: type: array - items: *288 + items: *290 examples: - default: *289 + default: *291 '304': *35 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -39369,9 +39952,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organizations#delete-a-codespace-from-the-organization parameters: - - *167 - - *215 - - &290 + - *71 + - *217 + - &292 name: codespace_name in: path required: true @@ -39381,7 +39964,7 @@ paths: responses: '202': *37 '304': *35 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -39404,17 +39987,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organizations#stop-a-codespace-for-an-organization-user parameters: - - *167 - - *215 - - *290 + - *71 + - *217 + - *292 responses: '200': description: Response content: application/json: - schema: *288 + schema: *290 examples: - default: &477 + default: &479 value: id: 1 name: monalisa-octocat-hello-world-g4wpq6h95q @@ -39556,7 +40139,7 @@ paths: recent_folders: [] template: '304': *35 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -39587,14 +40170,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/copilot/copilot-user-management#get-copilot-seat-assignment-details-for-a-user parameters: - - *167 - - *215 + - *71 + - *217 responses: '200': description: The user's GitHub Copilot seat details, including usage. content: application/json: - schema: *107 + schema: *110 examples: default: value: @@ -39637,7 +40220,7 @@ paths: members_url: https://api.github.com/teams/1/members{/member} repositories_url: https://api.github.com/teams/1/repos parent: - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -39662,14 +40245,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#get-organization-membership-for-a-user parameters: - - *167 - - *215 + - *71 + - *217 responses: '200': description: Response content: application/json: - schema: &291 + schema: &293 title: Org Membership description: Org Membership type: object @@ -39722,7 +40305,7 @@ paths: - organization - user examples: - response-if-user-has-an-active-admin-membership-with-organization: &292 + response-if-user-has-an-active-admin-membership-with-organization: &294 summary: Response if user has an active admin membership with organization value: url: https://api.github.com/orgs/octocat/memberships/defunkt @@ -39790,8 +40373,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#set-organization-membership-for-a-user parameters: - - *167 - - *215 + - *71 + - *217 requestBody: required: false content: @@ -39819,9 +40402,9 @@ paths: description: Response content: application/json: - schema: *291 + schema: *293 examples: - response-if-user-already-had-membership-with-organization: *292 + response-if-user-already-had-membership-with-organization: *294 '422': *15 '403': *27 x-github: @@ -39835,6 +40418,9 @@ paths: In order to remove a user's membership with an organization, the authenticated user must be an organization owner. If the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases. + + > [!NOTE] + > If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team. tags: - orgs operationId: orgs/remove-membership-for-user @@ -39842,8 +40428,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#remove-organization-membership-for-a-user parameters: - - *167 - - *215 + - *71 + - *217 responses: '204': description: Response @@ -39868,7 +40454,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/orgs#list-organization-migrations parameters: - - *167 + - *71 - *17 - *19 - name: exclude @@ -39890,7 +40476,7 @@ paths: application/json: schema: type: array - items: &293 + items: &295 title: Migration description: A migration. type: object @@ -40147,7 +40733,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/orgs#start-an-organization-migration parameters: - - *167 + - *71 requestBody: required: true content: @@ -40228,7 +40814,7 @@ paths: description: Response content: application/json: - schema: *293 + schema: *295 examples: default: value: @@ -40406,8 +40992,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/orgs#get-an-organization-migration-status parameters: - - *167 - - &294 + - *71 + - &296 name: migration_id description: The unique identifier of the migration. in: path @@ -40435,7 +41021,7 @@ paths: * `failed`, which means the migration failed. content: application/json: - schema: *293 + schema: *295 examples: default: value: @@ -40604,8 +41190,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/orgs#download-an-organization-migration-archive parameters: - - *167 - - *294 + - *71 + - *296 responses: '302': description: Response @@ -40626,8 +41212,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/orgs#delete-an-organization-migration-archive parameters: - - *167 - - *294 + - *71 + - *296 responses: '204': description: Response @@ -40650,9 +41236,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/orgs#unlock-an-organization-repository parameters: - - *167 - - *294 - - &739 + - *71 + - *296 + - &741 name: repo_name description: repo_name parameter in: path @@ -40679,8 +41265,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/orgs#list-repositories-in-an-organization-migration parameters: - - *167 - - *294 + - *71 + - *296 - *17 - *19 responses: @@ -40690,9 +41276,9 @@ paths: application/json: schema: type: array - items: *193 + items: *195 examples: - default: &305 + default: &307 value: - id: 1296269 node_id: MDEwOlJlcG9zaXRvcnkxMjk2MjY5 @@ -40831,7 +41417,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#list-organization-fine-grained-permissions-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -40885,7 +41471,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#get-all-organization-roles-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response - list of organization roles @@ -40901,7 +41487,7 @@ paths: roles: type: array description: The list of organization roles available to the organization. - items: &295 + items: &297 title: Organization Role description: Organization roles type: object @@ -41063,7 +41649,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#create-a-custom-organization-role parameters: - - *167 + - *71 requestBody: required: true content: @@ -41110,7 +41696,7 @@ paths: description: Response content: application/json: - schema: *295 + schema: *297 examples: default: value: @@ -41139,7 +41725,7 @@ paths: updated_at: '2022-07-04T22:19:11Z' '422': *15 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -41161,8 +41747,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#remove-all-organization-roles-for-a-team parameters: - - *167 - - &296 + - *71 + - &298 name: team_slug description: The slug of the team name. in: path @@ -41193,9 +41779,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#assign-an-organization-role-to-a-team parameters: - - *167 - - *296 - - *241 + - *71 + - *298 + - *243 responses: '204': description: Response @@ -41224,9 +41810,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#remove-an-organization-role-from-a-team parameters: - - *167 - - *296 - - *241 + - *71 + - *298 + - *243 responses: '204': description: Response @@ -41251,8 +41837,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#remove-all-organization-roles-for-a-user parameters: - - *167 - - *215 + - *71 + - *217 responses: '204': description: Response @@ -41277,9 +41863,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#assign-an-organization-role-to-a-user parameters: - - *167 - - *215 - - *241 + - *71 + - *217 + - *243 responses: '204': description: Response @@ -41309,9 +41895,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#remove-an-organization-role-from-a-user parameters: - - *167 - - *215 - - *241 + - *71 + - *217 + - *243 responses: '204': description: Response @@ -41339,14 +41925,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#get-an-organization-role parameters: - - *167 - - *241 + - *71 + - *243 responses: '200': description: Response content: application/json: - schema: *295 + schema: *297 examples: default: value: @@ -41403,8 +41989,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#update-a-custom-organization-role parameters: - - *167 - - *241 + - *71 + - *243 requestBody: required: true content: @@ -41443,7 +42029,7 @@ paths: description: Response content: application/json: - schema: *295 + schema: *297 examples: default: value: @@ -41471,7 +42057,7 @@ paths: created_at: '2022-07-04T22:19:11Z' updated_at: '2022-07-04T22:19:11Z' '422': *15 - '409': *94 + '409': *97 '404': *6 x-github: githubCloudOnly: true @@ -41496,8 +42082,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#delete-a-custom-organization-role parameters: - - *167 - - *241 + - *71 + - *243 responses: '204': description: Response @@ -41522,8 +42108,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#list-teams-that-are-assigned-to-an-organization-role parameters: - - *167 - - *241 + - *71 + - *243 - *17 - *19 responses: @@ -41602,7 +42188,7 @@ paths: parent: anyOf: - type: 'null' - - *297 + - *299 required: - id - node_id @@ -41616,7 +42202,7 @@ paths: - slug - parent examples: - default: *298 + default: *300 headers: Link: *38 '404': @@ -41645,8 +42231,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#list-users-that-are-assigned-to-an-organization-role parameters: - - *167 - - *241 + - *71 + - *243 - *17 - *19 responses: @@ -41675,7 +42261,7 @@ paths: inherited_from: description: Team the user has gotten the role through type: array - items: *297 + items: *299 name: type: - string @@ -41792,7 +42378,7 @@ paths: - type - url examples: - default: *287 + default: *289 headers: Link: *38 '404': @@ -41816,7 +42402,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/outside-collaborators#list-outside-collaborators-for-an-organization parameters: - - *167 + - *71 - name: filter description: Filter the list of outside collaborators. `2fa_disabled` means that only outside collaborators without [two-factor authentication](https://github.com/blog/1614-two-factor-authentication) @@ -41843,7 +42429,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: *38 x-github: @@ -41868,8 +42454,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/outside-collaborators#convert-an-organization-member-to-outside-collaborator parameters: - - *167 - - *215 + - *71 + - *217 requestBody: required: false content: @@ -41926,8 +42512,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/outside-collaborators#remove-outside-collaborator-from-an-organization parameters: - - *167 - - *215 + - *71 + - *217 responses: '204': description: Response @@ -41984,8 +42570,8 @@ paths: - docker - nuget - container - - *167 - - &741 + - *71 + - &743 name: visibility description: |- The selected visibility of the packages. This parameter is optional and only filters an existing result set. @@ -42021,12 +42607,12 @@ paths: application/json: schema: type: array - items: *299 + items: *301 examples: - default: *300 + default: *302 '403': *27 '401': *23 - '400': &743 + '400': &745 description: The value of `per_page` multiplied by `page` cannot be greater than 10000. x-github: @@ -42048,7 +42634,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#get-a-package-for-an-organization parameters: - - &301 + - &303 name: package_type description: The type of supported package. Packages in GitHub's Gradle registry have the type `maven`. Docker images pushed to GitHub's Container registry @@ -42066,20 +42652,20 @@ paths: - docker - nuget - container - - &302 + - &304 name: package_name description: The name of the package. in: path required: true schema: type: string - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: *299 + schema: *301 examples: default: value: @@ -42131,9 +42717,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#delete-a-package-for-an-organization parameters: - - *301 - - *302 - - *167 + - *303 + - *304 + - *71 responses: '204': description: Response @@ -42165,9 +42751,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#restore-a-package-for-an-organization parameters: - - *301 - - *302 - - *167 + - *303 + - *304 + - *71 - name: token description: package token schema: @@ -42199,9 +42785,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#list-package-versions-for-a-package-owned-by-an-organization parameters: - - *301 - - *302 - - *167 + - *303 + - *304 + - *71 - *19 - *17 - name: state @@ -42221,7 +42807,7 @@ paths: application/json: schema: type: array - items: &303 + items: &305 title: Package Version description: A version of a software package type: object @@ -42356,10 +42942,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#get-a-package-version-for-an-organization parameters: - - *301 - - *302 - - *167 - - &304 + - *303 + - *304 + - *71 + - &306 name: package_version_id description: Unique identifier of the package version. in: path @@ -42371,7 +42957,7 @@ paths: description: Response content: application/json: - schema: *303 + schema: *305 examples: default: value: @@ -42407,10 +42993,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#delete-package-version-for-an-organization parameters: - - *301 - - *302 - - *167 + - *303 - *304 + - *71 + - *306 responses: '204': description: Response @@ -42442,10 +43028,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#restore-package-version-for-an-organization parameters: - - *301 - - *302 - - *167 + - *303 - *304 + - *71 + - *306 responses: '204': description: Response @@ -42472,10 +43058,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/personal-access-tokens#list-requests-to-access-organization-resources-with-fine-grained-personal-access-tokens parameters: - - *167 + - *71 - *17 - *19 - - &306 + - &308 name: sort description: The property by which to sort the results. in: query @@ -42485,8 +43071,8 @@ paths: enum: - created_at default: created_at - - *86 - - &307 + - *89 + - &309 name: owner description: A list of owner usernames to use to filter the results. in: query @@ -42498,7 +43084,7 @@ paths: type: string examples: - owner[]=octocat1,owner[]=octocat2 - - &308 + - &310 name: repository description: The name of the repository to use to filter the results. in: query @@ -42507,7 +43093,7 @@ paths: type: string examples: - Hello-World - - &309 + - &311 name: permission description: The permission to use to filter the results. in: query @@ -42516,7 +43102,7 @@ paths: type: string examples: - issues_read - - &310 + - &312 name: last_used_before description: 'Only show fine-grained personal access tokens used before the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) @@ -42526,7 +43112,7 @@ paths: schema: type: string format: date-time - - &311 + - &313 name: last_used_after description: 'Only show fine-grained personal access tokens used after the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) @@ -42536,7 +43122,7 @@ paths: schema: type: string format: date-time - - &312 + - &314 name: token_id description: The ID of the token in: query @@ -42549,7 +43135,7 @@ paths: examples: - token_id[]=1,token_id[]=2 responses: - '500': *83 + '500': *86 '422': *15 '404': *6 '403': *27 @@ -42704,7 +43290,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/personal-access-tokens#review-requests-to-access-organization-resources-with-fine-grained-personal-access-tokens parameters: - - *167 + - *71 requestBody: required: true content: @@ -42746,7 +43332,7 @@ paths: action: deny reason: Access is too broad. responses: - '500': *83 + '500': *86 '422': *15 '404': *6 '403': *27 @@ -42771,7 +43357,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/personal-access-tokens#review-a-request-to-access-organization-resources-with-a-fine-grained-personal-access-token parameters: - - *167 + - *71 - name: pat_request_id in: path description: Unique identifier of the request for access via fine-grained @@ -42808,11 +43394,11 @@ paths: action: deny reason: This request is denied because the access is too broad. responses: - '500': *83 + '500': *86 '422': *15 '404': *6 '403': *27 - '204': *116 + '204': *119 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -42833,7 +43419,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/personal-access-tokens#list-repositories-requested-to-be-accessed-by-a-fine-grained-personal-access-token parameters: - - *167 + - *71 - name: pat_request_id in: path description: Unique identifier of the request for access via fine-grained @@ -42844,7 +43430,7 @@ paths: - *17 - *19 responses: - '500': *83 + '500': *86 '404': *6 '403': *27 '200': @@ -42853,9 +43439,9 @@ paths: application/json: schema: type: array - items: *193 + items: *195 examples: - default: *305 + default: *307 headers: Link: *38 x-github: @@ -42878,19 +43464,19 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/personal-access-tokens#list-fine-grained-personal-access-tokens-with-access-to-organization-resources parameters: - - *167 + - *71 - *17 - *19 - - *306 - - *86 - - *307 - *308 + - *89 - *309 - *310 - *311 - *312 + - *313 + - *314 responses: - '500': *83 + '500': *86 '422': *15 '404': *6 '403': *27 @@ -43039,7 +43625,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/personal-access-tokens#update-the-access-to-organization-resources-via-fine-grained-personal-access-tokens parameters: - - *167 + - *71 requestBody: required: true content: @@ -43074,7 +43660,7 @@ paths: - 1296269 - 1296280 responses: - '500': *83 + '500': *86 '404': *6 '202': *37 '403': *27 @@ -43099,7 +43685,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/personal-access-tokens#update-the-access-a-fine-grained-personal-access-token-has-to-organization-resources parameters: - - *167 + - *71 - name: pat_id description: The unique identifier of the fine-grained personal access token. in: path @@ -43127,9 +43713,9 @@ paths: value: action: revoke responses: - '500': *83 + '500': *86 '404': *6 - '204': *116 + '204': *119 '403': *27 '422': *15 x-github: @@ -43151,7 +43737,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/personal-access-tokens#list-repositories-a-fine-grained-personal-access-token-has-access-to parameters: - - *167 + - *71 - name: pat_id in: path description: Unique identifier of the fine-grained personal access token. @@ -43161,7 +43747,7 @@ paths: - *17 - *19 responses: - '500': *83 + '500': *86 '404': *6 '403': *27 '200': @@ -43170,9 +43756,9 @@ paths: application/json: schema: type: array - items: *193 + items: *195 examples: - default: *305 + default: *307 headers: Link: *38 x-github: @@ -43196,7 +43782,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/private-registries/organization-configurations#list-private-registries-for-an-organization parameters: - - *167 + - *71 - *17 - *19 responses: @@ -43214,7 +43800,7 @@ paths: type: integer configurations: type: array - items: &313 + items: &315 title: Organization private registry description: Private registry configuration for an organization type: object @@ -43293,7 +43879,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/private-registries/organization-configurations#create-a-private-registry-for-an-organization parameters: - - *167 + - *71 requestBody: required: true content: @@ -43437,7 +44023,7 @@ paths: - created_at - updated_at examples: - org-private-registry-with-selected-visibility: &314 + org-private-registry-with-selected-visibility: &316 value: name: MAVEN_REPOSITORY_SECRET registry_type: maven_repository @@ -43478,7 +44064,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/private-registries/organization-configurations#get-private-registries-public-key-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -43528,16 +44114,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/private-registries/organization-configurations#get-a-private-registry-for-an-organization parameters: - - *167 - - *203 + - *71 + - *205 responses: '200': description: The specified private registry configuration for the organization content: application/json: - schema: *313 + schema: *315 examples: - default: *314 + default: *316 '404': *6 x-github: githubCloudOnly: false @@ -43558,8 +44144,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/private-registries/organization-configurations#update-a-private-registry-for-an-organization parameters: - - *167 - - *203 + - *71 + - *205 requestBody: required: true content: @@ -43643,8 +44229,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/private-registries/organization-configurations#delete-a-private-registry-for-an-organization parameters: - - *167 - - *203 + - *71 + - *205 responses: '204': description: Response @@ -43669,7 +44255,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/projects#list-organization-projects parameters: - - *167 + - *71 - name: state description: Indicates the state of the projects to return. in: query @@ -43690,7 +44276,7 @@ paths: application/json: schema: type: array - items: &315 + items: &317 title: Project description: Projects are a way to organize columns and cards of work. @@ -43846,7 +44432,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/projects#create-an-organization-project parameters: - - *167 + - *71 requestBody: required: true content: @@ -43872,7 +44458,7 @@ paths: description: Response content: application/json: - schema: *315 + schema: *317 examples: default: value: @@ -43910,7 +44496,7 @@ paths: '401': *23 '403': *27 '404': *6 - '410': &379 + '410': &381 description: Gone content: application/json: @@ -43937,7 +44523,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-properties#get-all-custom-properties-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -43945,9 +44531,9 @@ paths: application/json: schema: type: array - items: *112 + items: *115 examples: - default: *113 + default: *116 '403': *27 '404': *6 x-github: @@ -43974,7 +44560,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-properties#create-or-update-custom-properties-for-an-organization parameters: - - *167 + - *71 requestBody: required: true content: @@ -43985,7 +44571,7 @@ paths: properties: type: array description: The array of custom properties to create or update. - items: *112 + items: *115 minItems: 1 maxItems: 100 required: @@ -44015,9 +44601,9 @@ paths: application/json: schema: type: array - items: *112 + items: *115 examples: - default: *113 + default: *116 '403': *27 '404': *6 x-github: @@ -44038,16 +44624,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-properties#get-a-custom-property-for-an-organization parameters: - - *167 - - *114 + - *71 + - *117 responses: '200': description: Response content: application/json: - schema: *112 + schema: *115 examples: - default: *115 + default: *118 '403': *27 '404': *6 x-github: @@ -44070,13 +44656,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-properties#create-or-update-a-custom-property-for-an-organization parameters: - - *167 - - *114 + - *71 + - *117 requestBody: required: true content: application/json: - schema: *316 + schema: *318 examples: default: value: @@ -44092,9 +44678,9 @@ paths: description: Response content: application/json: - schema: *112 + schema: *115 examples: - default: *115 + default: *118 '403': *27 '404': *6 x-github: @@ -44117,10 +44703,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-properties#remove-a-custom-property-for-an-organization parameters: - - *167 - - *114 + - *71 + - *117 responses: - '204': *116 + '204': *119 '403': *27 '404': *6 x-github: @@ -44141,7 +44727,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-properties#list-custom-property-values-for-organization-repositories parameters: - - *167 + - *71 - *17 - *19 - name: repository_query @@ -44182,7 +44768,7 @@ paths: - octocat/Hello-World properties: type: array - items: &317 + items: &319 title: Custom Property Value description: Custom property name and associated value type: object @@ -44252,7 +44838,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-properties#create-or-update-custom-property-values-for-organization-repositories parameters: - - *167 + - *71 requestBody: required: true content: @@ -44272,7 +44858,7 @@ paths: type: array description: List of custom property names and associated values to apply to the repositories. - items: *317 + items: *319 required: - repository_names - properties @@ -44313,7 +44899,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#list-public-organization-members parameters: - - *167 + - *71 - *17 - *19 responses: @@ -44325,7 +44911,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: *38 x-github: @@ -44344,8 +44930,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#check-public-organization-membership-for-a-user parameters: - - *167 - - *215 + - *71 + - *217 responses: '204': description: Response if user is a public member @@ -44369,8 +44955,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#set-public-organization-membership-for-the-authenticated-user parameters: - - *167 - - *215 + - *71 + - *217 responses: '204': description: Response @@ -44391,8 +44977,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#remove-public-organization-membership-for-the-authenticated-user parameters: - - *167 - - *215 + - *71 + - *217 responses: '204': description: Response @@ -44416,7 +45002,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#list-organization-repositories parameters: - - *167 + - *71 - name: type description: Specifies the types of repositories you want returned. `internal` is not yet supported when a GitHub App calls this endpoint with an installation @@ -44463,9 +45049,9 @@ paths: application/json: schema: type: array - items: *193 + items: *195 examples: - default: *305 + default: *307 headers: Link: *38 x-github: @@ -44486,7 +45072,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#create-an-organization-repository parameters: - - *167 + - *71 requestBody: required: true content: @@ -44669,7 +45255,7 @@ paths: description: Response content: application/json: - schema: &381 + schema: &383 title: Full Repository description: Full Repository type: object @@ -45115,7 +45701,7 @@ paths: license: anyOf: - type: 'null' - - *152 + - *155 organization: anyOf: - type: 'null' @@ -45134,7 +45720,7 @@ paths: description: Whether anonymous git access is allowed. default: true type: boolean - code_of_conduct: &496 + code_of_conduct: &498 title: Code Of Conduct Simple description: Code of Conduct Simple type: object @@ -45164,7 +45750,7 @@ paths: - key - name - html_url - security_and_analysis: *318 + security_and_analysis: *320 custom_properties: type: object description: The custom properties that were defined for the repository. @@ -45248,7 +45834,7 @@ paths: - network_count - subscribers_count examples: - default: &383 + default: &385 value: id: 1296269 node_id: MDEwOlJlcG9zaXRvcnkxMjk2MjY5 @@ -45766,7 +46352,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-roles#list-repository-fine-grained-permissions-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -45774,9 +46360,9 @@ paths: application/json: schema: type: array - items: *319 + items: *321 examples: - default: *320 + default: *322 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -45798,10 +46384,10 @@ paths: category: orgs subcategory: rules parameters: - - *167 + - *71 - *17 - *19 - - &640 + - &642 name: targets description: | A comma-separated list of rule targets to filter by. @@ -45820,7 +46406,7 @@ paths: application/json: schema: type: array - items: *126 + items: *129 examples: default: value: @@ -45851,7 +46437,7 @@ paths: created_at: '2023-08-15T08:43:03Z' updated_at: '2023-09-23T16:29:47Z' '404': *6 - '500': *83 + '500': *86 post: summary: Create an organization repository ruleset description: Create a repository ruleset for an organization. @@ -45867,7 +46453,7 @@ paths: category: orgs subcategory: rules parameters: - - *167 + - *71 requestBody: description: Request body required: true @@ -45888,16 +46474,16 @@ paths: - push - repository default: branch - enforcement: *123 + enforcement: *126 bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: *124 - conditions: *321 + items: *127 + conditions: *323 rules: type: array description: An array of rules within the ruleset. - items: *125 + items: *128 required: - name - enforcement @@ -45935,9 +46521,9 @@ paths: description: Response content: application/json: - schema: *126 + schema: *129 examples: - default: &322 + default: &324 value: id: 21 name: super cool ruleset @@ -45977,7 +46563,7 @@ paths: created_at: '2023-08-15T08:43:03Z' updated_at: '2023-09-23T16:29:47Z' '404': *6 - '500': *83 + '500': *86 "/orgs/{org}/rulesets/rule-suites": get: summary: List organization rule suites @@ -45991,8 +46577,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/rule-suites#list-organization-rule-suites parameters: - - *167 - - &641 + - *71 + - &643 name: ref description: The name of the ref. Cannot contain wildcard characters. Optionally prefix with `refs/heads/` to limit to branches or `refs/tags/` to limit @@ -46002,16 +46588,16 @@ paths: schema: type: string x-multi-segment: true - - *222 - - *218 - - &642 + - *224 + - *220 + - &644 name: actor_name description: The handle for the GitHub user account to filter on. When specified, only rule evaluations triggered by this actor will be returned. in: query schema: type: string - - &643 + - &645 name: rule_suite_result description: The rule suite results to filter on. When specified, only suites with this result will be returned. @@ -46031,7 +46617,7 @@ paths: description: Response content: application/json: - schema: &644 + schema: &646 title: Rule Suites description: Response type: array @@ -46087,7 +46673,7 @@ paths: whether rules would pass or fail if all rules in the rule suite were `active`. examples: - default: &645 + default: &647 value: - id: 21 actor_id: 12 @@ -46111,7 +46697,7 @@ paths: result: pass evaluation_result: fail '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -46130,8 +46716,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/rule-suites#get-an-organization-rule-suite parameters: - - *167 - - &646 + - *71 + - &648 name: rule_suite_id description: |- The unique identifier of the rule suite result. @@ -46147,7 +46733,7 @@ paths: description: Response content: application/json: - schema: &647 + schema: &649 title: Rule Suite description: Response type: object @@ -46254,7 +46840,7 @@ paths: description: The detailed failure message for the rule. Null if the rule passed. examples: - default: &648 + default: &650 value: id: 21 actor_id: 12 @@ -46289,7 +46875,7 @@ paths: result: fail rule_type: commit_message_pattern '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -46315,7 +46901,7 @@ paths: category: orgs subcategory: rules parameters: - - *167 + - *71 - name: ruleset_id description: The ID of the ruleset. in: path @@ -46327,11 +46913,11 @@ paths: description: Response content: application/json: - schema: *126 + schema: *129 examples: - default: *322 + default: *324 '404': *6 - '500': *83 + '500': *86 put: summary: Update an organization repository ruleset description: Update a ruleset for an organization. @@ -46347,7 +46933,7 @@ paths: category: orgs subcategory: rules parameters: - - *167 + - *71 - name: ruleset_id description: The ID of the ruleset. in: path @@ -46373,16 +46959,16 @@ paths: - tag - push - repository - enforcement: *123 + enforcement: *126 bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: *124 - conditions: *321 + items: *127 + conditions: *323 rules: description: An array of rules within the ruleset. type: array - items: *125 + items: *128 examples: default: value: @@ -46417,11 +47003,11 @@ paths: description: Response content: application/json: - schema: *126 + schema: *129 examples: - default: *322 + default: *324 '404': *6 - '500': *83 + '500': *86 delete: summary: Delete an organization repository ruleset description: Delete a ruleset for an organization. @@ -46437,7 +47023,7 @@ paths: category: orgs subcategory: rules parameters: - - *167 + - *71 - name: ruleset_id description: The ID of the ruleset. in: path @@ -46448,7 +47034,7 @@ paths: '204': description: Response '404': *6 - '500': *83 + '500': *86 "/orgs/{org}/rulesets/{ruleset_id}/history": get: summary: Get organization ruleset history @@ -46460,7 +47046,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/rules#get-organization-ruleset-history parameters: - - *167 + - *71 - *17 - *19 - name: ruleset_id @@ -46476,11 +47062,11 @@ paths: application/json: schema: type: array - items: *129 + items: *132 examples: - default: *323 + default: *325 '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -46497,7 +47083,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/rules#get-organization-ruleset-version parameters: - - *167 + - *71 - name: ruleset_id description: The ID of the ruleset. in: path @@ -46515,7 +47101,7 @@ paths: description: Response content: application/json: - schema: *324 + schema: *326 examples: default: value: @@ -46555,7 +47141,7 @@ paths: operator: contains pattern: github '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -46577,15 +47163,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/secret-scanning/secret-scanning#list-secret-scanning-alerts-for-an-organization parameters: - - *167 - - *325 - - *326 + - *71 - *327 - *328 - - *86 + - *329 + - *330 + - *89 - *19 - *17 - - &650 + - &652 name: before description: A cursor, as given in the [Link header](https://docs.github.com/enterprise-cloud@latest//rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for events before this cursor. To @@ -46595,7 +47181,7 @@ paths: required: false schema: type: string - - &651 + - &653 name: after description: A cursor, as given in the [Link header](https://docs.github.com/enterprise-cloud@latest//rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for events after this cursor. To @@ -46605,10 +47191,10 @@ paths: required: false schema: type: string - - *329 - - *330 - *331 - *332 + - *333 + - *334 responses: '200': description: Response @@ -46616,13 +47202,13 @@ paths: application/json: schema: type: array - items: *333 + items: *335 examples: - default: *334 + default: *336 headers: Link: *38 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -46644,8 +47230,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/repository-advisories#list-repository-security-advisories-for-an-organization parameters: - - *167 - - *86 + - *71 + - *89 - name: sort description: The property to sort the results by. in: query @@ -46657,8 +47243,8 @@ paths: - updated - published default: created - - *84 - - *85 + - *87 + - *88 - name: per_page description: The number of advisories to return per page. For more information, see "[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api)." @@ -46688,7 +47274,7 @@ paths: application/json: schema: type: array - items: &672 + items: &674 description: A repository security advisory. type: object properties: @@ -46896,7 +47482,7 @@ paths: required: - vector_string - score - cvss_severities: *98 + cvss_severities: *101 cwes: type: - array @@ -46932,7 +47518,7 @@ paths: login: type: string description: The username of the user credited. - type: *335 + type: *337 credits_detailed: type: - array @@ -46943,7 +47529,7 @@ paths: type: object properties: user: *4 - type: *335 + type: *337 state: type: string description: The state of the user's acceptance of the @@ -46969,13 +47555,13 @@ paths: - array - 'null' description: A list of teams that collaborate on the advisory. - items: *224 + items: *226 private_fork: readOnly: true description: A temporary private fork of the advisory's repository for collaborating on a fix. allOf: - - *95 + - *98 type: - 'null' required: @@ -47007,7 +47593,7 @@ paths: - private_fork additionalProperties: false examples: - default: &673 + default: &675 value: - ghsa_id: GHSA-abcd-1234-efgh cve_id: CVE-2050-00000 @@ -47386,7 +47972,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/security-managers#list-security-manager-teams parameters: - - *167 + - *71 responses: '200': description: Response @@ -47394,9 +47980,9 @@ paths: application/json: schema: type: array - items: *297 + items: *299 examples: - default: *298 + default: *300 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -47419,8 +48005,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/security-managers#add-a-security-manager-team parameters: - - *167 - - *296 + - *71 + - *298 responses: '204': description: Response @@ -47445,8 +48031,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/security-managers#remove-a-security-manager-team parameters: - - *167 - - *296 + - *71 + - *298 responses: '204': description: Response @@ -47475,15 +48061,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/billing/billing#get-github-actions-billing-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: *336 + schema: *338 examples: - default: *337 + default: *339 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -47507,8 +48093,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/billing/billing#get-github-advanced-security-active-committers-for-an-organization parameters: - - *167 - - *338 + - *71 + - *340 - *17 - *19 responses: @@ -47516,9 +48102,9 @@ paths: description: Success content: application/json: - schema: *339 + schema: *341 examples: - default: *340 + default: *342 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -47540,15 +48126,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/billing/billing#get-github-packages-billing-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: *341 + schema: *343 examples: - default: *342 + default: *344 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -47570,15 +48156,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/billing/billing#get-shared-storage-billing-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: *343 + schema: *345 examples: - default: *344 + default: *346 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -47598,7 +48184,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/network-configurations#list-hosted-compute-network-configurations-for-an-organization parameters: - - *167 + - *71 - *17 - *19 responses: @@ -47616,9 +48202,9 @@ paths: type: integer network_configurations: type: array - items: *109 + items: *112 examples: - default: *345 + default: *347 headers: Link: *38 x-github: @@ -47639,7 +48225,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/network-configurations#create-a-hosted-compute-network-configuration-for-an-organization parameters: - - *167 + - *71 requestBody: required: true content: @@ -47681,9 +48267,9 @@ paths: description: Response content: application/json: - schema: *109 + schema: *112 examples: - default: *110 + default: *113 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -47703,16 +48289,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/network-configurations#get-a-hosted-compute-network-configuration-for-an-organization parameters: - - *167 - - *111 + - *71 + - *114 responses: '200': description: Response content: application/json: - schema: *109 + schema: *112 examples: - default: *110 + default: *113 headers: Link: *38 x-github: @@ -47733,8 +48319,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/network-configurations#update-a-hosted-compute-network-configuration-for-an-organization parameters: - - *167 - - *111 + - *71 + - *114 requestBody: required: true content: @@ -47773,9 +48359,9 @@ paths: description: Response content: application/json: - schema: *109 + schema: *112 examples: - default: *110 + default: *113 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -47794,8 +48380,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/network-configurations#delete-a-hosted-compute-network-configuration-from-an-organization parameters: - - *167 - - *111 + - *71 + - *114 responses: '204': description: Response @@ -47818,16 +48404,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/network-configurations#get-a-hosted-compute-network-settings-resource-for-an-organization parameters: - - *167 - - *346 + - *71 + - *348 responses: '200': description: Response content: application/json: - schema: *347 + schema: *349 examples: - default: *348 + default: *350 headers: Link: *38 x-github: @@ -47846,7 +48432,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/team-sync#list-idp-groups-for-an-organization parameters: - - *167 + - *71 - *17 - name: page description: Page token @@ -47865,7 +48451,7 @@ paths: description: Response content: application/json: - schema: &370 + schema: &372 title: GroupMapping description: External Groups to be mapped to a team for membership type: object @@ -47917,7 +48503,7 @@ paths: group_description: Another group of Developers working on AzureAD SAML SSO examples: - default: &371 + default: &373 value: groups: - group_id: '123' @@ -47962,8 +48548,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/copilot/copilot-metrics#get-copilot-metrics-for-a-team parameters: - - *167 - - *296 + - *71 + - *298 - name: since description: Show usage metrics since this date. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format (`YYYY-MM-DDTHH:MM:SSZ`). @@ -47995,13 +48581,13 @@ paths: application/json: schema: type: array - items: *134 + items: *137 examples: - default: *135 - '500': *83 + default: *138 + '500': *86 '403': *27 '404': *6 - '422': *136 + '422': *139 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -48019,7 +48605,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#list-teams parameters: - - *167 + - *71 - *17 - *19 responses: @@ -48029,9 +48615,9 @@ paths: application/json: schema: type: array - items: *224 + items: *226 examples: - default: *298 + default: *300 headers: Link: *38 '403': *27 @@ -48053,7 +48639,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#create-a-team parameters: - - *167 + - *71 requestBody: required: true content: @@ -48125,7 +48711,7 @@ paths: description: Response content: application/json: - schema: &349 + schema: &351 title: Full Team description: Groups of organization members that gives permissions on specified repositories. @@ -48199,7 +48785,7 @@ paths: parent: anyOf: - type: 'null' - - *297 + - *299 members_count: type: integer examples: @@ -48505,7 +49091,7 @@ paths: - repos_count - organization examples: - default: &350 + default: &352 value: id: 1 node_id: MDQ6VGVhbTE= @@ -48575,16 +49161,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#get-a-team-by-name parameters: - - *167 - - *296 + - *71 + - *298 responses: '200': description: Response content: application/json: - schema: *349 + schema: *351 examples: - default: *350 + default: *352 '404': *6 x-github: githubCloudOnly: false @@ -48605,8 +49191,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#update-a-team parameters: - - *167 - - *296 + - *71 + - *298 requestBody: required: false content: @@ -48669,16 +49255,16 @@ paths: description: Response when the updated information already exists content: application/json: - schema: *349 + schema: *351 examples: - default: *350 + default: *352 '201': description: Response content: application/json: - schema: *349 + schema: *351 examples: - default: *350 + default: *352 '404': *6 '422': *15 '403': *27 @@ -48703,8 +49289,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#delete-a-team parameters: - - *167 - - *296 + - *71 + - *298 responses: '204': description: Response @@ -48730,9 +49316,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussions#list-discussions parameters: - - *167 - - *296 - - *86 + - *71 + - *298 + - *89 - *17 - *19 - name: pinned @@ -48748,7 +49334,7 @@ paths: application/json: schema: type: array - items: &351 + items: &353 title: Team Discussion description: A team discussion is a persistent record of a free-form conversation within a team. @@ -48839,7 +49425,7 @@ paths: format: uri examples: - https://api.github.com/organizations/1/team/2343027/discussions/1 - reactions: *139 + reactions: *142 required: - author - body @@ -48859,7 +49445,7 @@ paths: - updated_at - url examples: - default: &713 + default: &715 value: - author: login: octocat @@ -48933,8 +49519,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussions#create-a-discussion parameters: - - *167 - - *296 + - *71 + - *298 requestBody: required: true content: @@ -48968,9 +49554,9 @@ paths: description: Response content: application/json: - schema: *351 + schema: *353 examples: - default: &352 + default: &354 value: author: login: octocat @@ -49042,9 +49628,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussions#get-a-discussion parameters: - - *167 - - *296 - - &353 + - *71 + - *298 + - &355 name: discussion_number description: The number that identifies the discussion. in: path @@ -49056,9 +49642,9 @@ paths: description: Response content: application/json: - schema: *351 + schema: *353 examples: - default: *352 + default: *354 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -49080,9 +49666,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussions#update-a-discussion parameters: - - *167 - - *296 - - *353 + - *71 + - *298 + - *355 requestBody: required: false content: @@ -49105,9 +49691,9 @@ paths: description: Response content: application/json: - schema: *351 + schema: *353 examples: - default: &714 + default: &716 value: author: login: octocat @@ -49177,9 +49763,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussions#delete-a-discussion parameters: - - *167 - - *296 - - *353 + - *71 + - *298 + - *355 responses: '204': description: Response @@ -49205,10 +49791,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussion-comments#list-discussion-comments parameters: - - *167 - - *296 - - *353 - - *86 + - *71 + - *298 + - *355 + - *89 - *17 - *19 responses: @@ -49218,7 +49804,7 @@ paths: application/json: schema: type: array - items: &354 + items: &356 title: Team Discussion Comment description: A reply to a discussion within a team. type: object @@ -49283,7 +49869,7 @@ paths: format: uri examples: - https://api.github.com/organizations/1/team/2403582/discussions/1/comments/1 - reactions: *139 + reactions: *142 required: - author - body @@ -49298,7 +49884,7 @@ paths: - updated_at - url examples: - default: &715 + default: &717 value: - author: login: octocat @@ -49366,9 +49952,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussion-comments#create-a-discussion-comment parameters: - - *167 - - *296 - - *353 + - *71 + - *298 + - *355 requestBody: required: true content: @@ -49390,9 +49976,9 @@ paths: description: Response content: application/json: - schema: *354 + schema: *356 examples: - default: &355 + default: &357 value: author: login: octocat @@ -49458,10 +50044,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussion-comments#get-a-discussion-comment parameters: - - *167 - - *296 - - *353 - - &356 + - *71 + - *298 + - *355 + - &358 name: comment_number description: The number that identifies the comment. in: path @@ -49473,9 +50059,9 @@ paths: description: Response content: application/json: - schema: *354 + schema: *356 examples: - default: *355 + default: *357 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -49497,10 +50083,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussion-comments#update-a-discussion-comment parameters: - - *167 - - *296 - - *353 - - *356 + - *71 + - *298 + - *355 + - *358 requestBody: required: true content: @@ -49522,9 +50108,9 @@ paths: description: Response content: application/json: - schema: *354 + schema: *356 examples: - default: &716 + default: &718 value: author: login: octocat @@ -49588,10 +50174,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussion-comments#delete-a-discussion-comment parameters: - - *167 - - *296 - - *353 - - *356 + - *71 + - *298 + - *355 + - *358 responses: '204': description: Response @@ -49617,10 +50203,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#list-reactions-for-a-team-discussion-comment parameters: - - *167 - - *296 - - *353 - - *356 + - *71 + - *298 + - *355 + - *358 - name: content description: Returns a single [reaction type](https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to a team discussion comment. @@ -49646,7 +50232,7 @@ paths: application/json: schema: type: array - items: &357 + items: &359 title: Reaction description: Reactions to conversations provide a way to help people express their feelings more simply and effectively. @@ -49690,7 +50276,7 @@ paths: - content - created_at examples: - default: &359 + default: &361 value: - id: 1 node_id: MDg6UmVhY3Rpb24x @@ -49740,10 +50326,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#create-reaction-for-a-team-discussion-comment parameters: - - *167 - - *296 - - *353 - - *356 + - *71 + - *298 + - *355 + - *358 requestBody: required: true content: @@ -49776,9 +50362,9 @@ paths: team discussion comment content: application/json: - schema: *357 + schema: *359 examples: - default: &358 + default: &360 value: id: 1 node_id: MDg6UmVhY3Rpb24x @@ -49807,9 +50393,9 @@ paths: description: Response content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -49832,11 +50418,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#delete-team-discussion-comment-reaction parameters: - - *167 - - *296 - - *353 - - *356 - - &360 + - *71 + - *298 + - *355 + - *358 + - &362 name: reaction_id description: The unique identifier of the reaction. in: path @@ -49868,9 +50454,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#list-reactions-for-a-team-discussion parameters: - - *167 - - *296 - - *353 + - *71 + - *298 + - *355 - name: content description: Returns a single [reaction type](https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to a team discussion. @@ -49896,9 +50482,9 @@ paths: application/json: schema: type: array - items: *357 + items: *359 examples: - default: *359 + default: *361 headers: Link: *38 x-github: @@ -49924,9 +50510,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#create-reaction-for-a-team-discussion parameters: - - *167 - - *296 - - *353 + - *71 + - *298 + - *355 requestBody: required: true content: @@ -49958,16 +50544,16 @@ paths: description: Response content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 '201': description: Response content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -49990,10 +50576,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#delete-team-discussion-reaction parameters: - - *167 - - *296 - - *353 - - *360 + - *71 + - *298 + - *355 + - *362 responses: '204': description: Response @@ -50016,16 +50602,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/external-groups#list-a-connection-between-an-external-group-and-a-team parameters: - - *167 - - *296 + - *71 + - *298 responses: '200': description: Response content: application/json: - schema: *361 + schema: *363 examples: - default: *362 + default: *364 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -50044,8 +50630,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/external-groups#update-the-connection-between-an-external-group-and-a-team parameters: - - *167 - - *296 + - *71 + - *298 requestBody: required: true content: @@ -50069,9 +50655,9 @@ paths: description: Response content: application/json: - schema: *363 + schema: *365 examples: - default: *364 + default: *366 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -50090,8 +50676,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/external-groups#remove-the-connection-between-an-external-group-and-a-team parameters: - - *167 - - *296 + - *71 + - *298 responses: '204': description: Response @@ -50115,8 +50701,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#list-pending-team-invitations parameters: - - *167 - - *296 + - *71 + - *298 - *17 - *19 responses: @@ -50126,9 +50712,9 @@ paths: application/json: schema: type: array - items: *279 + items: *281 examples: - default: *280 + default: *282 headers: Link: *38 x-github: @@ -50150,8 +50736,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#list-team-members parameters: - - *167 - - *296 + - *71 + - *298 - name: role description: Filters members returned by their role in the team. in: query @@ -50174,7 +50760,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: *38 x-github: @@ -50204,15 +50790,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#get-team-membership-for-a-user parameters: - - *167 - - *296 - - *215 + - *71 + - *298 + - *217 responses: '200': description: Response content: application/json: - schema: &365 + schema: &367 title: Team Membership description: Team Membership type: object @@ -50240,7 +50826,7 @@ paths: - state - url examples: - response-if-user-is-a-team-maintainer: &717 + response-if-user-is-a-team-maintainer: &719 summary: Response if user is a team maintainer value: url: https://api.github.com/teams/1/memberships/octocat @@ -50276,9 +50862,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#add-or-update-team-membership-for-a-user parameters: - - *167 - - *296 - - *215 + - *71 + - *298 + - *217 requestBody: required: false content: @@ -50303,9 +50889,9 @@ paths: description: Response content: application/json: - schema: *365 + schema: *367 examples: - response-if-users-membership-with-team-is-now-pending: &718 + response-if-users-membership-with-team-is-now-pending: &720 summary: Response if user's membership with team is now pending value: url: https://api.github.com/teams/1/memberships/octocat @@ -50340,9 +50926,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#remove-team-membership-for-a-user parameters: - - *167 - - *296 - - *215 + - *71 + - *298 + - *217 responses: '204': description: Response @@ -50367,8 +50953,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#list-team-projects parameters: - - *167 - - *296 + - *71 + - *298 - *17 - *19 responses: @@ -50378,7 +50964,7 @@ paths: application/json: schema: type: array - items: &366 + items: &368 title: Team Project description: A team's access to a project. type: object @@ -50447,7 +51033,7 @@ paths: - updated_at - permissions examples: - default: &719 + default: &721 value: - owner_url: https://api.github.com/orgs/octocat url: https://api.github.com/projects/1002605 @@ -50510,9 +51096,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#check-team-permissions-for-a-project parameters: - - *167 - - *296 - - &367 + - *71 + - *298 + - &369 name: project_id description: The unique identifier of the project. in: path @@ -50524,9 +51110,9 @@ paths: description: Response content: application/json: - schema: *366 + schema: *368 examples: - default: &720 + default: &722 value: owner_url: https://api.github.com/orgs/octocat url: https://api.github.com/projects/1002605 @@ -50588,9 +51174,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#add-or-update-team-project-permissions parameters: - - *167 - - *296 - - *367 + - *71 + - *298 + - *369 requestBody: required: false content: @@ -50657,9 +51243,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#remove-a-project-from-a-team parameters: - - *167 - - *296 - - *367 + - *71 + - *298 + - *369 responses: '204': description: Response @@ -50686,8 +51272,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#list-team-repositories parameters: - - *167 - - *296 + - *71 + - *298 - *17 - *19 responses: @@ -50697,9 +51283,9 @@ paths: application/json: schema: type: array - items: *193 + items: *195 examples: - default: *305 + default: *307 headers: Link: *38 x-github: @@ -50728,16 +51314,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#check-team-permissions-for-a-repository parameters: - - *167 - - *296 - - *368 - - *369 + - *71 + - *298 + - *370 + - *371 responses: '200': description: Alternative response with repository permissions content: application/json: - schema: &721 + schema: &723 title: Team Repository description: A team's access to a repository. type: object @@ -50763,7 +51349,7 @@ paths: license: anyOf: - type: 'null' - - *152 + - *155 forks: type: integer permissions: @@ -51378,10 +51964,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#add-or-update-team-repository-permissions parameters: - - *167 - - *296 - - *368 - - *369 + - *71 + - *298 + - *370 + - *371 requestBody: required: false content: @@ -51426,10 +52012,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#remove-a-repository-from-a-team parameters: - - *167 - - *296 - - *368 - - *369 + - *71 + - *298 + - *370 + - *371 responses: '204': description: Response @@ -51455,16 +52041,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/team-sync#list-idp-groups-for-a-team parameters: - - *167 - - *296 + - *71 + - *298 responses: '200': description: Response content: application/json: - schema: *370 + schema: *372 examples: - default: *371 + default: *373 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -51486,8 +52072,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/team-sync#create-or-update-idp-group-connections parameters: - - *167 - - *296 + - *71 + - *298 requestBody: required: true content: @@ -51530,7 +52116,7 @@ paths: description: Response content: application/json: - schema: *370 + schema: *372 examples: default: value: @@ -51562,8 +52148,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#list-child-teams parameters: - - *167 - - *296 + - *71 + - *298 - *17 - *19 responses: @@ -51573,9 +52159,9 @@ paths: application/json: schema: type: array - items: *224 + items: *226 examples: - response-if-child-teams-exist: &722 + response-if-child-teams-exist: &724 value: - id: 2 node_id: MDQ6VGVhbTI= @@ -51628,7 +52214,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/orgs#enable-or-disable-a-security-feature-for-an-organization parameters: - - *167 + - *71 - name: security_product in: path description: The security feature to enable or disable. @@ -51702,7 +52288,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/cards#get-a-project-card parameters: - - &372 + - &374 name: card_id description: The unique identifier of the card. in: path @@ -51714,7 +52300,7 @@ paths: description: Response content: application/json: - schema: &373 + schema: &375 title: Project Card description: Project cards represent a scope of work. type: object @@ -51789,7 +52375,7 @@ paths: - created_at - updated_at examples: - default: &374 + default: &376 value: url: https://api.github.com/projects/columns/cards/1478 id: 1478 @@ -51845,7 +52431,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/cards#update-an-existing-project-card parameters: - - *372 + - *374 requestBody: required: false content: @@ -51875,9 +52461,9 @@ paths: description: Response content: application/json: - schema: *373 + schema: *375 examples: - default: *374 + default: *376 '304': *35 '403': *27 '401': *23 @@ -51904,7 +52490,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/cards#delete-a-project-card parameters: - - *372 + - *374 responses: '204': description: Response @@ -51948,7 +52534,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/cards#move-a-project-card parameters: - - *372 + - *374 requestBody: required: true content: @@ -52061,7 +52647,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/columns#get-a-project-column parameters: - - &375 + - &377 name: column_id description: The unique identifier of the column. in: path @@ -52073,7 +52659,7 @@ paths: description: Response content: application/json: - schema: &376 + schema: &378 title: Project Column description: Project columns contain cards of work. type: object @@ -52127,7 +52713,7 @@ paths: - created_at - updated_at examples: - default: &377 + default: &379 value: url: https://api.github.com/projects/columns/367 project_url: https://api.github.com/projects/120 @@ -52162,7 +52748,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/columns#update-an-existing-project-column parameters: - - *375 + - *377 requestBody: required: true content: @@ -52187,9 +52773,9 @@ paths: description: Response content: application/json: - schema: *376 + schema: *378 examples: - default: *377 + default: *379 '304': *35 '403': *27 '401': *23 @@ -52214,7 +52800,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/columns#delete-a-project-column parameters: - - *375 + - *377 responses: '204': description: Response @@ -52243,7 +52829,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/cards#list-project-cards parameters: - - *375 + - *377 - name: archived_state description: Filters the project cards that are returned by the card's state. in: query @@ -52264,7 +52850,7 @@ paths: application/json: schema: type: array - items: *373 + items: *375 examples: default: value: @@ -52323,7 +52909,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/cards#create-a-project-card parameters: - - *375 + - *377 requestBody: required: true content: @@ -52367,9 +52953,9 @@ paths: description: Response content: application/json: - schema: *373 + schema: *375 examples: - default: *374 + default: *376 '304': *35 '403': *27 '401': *23 @@ -52379,8 +52965,8 @@ paths: application/json: schema: oneOf: - - *176 - - *177 + - *178 + - *179 '503': description: Response content: @@ -52425,7 +53011,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/columns#move-a-project-column parameters: - - *375 + - *377 requestBody: required: true content: @@ -52486,15 +53072,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/projects#get-a-project parameters: - - *367 + - *369 responses: '200': description: Response content: application/json: - schema: *315 + schema: *317 examples: - default: &378 + default: &380 value: owner_url: https://api.github.com/repos/api-playground/projects-test url: https://api.github.com/projects/1002604 @@ -52551,7 +53137,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/projects#update-a-project parameters: - - *367 + - *369 requestBody: required: false content: @@ -52600,9 +53186,9 @@ paths: description: Response content: application/json: - schema: *315 + schema: *317 examples: - default: *378 + default: *380 '404': description: Not Found if the authenticated user does not have access to the project @@ -52623,7 +53209,7 @@ paths: items: type: string '401': *23 - '410': *379 + '410': *381 '422': *7 x-github: githubCloudOnly: false @@ -52646,7 +53232,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/projects#delete-a-project parameters: - - *367 + - *369 responses: '204': description: Delete Success @@ -52667,7 +53253,7 @@ paths: items: type: string '401': *23 - '410': *379 + '410': *381 '404': *6 x-github: githubCloudOnly: false @@ -52691,7 +53277,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/collaborators#list-project-collaborators parameters: - - *367 + - *369 - name: affiliation description: Filters the collaborators by their affiliation. `outside` means outside collaborators of a project that are not a member of the project's @@ -52718,7 +53304,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: *38 '404': *6 @@ -52748,8 +53334,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/collaborators#add-project-collaborator parameters: - - *367 - - *215 + - *369 + - *217 requestBody: required: false content: @@ -52803,8 +53389,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/collaborators#remove-user-as-a-collaborator parameters: - - *367 - - *215 + - *369 + - *217 responses: '204': description: Response @@ -52835,8 +53421,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/collaborators#get-project-permission-for-a-user parameters: - - *367 - - *215 + - *369 + - *217 responses: '200': description: Response @@ -52906,7 +53492,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/columns#list-project-columns parameters: - - *367 + - *369 - *17 - *19 responses: @@ -52916,7 +53502,7 @@ paths: application/json: schema: type: array - items: *376 + items: *378 examples: default: value: @@ -52954,7 +53540,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/columns#create-a-project-column parameters: - - *367 + - *369 requestBody: required: true content: @@ -52978,7 +53564,7 @@ paths: description: Response content: application/json: - schema: *376 + schema: *378 examples: default: value: @@ -53043,7 +53629,7 @@ paths: resources: type: object properties: - core: &380 + core: &382 title: Rate Limit type: object properties: @@ -53060,21 +53646,21 @@ paths: - remaining - reset - used - graphql: *380 - search: *380 - code_search: *380 - source_import: *380 - integration_manifest: *380 - code_scanning_upload: *380 - actions_runner_registration: *380 - scim: *380 - dependency_snapshots: *380 - dependency_sbom: *380 - code_scanning_autofix: *380 + graphql: *382 + search: *382 + code_search: *382 + source_import: *382 + integration_manifest: *382 + code_scanning_upload: *382 + actions_runner_registration: *382 + scim: *382 + dependency_snapshots: *382 + dependency_sbom: *382 + code_scanning_autofix: *382 required: - core - search - rate: *380 + rate: *382 required: - rate - resources @@ -53178,14 +53764,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#get-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response content: application/json: - schema: *381 + schema: *383 examples: default-response: summary: Default response @@ -53690,7 +54276,7 @@ paths: status: disabled '403': *27 '404': *6 - '301': *382 + '301': *384 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -53708,8 +54294,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#update-a-repository parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: false content: @@ -53964,10 +54550,10 @@ paths: description: Response content: application/json: - schema: *381 + schema: *383 examples: - default: *383 - '307': &384 + default: *385 + '307': &386 description: Temporary Redirect content: application/json: @@ -53996,8 +54582,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#delete-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response @@ -54019,9 +54605,9 @@ paths: value: message: Organization members cannot delete repositories. documentation_url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#delete-a-repository - '307': *384 + '307': *386 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -54043,11 +54629,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/artifacts#list-artifacts-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 - - &399 + - &401 name: name description: The name field of an artifact. When specified, only artifacts with this name will be returned. @@ -54070,7 +54656,7 @@ paths: type: integer artifacts: type: array - items: &385 + items: &387 title: Artifact description: An artifact type: object @@ -54165,7 +54751,7 @@ paths: - expires_at - updated_at examples: - default: &400 + default: &402 value: total_count: 2 artifacts: @@ -54226,9 +54812,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/artifacts#get-an-artifact parameters: - - *368 - - *369 - - &386 + - *370 + - *371 + - &388 name: artifact_id description: The unique identifier of the artifact. in: path @@ -54240,7 +54826,7 @@ paths: description: Response content: application/json: - schema: *385 + schema: *387 examples: default: value: @@ -54278,9 +54864,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/artifacts#delete-an-artifact parameters: - - *368 - - *369 - - *386 + - *370 + - *371 + - *388 responses: '204': description: Response @@ -54304,9 +54890,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/artifacts#download-an-artifact parameters: - - *368 - - *369 - - *386 + - *370 + - *371 + - *388 - name: archive_format in: path required: true @@ -54320,7 +54906,7 @@ paths: example: https://pipelines.actions.githubusercontent.com/OhgS4QRKqmgx7bKC27GKU83jnQjyeqG8oIMTge8eqtheppcmw8/_apis/pipelines/1/runs/176/signedlogcontent?urlExpires=2020-01-24T18%3A10%3A31.5729946Z&urlSigningMethod=HMACV1&urlSignature=agG73JakPYkHrh06seAkvmH7rBR4Ji4c2%2B6a2ejYh3E%3D schema: type: string - '410': *379 + '410': *381 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -54343,14 +54929,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/cache#get-github-actions-cache-usage-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response content: application/json: - schema: *387 + schema: *389 examples: default: value: @@ -54376,11 +54962,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/cache#list-github-actions-caches-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 - - &388 + - &390 name: ref description: The full Git reference for narrowing down the cache. The `ref` for a branch should be formatted as `refs/heads/`. To reference @@ -54408,13 +54994,13 @@ paths: - last_accessed_at - size_in_bytes default: last_accessed_at - - *86 + - *89 responses: '200': description: Response content: application/json: - schema: &389 + schema: &391 title: Repository actions caches description: Repository actions caches type: object @@ -54464,7 +55050,7 @@ paths: - total_count - actions_caches examples: - default: &390 + default: &392 value: total_count: 1 actions_caches: @@ -54496,23 +55082,23 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/cache#delete-github-actions-caches-for-a-repository-using-a-cache-key parameters: - - *368 - - *369 + - *370 + - *371 - name: key description: A key for identifying the cache. in: query required: true schema: type: string - - *388 + - *390 responses: '200': description: Response content: application/json: - schema: *389 + schema: *391 examples: - default: *390 + default: *392 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -54532,8 +55118,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/cache#delete-a-github-actions-cache-for-a-repository-using-a-cache-id parameters: - - *368 - - *369 + - *370 + - *371 - name: cache_id description: The unique identifier of the GitHub Actions cache. in: path @@ -54564,9 +55150,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-jobs#get-a-job-for-a-workflow-run parameters: - - *368 - - *369 - - &391 + - *370 + - *371 + - &393 name: job_id description: The unique identifier of the job. in: path @@ -54578,7 +55164,7 @@ paths: description: Response content: application/json: - schema: &403 + schema: &405 title: Job description: Information of a job execution in a workflow run type: object @@ -54925,9 +55511,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-jobs#download-job-logs-for-a-workflow-run parameters: - - *368 - - *369 - - *391 + - *370 + - *371 + - *393 responses: '302': description: Response @@ -54955,9 +55541,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#re-run-a-job-from-a-workflow-run parameters: - - *368 - - *369 - - *391 + - *370 + - *371 + - *393 requestBody: required: false content: @@ -54979,7 +55565,7 @@ paths: description: Response content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -55003,8 +55589,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/oidc#get-the-customization-template-for-an-oidc-subject-claim-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Status response @@ -55054,8 +55640,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/oidc#set-the-customization-template-for-an-oidc-subject-claim-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -55089,7 +55675,7 @@ paths: description: Empty response content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -55118,8 +55704,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#list-repository-organization-secrets parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -55137,7 +55723,7 @@ paths: type: integer secrets: type: array - items: &405 + items: &407 title: Actions Secret description: Set secrets for GitHub Actions. type: object @@ -55158,7 +55744,7 @@ paths: - created_at - updated_at examples: - default: &406 + default: &408 value: total_count: 2 secrets: @@ -55191,9 +55777,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#list-repository-organization-variables parameters: - - *368 - - *369 - - *392 + - *370 + - *371 + - *394 - *19 responses: '200': @@ -55210,7 +55796,7 @@ paths: type: integer variables: type: array - items: &409 + items: &411 title: Actions Variable type: object properties: @@ -55244,7 +55830,7 @@ paths: - created_at - updated_at examples: - default: &410 + default: &412 value: total_count: 2 variables: @@ -55277,8 +55863,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#get-github-actions-permissions-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -55287,11 +55873,11 @@ paths: schema: type: object properties: - enabled: &393 + enabled: &395 type: boolean description: Whether GitHub Actions is enabled on the repository. allowed_actions: *47 - selected_actions_url: *186 + selected_actions_url: *188 required: - enabled examples: @@ -55320,8 +55906,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#set-github-actions-permissions-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response @@ -55332,7 +55918,7 @@ paths: schema: type: object properties: - enabled: *393 + enabled: *395 allowed_actions: *47 required: - enabled @@ -55363,14 +55949,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#get-the-level-of-access-for-workflows-outside-of-the-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response content: application/json: - schema: &394 + schema: &396 type: object properties: access_level: @@ -55388,7 +55974,7 @@ paths: required: - access_level examples: - default: &395 + default: &397 value: access_level: organization x-github: @@ -55413,15 +55999,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#set-the-level-of-access-for-workflows-outside-of-the-repository parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: application/json: - schema: *394 + schema: *396 examples: - default: *395 + default: *397 responses: '204': description: Response @@ -55445,8 +56031,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#get-allowed-actions-and-reusable-workflows-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -55477,8 +56063,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#set-allowed-actions-and-reusable-workflows-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response @@ -55510,14 +56096,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#get-default-workflow-permissions-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response content: application/json: - schema: *189 + schema: *191 examples: default: *53 x-github: @@ -55540,8 +56126,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#set-default-workflow-permissions-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Success response @@ -55552,7 +56138,7 @@ paths: required: true content: application/json: - schema: *190 + schema: *192 examples: default: *53 x-github: @@ -55581,8 +56167,8 @@ paths: in: query schema: type: string - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -55626,8 +56212,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#list-runner-applications-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -55635,9 +56221,9 @@ paths: application/json: schema: type: array - items: *194 + items: *196 examples: - default: *195 + default: *197 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -55659,8 +56245,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#create-configuration-for-a-just-in-time-runner-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -55703,10 +56289,10 @@ paths: - no-gpu work_folder: _work responses: - '201': *196 + '201': *198 '404': *6 '422': *7 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -55734,8 +56320,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#create-a-registration-token-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '201': description: Response @@ -55743,7 +56329,7 @@ paths: application/json: schema: *63 examples: - default: *197 + default: *199 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -55771,8 +56357,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#create-a-remove-token-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '201': description: Response @@ -55780,7 +56366,7 @@ paths: application/json: schema: *63 examples: - default: *198 + default: *200 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -55802,8 +56388,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#get-a-self-hosted-runner-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - *59 responses: '200': @@ -55812,7 +56398,7 @@ paths: application/json: schema: *60 examples: - default: *199 + default: *201 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -55833,8 +56419,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#delete-a-self-hosted-runner-from-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - *59 responses: '204': @@ -55861,8 +56447,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#list-labels-for-a-self-hosted-runner-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - *59 responses: '200': *65 @@ -55887,8 +56473,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#add-custom-labels-to-a-self-hosted-runner-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - *59 requestBody: required: true @@ -55937,8 +56523,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#set-custom-labels-for-a-self-hosted-runner-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - *59 requestBody: required: true @@ -55988,11 +56574,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#remove-all-custom-labels-from-a-self-hosted-runner-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - *59 responses: - '200': *200 + '200': *202 '404': *6 x-github: githubCloudOnly: false @@ -56019,10 +56605,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#remove-a-custom-label-from-a-self-hosted-runner-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - *59 - - *201 + - *203 responses: '200': *65 '404': *6 @@ -56050,9 +56636,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#list-workflow-runs-for-a-repository parameters: - - *368 - - *369 - - &413 + - *370 + - *371 + - &415 name: actor description: Returns someone's workflow runs. Use the login for the user who created the `push` associated with the check suite or workflow run. @@ -56060,7 +56646,7 @@ paths: required: false schema: type: string - - &414 + - &416 name: branch description: Returns workflow runs associated with a branch. Use the name of the branch of the `push`. @@ -56068,7 +56654,7 @@ paths: required: false schema: type: string - - &415 + - &417 name: event description: Returns workflow run triggered by the event you specify. For example, `push`, `pull_request` or `issue`. For more information, see "[Events @@ -56077,7 +56663,7 @@ paths: required: false schema: type: string - - &416 + - &418 name: status description: Returns workflow runs with the check run `status` or `conclusion` that you specify. For example, a conclusion can be `success` or a status @@ -56104,7 +56690,7 @@ paths: - pending - *17 - *19 - - &417 + - &419 name: created description: Returns workflow runs created within the given date-time range. For more information on the syntax, see "[Understanding the search syntax](https://docs.github.com/enterprise-cloud@latest//search-github/getting-started-with-searching-on-github/understanding-the-search-syntax#query-for-dates)." @@ -56113,7 +56699,7 @@ paths: schema: type: string format: date-time - - &396 + - &398 name: exclude_pull_requests description: If `true` pull requests are omitted from the response (empty array). @@ -56122,13 +56708,13 @@ paths: schema: type: boolean default: false - - &418 + - &420 name: check_suite_id description: Returns workflow runs with the `check_suite_id` that you specify. in: query schema: type: integer - - &419 + - &421 name: head_sha description: Only returns workflow runs that are associated with the specified `head_sha`. @@ -56151,7 +56737,7 @@ paths: type: integer workflow_runs: type: array - items: &397 + items: &399 title: Workflow Run description: An invocation of a workflow type: object @@ -56268,7 +56854,7 @@ paths: type: - array - 'null' - items: &440 + items: &442 title: Pull Request Minimal type: object properties: @@ -56395,7 +56981,7 @@ paths: head_commit: anyOf: - type: 'null' - - &444 + - &446 title: Simple Commit description: A commit. type: object @@ -56469,8 +57055,8 @@ paths: - timestamp - author - committer - repository: *193 - head_repository: *193 + repository: *195 + head_repository: *195 head_repository_id: type: integer examples: @@ -56510,7 +57096,7 @@ paths: - workflow_url - pull_requests examples: - default: &420 + default: &422 value: total_count: 1 workflow_runs: @@ -56746,24 +57332,24 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#get-a-workflow-run parameters: - - *368 - - *369 - - &398 + - *370 + - *371 + - &400 name: run_id description: The unique identifier of the workflow run. in: path required: true schema: type: integer - - *396 + - *398 responses: '200': description: Response content: application/json: - schema: *397 + schema: *399 examples: - default: &401 + default: &403 value: id: 30433642 name: Build @@ -57004,9 +57590,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#delete-a-workflow-run parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 responses: '204': description: Response @@ -57029,9 +57615,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#get-the-review-history-for-a-workflow-run parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 responses: '200': description: Response @@ -57159,15 +57745,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#approve-a-workflow-run-for-a-fork-pull-request parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 responses: '201': description: Response content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -57194,12 +57780,12 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/artifacts#list-workflow-run-artifacts parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 - *17 - *19 - - *399 + - *401 responses: '200': description: Response @@ -57215,9 +57801,9 @@ paths: type: integer artifacts: type: array - items: *385 + items: *387 examples: - default: *400 + default: *402 headers: Link: *38 x-github: @@ -57241,25 +57827,25 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#get-a-workflow-run-attempt parameters: - - *368 - - *369 - - *398 - - &402 + - *370 + - *371 + - *400 + - &404 name: attempt_number description: The attempt number of the workflow run. in: path required: true schema: type: integer - - *396 + - *398 responses: '200': description: Response content: application/json: - schema: *397 + schema: *399 examples: - default: *401 + default: *403 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -57282,10 +57868,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-jobs#list-jobs-for-a-workflow-run-attempt parameters: - - *368 - - *369 - - *398 - - *402 + - *370 + - *371 + - *400 + - *404 - *17 - *19 responses: @@ -57303,9 +57889,9 @@ paths: type: integer jobs: type: array - items: *403 + items: *405 examples: - default: &404 + default: &406 value: total_count: 1 jobs: @@ -57418,10 +58004,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#download-workflow-run-attempt-logs parameters: - - *368 - - *369 - - *398 - - *402 + - *370 + - *371 + - *400 + - *404 responses: '302': description: Response @@ -57449,19 +58035,19 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#cancel-a-workflow-run parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 responses: '202': description: Response content: application/json: - schema: *204 + schema: *206 examples: default: value: - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -57484,9 +58070,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#review-custom-deployment-protection-rules-for-a-workflow-run parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 requestBody: required: true content: @@ -57553,19 +58139,19 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#force-cancel-a-workflow-run parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 responses: '202': description: Response content: application/json: - schema: *204 + schema: *206 examples: default: value: - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -57588,9 +58174,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-jobs#list-jobs-for-a-workflow-run parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 - name: filter description: Filters jobs by their `completed_at` timestamp. `latest` returns jobs from the most recent execution of the workflow run. `all` returns all @@ -57620,9 +58206,9 @@ paths: type: integer jobs: type: array - items: *403 + items: *405 examples: - default: *404 + default: *406 headers: Link: *38 x-github: @@ -57647,9 +58233,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#download-workflow-run-logs parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 responses: '302': description: Response @@ -57676,14 +58262,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#delete-workflow-run-logs parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 responses: '204': description: Response '403': *27 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -57705,9 +58291,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#get-pending-deployments-for-a-workflow-run parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 responses: '200': description: Response @@ -57776,7 +58362,7 @@ paths: items: type: object properties: - type: &524 + type: &526 type: string description: The type of reviewer. enum: @@ -57787,7 +58373,7 @@ paths: reviewer: anyOf: - *4 - - *224 + - *226 required: - environment - wait_timer @@ -57862,9 +58448,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#review-pending-deployments-for-a-workflow-run parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 requestBody: required: true content: @@ -57914,7 +58500,7 @@ paths: application/json: schema: type: array - items: &510 + items: &512 title: Deployment description: A request for a specific ref(branch,sha,tag) to be deployed @@ -58026,7 +58612,7 @@ paths: - created_at - updated_at examples: - default: &511 + default: &513 value: - url: https://api.github.com/repos/octocat/example/deployments/1 id: 1 @@ -58082,9 +58668,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#re-run-a-workflow parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 requestBody: required: false content: @@ -58106,7 +58692,7 @@ paths: description: Response content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -58129,9 +58715,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#re-run-failed-jobs-from-a-workflow-run parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 requestBody: required: false content: @@ -58153,7 +58739,7 @@ paths: description: Response content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -58186,9 +58772,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#get-workflow-run-usage parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 responses: '200': description: Response @@ -58325,8 +58911,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#list-repository-secrets parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -58344,9 +58930,9 @@ paths: type: integer secrets: type: array - items: *405 + items: *407 examples: - default: *406 + default: *408 headers: Link: *38 x-github: @@ -58371,16 +58957,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#get-a-repository-public-key parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response content: application/json: - schema: *407 + schema: *409 examples: - default: *408 + default: *410 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -58402,17 +58988,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#get-a-repository-secret parameters: - - *368 - - *369 - - *203 + - *370 + - *371 + - *205 responses: '200': description: Response content: application/json: - schema: *405 + schema: *407 examples: - default: &537 + default: &539 value: name: GH_TOKEN created_at: '2019-08-10T14:59:22Z' @@ -58438,9 +59024,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#create-or-update-a-repository-secret parameters: - - *368 - - *369 - - *203 + - *370 + - *371 + - *205 requestBody: required: true content: @@ -58471,7 +59057,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -58497,9 +59083,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#delete-a-repository-secret parameters: - - *368 - - *369 - - *203 + - *370 + - *371 + - *205 responses: '204': description: Response @@ -58524,9 +59110,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#list-repository-variables parameters: - - *368 - - *369 - - *392 + - *370 + - *371 + - *394 - *19 responses: '200': @@ -58543,9 +59129,9 @@ paths: type: integer variables: type: array - items: *409 + items: *411 examples: - default: *410 + default: *412 headers: Link: *38 x-github: @@ -58568,8 +59154,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#create-a-repository-variable parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -58596,7 +59182,7 @@ paths: description: Response content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -58621,17 +59207,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#get-a-repository-variable parameters: - - *368 - - *369 - - *206 + - *370 + - *371 + - *208 responses: '200': description: Response content: application/json: - schema: *409 + schema: *411 examples: - default: &538 + default: &540 value: name: USERNAME value: octocat @@ -58657,9 +59243,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#update-a-repository-variable parameters: - - *368 - - *369 - - *206 + - *370 + - *371 + - *208 requestBody: required: true content: @@ -58701,9 +59287,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#delete-a-repository-variable parameters: - - *368 - - *369 - - *206 + - *370 + - *371 + - *208 responses: '204': description: Response @@ -58728,8 +59314,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflows#list-repository-workflows parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -58747,7 +59333,7 @@ paths: type: integer workflows: type: array - items: &411 + items: &413 title: Workflow description: A GitHub Actions workflow type: object @@ -58865,9 +59451,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflows#get-a-workflow parameters: - - *368 - - *369 - - &412 + - *370 + - *371 + - &414 name: workflow_id in: path description: The ID of the workflow. You can also pass the workflow file name @@ -58882,7 +59468,7 @@ paths: description: Response content: application/json: - schema: *411 + schema: *413 examples: default: value: @@ -58915,9 +59501,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflows#disable-a-workflow parameters: - - *368 - - *369 - - *412 + - *370 + - *371 + - *414 responses: '204': description: Response @@ -58942,9 +59528,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflows#create-a-workflow-dispatch-event parameters: - - *368 - - *369 - - *412 + - *370 + - *371 + - *414 responses: '204': description: Response @@ -58995,9 +59581,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflows#enable-a-workflow parameters: - - *368 - - *369 - - *412 + - *370 + - *371 + - *414 responses: '204': description: Response @@ -59024,19 +59610,19 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#list-workflow-runs-for-a-workflow parameters: - - *368 - - *369 - - *412 - - *413 + - *370 + - *371 - *414 - *415 - *416 - - *17 - - *19 - *417 - - *396 - *418 + - *17 + - *19 - *419 + - *398 + - *420 + - *421 responses: '200': description: Response @@ -59052,9 +59638,9 @@ paths: type: integer workflow_runs: type: array - items: *397 + items: *399 examples: - default: *420 + default: *422 headers: Link: *38 x-github: @@ -59087,9 +59673,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflows#get-workflow-usage parameters: - - *368 - - *369 - - *412 + - *370 + - *371 + - *414 responses: '200': description: Response @@ -59150,12 +59736,12 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#list-repository-activities parameters: - - *368 - - *369 - - *86 + - *370 + - *371 + - *89 - *17 - - *84 - - *85 + - *87 + - *88 - name: ref description: |- The Git reference for the activities you want to list. @@ -59319,8 +59905,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/assignees#list-assignees parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -59332,7 +59918,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: *38 '404': *6 @@ -59357,8 +59943,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/assignees#check-if-a-user-can-be-assigned parameters: - - *368 - - *369 + - *370 + - *371 - name: assignee in: path required: true @@ -59394,8 +59980,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#create-an-attestation parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -59507,11 +60093,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#list-attestations parameters: - - *368 - - *369 + - *370 + - *371 - *17 - - *84 - - *85 + - *87 + - *88 - name: subject_digest description: The parameter should be set to the attestation's subject's SHA256 digest, in the form `sha256:HEX_DIGEST`. @@ -59562,7 +60148,7 @@ paths: bundle_url: type: string examples: - default: *421 + default: *423 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -59582,8 +60168,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/autolinks#get-all-autolinks-of-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -59591,7 +60177,7 @@ paths: application/json: schema: type: array - items: &422 + items: &424 title: Autolink reference description: An autolink reference. type: object @@ -59645,8 +60231,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/autolinks#create-an-autolink-reference-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -59685,9 +60271,9 @@ paths: description: response content: application/json: - schema: *422 + schema: *424 examples: - default: &423 + default: &425 value: id: 1 key_prefix: TICKET- @@ -59718,9 +60304,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/autolinks#get-an-autolink-reference-of-a-repository parameters: - - *368 - - *369 - - &424 + - *370 + - *371 + - &426 name: autolink_id description: The unique identifier of the autolink. in: path @@ -59732,9 +60318,9 @@ paths: description: Response content: application/json: - schema: *422 + schema: *424 examples: - default: *423 + default: *425 '404': *6 x-github: githubCloudOnly: false @@ -59754,9 +60340,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/autolinks#delete-an-autolink-reference-from-a-repository parameters: - - *368 - - *369 - - *424 + - *370 + - *371 + - *426 responses: '204': description: Response @@ -59780,8 +60366,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#check-if-dependabot-security-updates-are-enabled-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response if Dependabot is enabled @@ -59831,8 +60417,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#enable-dependabot-security-updates parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response @@ -59853,8 +60439,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#disable-dependabot-security-updates parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response @@ -59874,8 +60460,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branches#list-branches parameters: - - *368 - - *369 + - *370 + - *371 - name: protected description: Setting to `true` returns only branches protected by branch protections or rulesets. When set to `false`, only unprotected branches are returned. @@ -59913,7 +60499,7 @@ paths: - url protected: type: boolean - protection: &426 + protection: &428 title: Branch Protection description: Branch Protection type: object @@ -59956,7 +60542,7 @@ paths: required: - contexts - checks - enforce_admins: &429 + enforce_admins: &431 title: Protected Branch Admin Enforced description: Protected Branch Admin Enforced type: object @@ -59973,7 +60559,7 @@ paths: required: - url - enabled - required_pull_request_reviews: &431 + required_pull_request_reviews: &433 title: Protected Branch Pull Request Review description: Protected Branch Pull Request Review type: object @@ -59995,7 +60581,7 @@ paths: description: The list of teams with review dismissal access. type: array - items: *224 + items: *226 apps: description: The list of apps with review dismissal access. @@ -60027,7 +60613,7 @@ paths: description: The list of teams allowed to bypass pull request requirements. type: array - items: *224 + items: *226 apps: description: The list of apps allowed to bypass pull request requirements. @@ -60057,7 +60643,7 @@ paths: required: - dismiss_stale_reviews - require_code_owner_reviews - restrictions: &428 + restrictions: &430 title: Branch Restriction Policy description: Branch Restriction Policy type: object @@ -60382,9 +60968,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branches#get-a-branch parameters: - - *368 - - *369 - - &427 + - *370 + - *371 + - &429 name: branch description: The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use [the GraphQL API](https://docs.github.com/enterprise-cloud@latest//graphql). @@ -60398,14 +60984,14 @@ paths: description: Response content: application/json: - schema: &437 + schema: &439 title: Branch With Protection description: Branch With Protection type: object properties: name: type: string - commit: &486 + commit: &488 title: Commit description: Commit type: object @@ -60444,7 +61030,7 @@ paths: author: anyOf: - type: 'null' - - &425 + - &427 title: Git User description: Metaproperties for Git author/committer information. @@ -60465,7 +61051,7 @@ paths: committer: anyOf: - type: 'null' - - *425 + - *427 message: type: string examples: @@ -60489,7 +61075,7 @@ paths: required: - sha - url - verification: &544 + verification: &546 title: Verification type: object properties: @@ -60525,14 +61111,14 @@ paths: author: oneOf: - *4 - - *204 + - *206 type: - 'null' - object committer: oneOf: - *4 - - *204 + - *206 type: - 'null' - object @@ -60569,7 +61155,7 @@ paths: type: integer files: type: array - items: &498 + items: &500 title: Diff Entry description: Diff Entry type: object @@ -60663,7 +61249,7 @@ paths: - self protected: type: boolean - protection: *426 + protection: *428 protection_url: type: string format: uri @@ -60772,7 +61358,7 @@ paths: contexts: [] checks: [] protection_url: https://api.github.com/repos/octocat/Hello-World/branches/main/protection - '301': *382 + '301': *384 '404': *6 x-github: githubCloudOnly: false @@ -60794,15 +61380,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-branch-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '200': description: Response content: application/json: - schema: *426 + schema: *428 examples: default: value: @@ -60996,9 +61582,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#update-branch-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: true content: @@ -61258,7 +61844,7 @@ paths: url: type: string format: uri - required_status_checks: &434 + required_status_checks: &436 title: Status Check Policy description: Status Check Policy type: object @@ -61339,7 +61925,7 @@ paths: items: *4 teams: type: array - items: *224 + items: *226 apps: type: array items: *5 @@ -61357,7 +61943,7 @@ paths: items: *4 teams: type: array - items: *224 + items: *226 apps: type: array items: *5 @@ -61417,7 +62003,7 @@ paths: additionalProperties: false required: - enabled - restrictions: *428 + restrictions: *430 required_conversation_resolution: type: object properties: @@ -61529,9 +62115,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#delete-branch-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '204': description: Response @@ -61556,17 +62142,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-admin-branch-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '200': description: Response content: application/json: - schema: *429 + schema: *431 examples: - default: &430 + default: &432 value: url: https://api.github.com/repos/octocat/Hello-World/branches/master/protection/enforce_admins enabled: true @@ -61588,17 +62174,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#set-admin-branch-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '200': description: Response content: application/json: - schema: *429 + schema: *431 examples: - default: *430 + default: *432 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -61617,9 +62203,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#delete-admin-branch-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '204': description: Response @@ -61644,17 +62230,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-pull-request-review-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '200': description: Response content: application/json: - schema: *431 + schema: *433 examples: - default: &432 + default: &434 value: url: https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_pull_request_reviews dismissal_restrictions: @@ -61750,9 +62336,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#update-pull-request-review-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: false content: @@ -61850,9 +62436,9 @@ paths: description: Response content: application/json: - schema: *431 + schema: *433 examples: - default: *432 + default: *434 '422': *15 x-github: githubCloudOnly: false @@ -61873,9 +62459,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#delete-pull-request-review-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '204': description: Response @@ -61902,17 +62488,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-commit-signature-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '200': description: Response content: application/json: - schema: *429 + schema: *431 examples: - default: &433 + default: &435 value: url: https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_signatures enabled: true @@ -61935,17 +62521,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#create-commit-signature-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '200': description: Response content: application/json: - schema: *429 + schema: *431 examples: - default: *433 + default: *435 '404': *6 x-github: githubCloudOnly: false @@ -61965,9 +62551,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#delete-commit-signature-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '204': description: Response @@ -61992,17 +62578,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-status-checks-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '200': description: Response content: application/json: - schema: *434 + schema: *436 examples: - default: &435 + default: &437 value: url: https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_status_checks strict: true @@ -62028,9 +62614,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#update-status-check-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: false content: @@ -62082,9 +62668,9 @@ paths: description: Response content: application/json: - schema: *434 + schema: *436 examples: - default: *435 + default: *437 '404': *6 '422': *15 x-github: @@ -62106,9 +62692,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#remove-status-check-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '204': description: Response @@ -62132,9 +62718,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-all-status-check-contexts parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '200': description: Response @@ -62168,9 +62754,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#add-status-check-contexts parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: false content: @@ -62237,9 +62823,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#set-status-check-contexts parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: false content: @@ -62303,9 +62889,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#remove-status-check-contexts parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: content: application/json: @@ -62371,15 +62957,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-access-restrictions parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '200': description: Response content: application/json: - schema: *428 + schema: *430 examples: default: value: @@ -62470,9 +63056,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#delete-access-restrictions parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '204': description: Response @@ -62495,9 +63081,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-apps-with-access-to-the-protected-branch parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '200': description: Response @@ -62507,7 +63093,7 @@ paths: type: array items: *5 examples: - default: &436 + default: &438 value: - id: 1 slug: octoapp @@ -62564,9 +63150,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#add-app-access-restrictions parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: true content: @@ -62600,7 +63186,7 @@ paths: type: array items: *5 examples: - default: *436 + default: *438 '422': *15 x-github: githubCloudOnly: false @@ -62621,9 +63207,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#set-app-access-restrictions parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: true content: @@ -62657,7 +63243,7 @@ paths: type: array items: *5 examples: - default: *436 + default: *438 '422': *15 x-github: githubCloudOnly: false @@ -62678,9 +63264,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#remove-app-access-restrictions parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: true content: @@ -62714,7 +63300,7 @@ paths: type: array items: *5 examples: - default: *436 + default: *438 '422': *15 x-github: githubCloudOnly: false @@ -62736,9 +63322,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-teams-with-access-to-the-protected-branch parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '200': description: Response @@ -62746,9 +63332,9 @@ paths: application/json: schema: type: array - items: *224 + items: *226 examples: - default: *298 + default: *300 '404': *6 x-github: githubCloudOnly: false @@ -62768,9 +63354,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#add-team-access-restrictions parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: false content: @@ -62806,9 +63392,9 @@ paths: application/json: schema: type: array - items: *224 + items: *226 examples: - default: *298 + default: *300 '422': *15 x-github: githubCloudOnly: false @@ -62829,9 +63415,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#set-team-access-restrictions parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: false content: @@ -62867,9 +63453,9 @@ paths: application/json: schema: type: array - items: *224 + items: *226 examples: - default: *298 + default: *300 '422': *15 x-github: githubCloudOnly: false @@ -62890,9 +63476,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#remove-team-access-restrictions parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: content: application/json: @@ -62927,9 +63513,9 @@ paths: application/json: schema: type: array - items: *224 + items: *226 examples: - default: *298 + default: *300 '422': *15 x-github: githubCloudOnly: false @@ -62951,9 +63537,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-users-with-access-to-the-protected-branch parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '200': description: Response @@ -62963,7 +63549,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 '404': *6 x-github: githubCloudOnly: false @@ -62987,9 +63573,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#add-user-access-restrictions parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: true content: @@ -63022,7 +63608,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 '422': *15 x-github: githubCloudOnly: false @@ -63047,9 +63633,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#set-user-access-restrictions parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: true content: @@ -63082,7 +63668,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 '422': *15 x-github: githubCloudOnly: false @@ -63107,9 +63693,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#remove-user-access-restrictions parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: true content: @@ -63142,7 +63728,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 '422': *15 x-github: githubCloudOnly: false @@ -63169,9 +63755,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branches#rename-a-branch parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: true content: @@ -63193,7 +63779,7 @@ paths: description: Response content: application/json: - schema: *437 + schema: *439 examples: default: value: @@ -63307,12 +63893,12 @@ paths: category: repos subcategory: bypass-requests parameters: - - *368 - - *369 - - *216 - - *217 + - *370 + - *371 - *218 - *219 + - *220 + - *221 - *17 - *19 responses: @@ -63322,11 +63908,11 @@ paths: application/json: schema: type: array - items: *220 + items: *222 examples: - default: *221 + default: *223 '404': *6 - '500': *83 + '500': *86 "/repos/{owner}/{repo}/bypass-requests/push-rules/{bypass_request_number}": get: summary: Get a repository push bypass request @@ -63344,8 +63930,8 @@ paths: category: repos subcategory: bypass-requests parameters: - - *368 - - *369 + - *370 + - *371 - name: bypass_request_number in: path required: true @@ -63359,7 +63945,7 @@ paths: description: Response content: application/json: - schema: *220 + schema: *222 examples: default: value: @@ -63397,7 +63983,7 @@ paths: url: https://api.github.com/repos/octo-org/smile/bypass-requests/push-rules/2 html_url: https://github.com/octo-org/smile/exemptions/2 '404': *6 - '500': *83 + '500': *86 "/repos/{owner}/{repo}/bypass-requests/secret-scanning": get: summary: List bypass requests for secret scanning for a repository @@ -63418,12 +64004,12 @@ paths: category: secret-scanning subcategory: delegated-bypass parameters: - - *368 - - *369 - - *216 - - *217 + - *370 + - *371 - *218 - *219 + - *220 + - *221 - *17 - *19 responses: @@ -63433,12 +64019,12 @@ paths: application/json: schema: type: array - items: *438 + items: *440 examples: - default: *439 + default: *441 '404': *6 '403': *27 - '500': *83 + '500': *86 "/repos/{owner}/{repo}/bypass-requests/secret-scanning/{bypass_request_number}": get: summary: Get a bypass request for secret scanning @@ -63459,8 +64045,8 @@ paths: category: secret-scanning subcategory: delegated-bypass parameters: - - *368 - - *369 + - *370 + - *371 - name: bypass_request_number in: path required: true @@ -63472,7 +64058,7 @@ paths: description: A single bypass request. content: application/json: - schema: *438 + schema: *440 examples: default: value: @@ -63510,7 +64096,7 @@ paths: html_url: https://github.com/octo-org/smile/exemptions/1 '404': *6 '403': *27 - '500': *83 + '500': *86 patch: summary: Review a bypass request for secret scanning description: |- @@ -63530,8 +64116,8 @@ paths: category: secret-scanning subcategory: delegated-bypass parameters: - - *368 - - *369 + - *370 + - *371 - name: bypass_request_number in: path required: true @@ -63581,7 +64167,7 @@ paths: '404': *6 '403': *27 '422': *15 - '500': *83 + '500': *86 "/repos/{owner}/{repo}/bypass-responses/secret-scanning/{bypass_response_id}": delete: summary: Dismiss a response on a bypass request for secret scanning @@ -63602,8 +64188,8 @@ paths: category: secret-scanning subcategory: delegated-bypass parameters: - - *368 - - *369 + - *370 + - *371 - name: bypass_response_id in: path required: true @@ -63616,7 +64202,7 @@ paths: '404': *6 '403': *27 '422': *15 - '500': *83 + '500': *86 "/repos/{owner}/{repo}/check-runs": post: summary: Create a check run @@ -63636,8 +64222,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/runs#create-a-check-run parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -63916,7 +64502,7 @@ paths: description: Response content: application/json: - schema: &441 + schema: &443 title: CheckRun description: A check performed on the code of a given code change type: object @@ -64051,8 +64637,8 @@ paths: do not necessarily indicate pull requests that triggered the check. type: array - items: *440 - deployment: &775 + items: *442 + deployment: &777 title: Deployment description: A deployment created as the result of an Actions check run from a workflow that references an environment @@ -64339,9 +64925,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/runs#get-a-check-run parameters: - - *368 - - *369 - - &442 + - *370 + - *371 + - &444 name: check_run_id description: The unique identifier of the check run. in: path @@ -64353,9 +64939,9 @@ paths: description: Response content: application/json: - schema: *441 + schema: *443 examples: - default: &443 + default: &445 value: id: 4 head_sha: ce587453ced02b1526dfb4cb910479d431683101 @@ -64455,9 +65041,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/runs#update-a-check-run parameters: - - *368 - - *369 - - *442 + - *370 + - *371 + - *444 requestBody: required: true content: @@ -64697,9 +65283,9 @@ paths: description: Response content: application/json: - schema: *441 + schema: *443 examples: - default: *443 + default: *445 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -64719,9 +65305,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/runs#list-check-run-annotations parameters: - - *368 - - *369 - - *442 + - *370 + - *371 + - *444 - *17 - *19 responses: @@ -64831,15 +65417,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/runs#rerequest-a-check-run parameters: - - *368 - - *369 - - *442 + - *370 + - *371 + - *444 responses: '201': description: Response content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -64877,8 +65463,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/suites#create-a-check-suite parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -64900,7 +65486,7 @@ paths: description: Response when the suite already exists content: application/json: - schema: &445 + schema: &447 title: CheckSuite description: A suite of checks performed on the code of a given code change @@ -64982,12 +65568,12 @@ paths: type: - array - 'null' - items: *440 + items: *442 app: anyOf: - type: 'null' - *5 - repository: *193 + repository: *195 created_at: type: - string @@ -64998,7 +65584,7 @@ paths: - string - 'null' format: date-time - head_commit: *444 + head_commit: *446 latest_check_runs_count: type: integer check_runs_url: @@ -65026,7 +65612,7 @@ paths: - check_runs_url - pull_requests examples: - default: &446 + default: &448 value: id: 5 node_id: MDEwOkNoZWNrU3VpdGU1 @@ -65317,9 +65903,9 @@ paths: description: Response when the suite was created content: application/json: - schema: *445 + schema: *447 examples: - default: *446 + default: *448 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -65338,8 +65924,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/suites#update-repository-preferences-for-check-suites parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -65400,7 +65986,7 @@ paths: required: - app_id - setting - repository: *193 + repository: *195 examples: default: value: @@ -65648,9 +66234,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/suites#get-a-check-suite parameters: - - *368 - - *369 - - &447 + - *370 + - *371 + - &449 name: check_suite_id description: The unique identifier of the check suite. in: path @@ -65662,9 +66248,9 @@ paths: description: Response content: application/json: - schema: *445 + schema: *447 examples: - default: *446 + default: *448 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -65687,17 +66273,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/runs#list-check-runs-in-a-check-suite parameters: - - *368 - - *369 - - *447 - - &493 + - *370 + - *371 + - *449 + - &495 name: check_name description: Returns check runs with the specified `name`. in: query required: false schema: type: string - - &494 + - &496 name: status description: Returns check runs with the specified `status`. in: query @@ -65736,9 +66322,9 @@ paths: type: integer check_runs: type: array - items: *441 + items: *443 examples: - default: &495 + default: &497 value: total_count: 1 check_runs: @@ -65840,15 +66426,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/suites#rerequest-a-check-suite parameters: - - *368 - - *369 - - *447 + - *370 + - *371 + - *449 responses: '201': description: Response content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -65875,30 +66461,30 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#list-code-scanning-alerts-for-a-repository parameters: - - *368 - - *369 - - *228 - - *229 + - *370 + - *371 + - *230 + - *231 - *19 - *17 - - &463 + - &465 name: ref description: The Git reference for the results you want to list. The `ref` for a branch can be formatted either as `refs/heads/` or simply ``. To reference a pull request use `refs/pull//merge`. in: query required: false - schema: *448 - - &464 + schema: *450 + - &466 name: pr description: The number of the pull request for the results you want to list. in: query required: false schema: type: integer - - *86 - - *84 - - *85 + - *89 + - *87 + - *88 - name: sort description: The property by which to sort the results. in: query @@ -65914,13 +66500,13 @@ paths: be returned. in: query required: false - schema: *230 + schema: *232 - name: severity description: If specified, only code scanning alerts with this severity will be returned. in: query required: false - schema: *449 + schema: *451 responses: '200': description: Response @@ -65931,24 +66517,24 @@ paths: items: type: object properties: - number: *96 - created_at: *103 - updated_at: *104 - url: *101 - html_url: *102 - instances_url: *450 - state: *89 - fixed_at: *106 + number: *99 + created_at: *106 + updated_at: *107 + url: *104 + html_url: *105 + instances_url: *452 + state: *92 + fixed_at: *109 dismissed_by: anyOf: - type: 'null' - *4 - dismissed_at: *105 - dismissed_reason: *451 - dismissed_comment: *452 - rule: *453 - tool: *454 - most_recent_instance: *455 + dismissed_at: *108 + dismissed_reason: *453 + dismissed_comment: *454 + rule: *455 + tool: *456 + most_recent_instance: *457 dismissal_approved_by: anyOf: - type: 'null' @@ -66068,14 +66654,14 @@ paths: classifications: [] instances_url: https://api.github.com/repos/octocat/hello-world/code-scanning/alerts/3/instances '304': *35 - '403': &456 + '403': &458 description: Response if GitHub Advanced Security is not enabled for this repository content: application/json: schema: *3 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -66095,9 +66681,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#get-a-code-scanning-alert parameters: - - *368 - - *369 - - &457 + - *370 + - *371 + - &459 name: alert_number in: path description: The number that identifies an alert. You can find this at the @@ -66105,30 +66691,30 @@ paths: field in the response from the `GET /repos/{owner}/{repo}/code-scanning/alerts` operation. required: true - schema: *96 + schema: *99 responses: '200': description: Response content: application/json: - schema: &458 + schema: &460 type: object properties: - number: *96 - created_at: *103 - updated_at: *104 - url: *101 - html_url: *102 - instances_url: *450 - state: *89 - fixed_at: *106 + number: *99 + created_at: *106 + updated_at: *107 + url: *104 + html_url: *105 + instances_url: *452 + state: *92 + fixed_at: *109 dismissed_by: anyOf: - type: 'null' - *4 - dismissed_at: *105 - dismissed_reason: *451 - dismissed_comment: *452 + dismissed_at: *108 + dismissed_reason: *453 + dismissed_comment: *454 rule: type: object properties: @@ -66190,8 +66776,8 @@ paths: - 'null' description: A link to the documentation for the rule used to detect the alert. - tool: *454 - most_recent_instance: *455 + tool: *456 + most_recent_instance: *457 dismissal_approved_by: anyOf: - type: 'null' @@ -66284,9 +66870,9 @@ paths: - test instances_url: https://api.github.com/repos/octocat/hello-world/code-scanning/alerts/42/instances '304': *35 - '403': *456 + '403': *458 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -66304,9 +66890,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#update-a-code-scanning-alert parameters: - - *368 - - *369 - - *457 + - *370 + - *371 + - *459 requestBody: required: true content: @@ -66321,8 +66907,8 @@ paths: enum: - open - dismissed - dismissed_reason: *451 - dismissed_comment: *452 + dismissed_reason: *453 + dismissed_comment: *454 create_request: type: boolean description: If `true`, attempt to create an alert dismissal request. @@ -66341,7 +66927,7 @@ paths: description: Response content: application/json: - schema: *458 + schema: *460 examples: default: value: @@ -66417,14 +67003,14 @@ paths: - test instances_url: https://api.github.com/repos/octocat/hello-world/code-scanning/alerts/42/instances '400': *14 - '403': &462 + '403': &464 description: Response if the repository is archived or if GitHub Advanced Security is not enabled for this repository content: application/json: schema: *3 '404': *6 - '503': *130 + '503': *133 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -66444,15 +67030,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#get-the-status-of-an-autofix-for-a-code-scanning-alert parameters: - - *368 - - *369 - - *457 + - *370 + - *371 + - *459 responses: '200': description: Response content: application/json: - schema: &459 + schema: &461 type: object properties: status: @@ -66479,13 +67065,13 @@ paths: - description - started_at examples: - default: &460 + default: &462 value: status: success description: This fixes an XSS vulnerability by escaping the user input. started_at: '2024-02-14T12:29:18Z' - '400': &461 + '400': &463 description: Bad Request content: application/json: @@ -66496,9 +67082,9 @@ paths: message: The alert_number is not valid documentation_url: https://docs.github.com/rest/code-scanning/code-scanning#get-the-status-of-an-autofix-for-a-code-scanning-alert status: '400' - '403': *456 + '403': *458 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -66521,29 +67107,29 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#create-an-autofix-for-a-code-scanning-alert parameters: - - *368 - - *369 - - *457 + - *370 + - *371 + - *459 responses: '200': description: OK content: application/json: - schema: *459 + schema: *461 examples: - default: *460 + default: *462 '202': description: Accepted content: application/json: - schema: *459 + schema: *461 examples: default: value: status: pending description: started_at: '2024-02-14T12:29:18Z' - '400': *461 + '400': *463 '403': description: Response if the repository is archived, if GitHub Advanced Security is not enabled for this repository or if rate limit is exceeded @@ -66553,7 +67139,7 @@ paths: '404': *6 '422': description: Unprocessable Entity - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -66575,9 +67161,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#commit-an-autofix-for-a-code-scanning-alert parameters: - - *368 - - *369 - - *457 + - *370 + - *371 + - *459 requestBody: required: false content: @@ -66623,12 +67209,12 @@ paths: value: target_ref: refs/heads/main sha: 178f4f6090b3fccad4a65b3e83d076a622d59652 - '400': *461 - '403': *462 + '400': *463 + '403': *464 '404': *6 '422': description: Unprocessable Entity - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -66648,13 +67234,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#list-instances-of-a-code-scanning-alert parameters: - - *368 - - *369 - - *457 + - *370 + - *371 + - *459 - *19 - *17 - - *463 - - *464 + - *465 + - *466 responses: '200': description: Response @@ -66662,7 +67248,7 @@ paths: application/json: schema: type: array - items: *455 + items: *457 examples: default: value: @@ -66701,9 +67287,9 @@ paths: end_column: 50 classifications: - source - '403': *456 + '403': *458 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -66735,30 +67321,30 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#list-code-scanning-analyses-for-a-repository parameters: - - *368 - - *369 - - *228 - - *229 + - *370 + - *371 + - *230 + - *231 - *19 - *17 - - *464 + - *466 - name: ref in: query description: The Git reference for the analyses you want to list. The `ref` for a branch can be formatted either as `refs/heads/` or simply ``. To reference a pull request use `refs/pull//merge`. required: false - schema: *448 + schema: *450 - name: sarif_id in: query description: Filter analyses belonging to the same SARIF upload. required: false - schema: &467 + schema: &469 type: string description: An identifier for the upload. examples: - 6c81cd8e-b078-4ac3-a3be-1dad7dbd0b53 - - *86 + - *89 - name: sort description: The property by which to sort the results. in: query @@ -66775,23 +67361,23 @@ paths: application/json: schema: type: array - items: &468 + items: &470 type: object properties: - ref: *448 - commit_sha: &476 + ref: *450 + commit_sha: &478 description: The SHA of the commit to which the analysis you are uploading relates. type: string minLength: 40 maxLength: 40 pattern: "^[0-9a-fA-F]+$" - analysis_key: *465 + analysis_key: *467 environment: type: string description: Identifies the variable values associated with the environment in which this analysis was performed. - category: *466 + category: *468 error: type: string examples: @@ -66816,8 +67402,8 @@ paths: description: The REST API URL of the analysis resource. format: uri readOnly: true - sarif_id: *467 - tool: *454 + sarif_id: *469 + tool: *456 deletable: type: boolean warning: @@ -66879,9 +67465,9 @@ paths: version: 1.2.0 deletable: true warning: '' - '403': *456 + '403': *458 '404': *6 - '503': *130 + '503': *133 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -66915,8 +67501,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#get-a-code-scanning-analysis-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - name: analysis_id in: path description: The ID of the analysis, as returned from the `GET /repos/{owner}/{repo}/code-scanning/analyses` @@ -66929,7 +67515,7 @@ paths: description: Response content: application/json: - schema: *468 + schema: *470 examples: response: summary: application/json response @@ -66983,14 +67569,14 @@ paths: properties: - github/alertNumber: 2 - github/alertUrl: https://api.github.com/repos/monalisa/monalisa/code-scanning/alerts/2 - '403': *456 + '403': *458 '404': *6 '422': description: Response if analysis could not be processed content: application/json: schema: *3 - '503': *130 + '503': *133 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -67070,8 +67656,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#delete-a-code-scanning-analysis-from-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - name: analysis_id in: path description: The ID of the analysis, as returned from the `GET /repos/{owner}/{repo}/code-scanning/analyses` @@ -67127,9 +67713,9 @@ paths: next_analysis_url: https://api.github.com/repos/octocat/hello-world/code-scanning/analyses/41 confirm_delete_url: https://api.github.com/repos/octocat/hello-world/code-scanning/analyses/41?confirm_delete '400': *14 - '403': *462 + '403': *464 '404': *6 - '503': *130 + '503': *133 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -67149,8 +67735,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#list-codeql-databases-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -67158,7 +67744,7 @@ paths: application/json: schema: type: array - items: &469 + items: &471 title: CodeQL Database description: A CodeQL database. type: object @@ -67270,9 +67856,9 @@ paths: updated_at: '2022-09-12T12:14:32Z' url: https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/ruby commit_oid: 1927de39fefa25a9d0e64e3f540ff824a72f538c - '403': *456 + '403': *458 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -67299,8 +67885,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#get-a-codeql-database-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - name: language in: path description: The language of the CodeQL database. @@ -67312,7 +67898,7 @@ paths: description: Response content: application/json: - schema: *469 + schema: *471 examples: default: value: @@ -67344,11 +67930,11 @@ paths: updated_at: '2022-09-12T12:14:32Z' url: https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/java commit_oid: 1927de39fefa25a9d0e64e3f540ff824a72f538c - '302': &500 + '302': &502 description: Found - '403': *456 + '403': *458 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -67368,8 +67954,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#delete-a-codeql-database parameters: - - *368 - - *369 + - *370 + - *371 - name: language in: path description: The language of the CodeQL database. @@ -67379,9 +67965,9 @@ paths: responses: '204': description: Response - '403': *462 + '403': *464 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -67407,8 +67993,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#create-a-codeql-variant-analysis parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -67417,7 +68003,7 @@ paths: type: object additionalProperties: false properties: - language: &470 + language: &472 type: string description: The language targeted by the CodeQL query enum: @@ -67496,7 +68082,7 @@ paths: description: Variant analysis submitted for processing content: application/json: - schema: &474 + schema: &476 title: Variant Analysis description: A run of a CodeQL query against one or more repositories. type: object @@ -67504,9 +68090,9 @@ paths: id: type: integer description: The ID of the variant analysis. - controller_repo: *95 + controller_repo: *98 actor: *4 - query_language: *470 + query_language: *472 query_pack_url: type: string description: The download url for the query pack. @@ -67554,7 +68140,7 @@ paths: items: type: object properties: - repository: &471 + repository: &473 title: Repository Identifier description: Repository Identifier type: object @@ -67596,7 +68182,7 @@ paths: - private - stargazers_count - updated_at - analysis_status: &475 + analysis_status: &477 type: string description: The new status of the CodeQL variant analysis repository task. @@ -67628,7 +68214,7 @@ paths: from processing. This information is only available to the user that initiated the variant analysis. properties: - access_mismatch_repos: &472 + access_mismatch_repos: &474 type: object properties: repository_count: @@ -67643,7 +68229,7 @@ paths: This list may not include all repositories that were skipped. This is only available when the repository was found and the user has access to it. - items: *471 + items: *473 required: - repository_count - repositories @@ -67666,8 +68252,8 @@ paths: required: - repository_count - repository_full_names - no_codeql_db_repos: *472 - over_limit_repos: *472 + no_codeql_db_repos: *474 + over_limit_repos: *474 required: - access_mismatch_repos - not_found_repos @@ -67683,7 +68269,7 @@ paths: examples: repositories_parameter: summary: Response for a successful variant analysis submission - value: &473 + value: &475 summary: Default response value: id: 1 @@ -67835,17 +68421,17 @@ paths: private: false repository_owners: summary: Response for a successful variant analysis submission - value: *473 + value: *475 repository_lists: summary: Response for a successful variant analysis submission - value: *473 + value: *475 '404': *6 '422': description: Unable to process variant analysis submission content: application/json: schema: *3 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -67866,8 +68452,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#get-the-summary-of-a-codeql-variant-analysis parameters: - - *368 - - *369 + - *370 + - *371 - name: codeql_variant_analysis_id in: path description: The unique identifier of the variant analysis. @@ -67879,11 +68465,11 @@ paths: description: Response content: application/json: - schema: *474 + schema: *476 examples: - default: *473 + default: *475 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -67904,7 +68490,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#get-the-analysis-status-of-a-repository-in-a-codeql-variant-analysis parameters: - - *368 + - *370 - name: repo in: path description: The name of the controller repository. @@ -67938,8 +68524,8 @@ paths: schema: type: object properties: - repository: *95 - analysis_status: *475 + repository: *98 + analysis_status: *477 artifact_size_in_bytes: type: integer description: The size of the artifact. This is only available @@ -68043,7 +68629,7 @@ paths: source_location_prefix: "/" artifact_url: https://example.com '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -68064,8 +68650,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#get-a-code-scanning-default-setup-configuration parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -68158,9 +68744,9 @@ paths: threat_model: remote updated_at: '2023-01-19T11:21:34Z' schedule: weekly - '403': *456 + '403': *458 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -68179,8 +68765,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#update-a-code-scanning-default-setup-configuration parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -68249,7 +68835,7 @@ paths: description: Response content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -68274,7 +68860,7 @@ paths: value: run_id: 42 run_url: https://api.github.com/repos/octoorg/octocat/actions/runs/42 - '403': *462 + '403': *464 '404': *6 '409': description: Response if there is already a validation run in progress with @@ -68282,7 +68868,7 @@ paths: content: application/json: schema: *3 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -68339,8 +68925,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#upload-an-analysis-as-sarif-data parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -68348,7 +68934,7 @@ paths: schema: type: object properties: - commit_sha: *476 + commit_sha: *478 ref: type: string description: |- @@ -68408,7 +68994,7 @@ paths: schema: type: object properties: - id: *467 + id: *469 url: type: string description: The REST API URL for checking the status of the upload. @@ -68422,11 +69008,11 @@ paths: url: https://api.github.com/repos/octocat/hello-world/code-scanning/sarifs/47177e22-5596-11eb-80a1-c1e54ef945c6 '400': description: Bad Request if the sarif field is invalid - '403': *462 + '403': *464 '404': *6 '413': description: Payload Too Large if the sarif field is too large - '503': *130 + '503': *133 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -68445,8 +69031,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#get-information-about-a-sarif-upload parameters: - - *368 - - *369 + - *370 + - *371 - name: sarif_id description: The SARIF ID obtained after uploading. in: path @@ -68494,10 +69080,10 @@ paths: value: processing_status: complete analyses_url: https://api.github.com/repos/octocat/hello-world/code-scanning/analyses?sarif_id=47177e22-5596-11eb-80a1-c1e54ef945c6 - '403': *456 + '403': *458 '404': description: Not Found if the sarif id does not match any upload - '503': *130 + '503': *133 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -68519,8 +69105,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#get-the-code-security-configuration-associated-with-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -68544,7 +69130,7 @@ paths: - failed - updating - removed_by_enterprise - configuration: *90 + configuration: *93 examples: default: value: @@ -68576,7 +69162,7 @@ paths: html_url: https://github.com/organizations/octo-org/settings/security_products/configurations/edit/1325 created_at: '2024-05-01T00:00:00Z' updated_at: '2024-05-01T00:00:00Z' - '204': *116 + '204': *119 '304': *35 '403': *27 '404': *6 @@ -68601,8 +69187,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#list-codeowners-errors parameters: - - *368 - - *369 + - *370 + - *371 - name: ref description: 'A branch, tag or commit name used to determine which version of the CODEOWNERS file to use. Default: the repository''s default branch @@ -68730,8 +69316,8 @@ paths: parameters: - *17 - *19 - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -68747,7 +69333,7 @@ paths: type: integer codespaces: type: array - items: *288 + items: *290 examples: default: value: @@ -69023,7 +69609,7 @@ paths: start_url: https://api.github.com/user/codespaces/monalisa-octocat-hello-world-3f89ada1j3/start stop_url: https://api.github.com/user/codespaces/monalisa-octocat-hello-world-3f89ada1j3/stop recent_folders: [] - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -69045,8 +69631,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#create-a-codespace-in-a-repository parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -69110,22 +69696,22 @@ paths: description: Response when the codespace was successfully created content: application/json: - schema: *288 + schema: *290 examples: - default: *477 + default: *479 '202': description: Response when the codespace creation partially failed but is being retried in the background content: application/json: - schema: *288 + schema: *290 examples: - default: *477 + default: *479 '400': *14 '401': *23 '403': *27 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -69149,8 +69735,8 @@ paths: parameters: - *17 - *19 - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -69190,7 +69776,7 @@ paths: - path: ".devcontainer.json" display_name: Default project configuration total_count: 3 - '500': *83 + '500': *86 '400': *14 '401': *23 '403': *27 @@ -69214,8 +69800,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/machines#list-available-machine-types-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - name: location description: The location to check for available machines. Assigned by IP if not provided. @@ -69252,9 +69838,9 @@ paths: type: integer machines: type: array - items: *478 + items: *480 examples: - default: &729 + default: &731 value: total_count: 2 machines: @@ -69271,7 +69857,7 @@ paths: memory_in_bytes: 34359738368 cpus: 8 '304': *35 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -69294,8 +69880,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#get-default-attributes-for-a-codespace parameters: - - *368 - - *369 + - *370 + - *371 - name: ref description: The branch or commit to check for a default devcontainer path. If not specified, the default branch will be checked. @@ -69382,8 +69968,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#check-if-permissions-defined-by-a-devcontainer-have-been-accepted-by-the-authenticated-user parameters: - - *368 - - *369 + - *370 + - *371 - name: ref description: The git reference that points to the location of the devcontainer configuration to use for the permission check. The value of `ref` will typically @@ -69431,7 +70017,7 @@ paths: '403': *27 '404': *6 '422': *15 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -69452,8 +70038,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/repository-secrets#list-repository-secrets parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -69471,7 +70057,7 @@ paths: type: integer secrets: type: array - items: &482 + items: &484 title: Codespaces Secret description: Set repository secrets for GitHub Codespaces. type: object @@ -69492,7 +70078,7 @@ paths: - created_at - updated_at examples: - default: *479 + default: *481 headers: Link: *38 x-github: @@ -69515,16 +70101,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/repository-secrets#get-a-repository-public-key parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response content: application/json: - schema: *480 + schema: *482 examples: - default: *481 + default: *483 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -69544,17 +70130,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/repository-secrets#get-a-repository-secret parameters: - - *368 - - *369 - - *203 + - *370 + - *371 + - *205 responses: '200': description: Response content: application/json: - schema: *482 + schema: *484 examples: - default: *483 + default: *485 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -69574,9 +70160,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/repository-secrets#create-or-update-a-repository-secret parameters: - - *368 - - *369 - - *203 + - *370 + - *371 + - *205 requestBody: required: true content: @@ -69604,7 +70190,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -69628,9 +70214,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/repository-secrets#delete-a-repository-secret parameters: - - *368 - - *369 - - *203 + - *370 + - *371 + - *205 responses: '204': description: Response @@ -69658,8 +70244,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/collaborators#list-repository-collaborators parameters: - - *368 - - *369 + - *370 + - *371 - name: affiliation description: Filter collaborators returned by their affiliation. `outside` means all outside collaborators of an organization-owned repository. `direct` @@ -69697,7 +70283,7 @@ paths: application/json: schema: type: array - items: &484 + items: &486 title: Collaborator description: Collaborator type: object @@ -69890,9 +70476,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/collaborators#check-if-a-user-is-a-repository-collaborator parameters: - - *368 - - *369 - - *215 + - *370 + - *371 + - *217 responses: '204': description: Response if user is a collaborator @@ -69938,9 +70524,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/collaborators#add-a-repository-collaborator parameters: - - *368 - - *369 - - *215 + - *370 + - *371 + - *217 requestBody: required: false content: @@ -69966,7 +70552,7 @@ paths: description: Response when a new invitation is created content: application/json: - schema: &557 + schema: &559 title: Repository Invitation description: Repository invitations let you manage who you collaborate with. @@ -69978,7 +70564,7 @@ paths: format: int64 examples: - 42 - repository: *193 + repository: *195 invitee: anyOf: - type: 'null' @@ -70154,7 +70740,7 @@ paths: - an Enterprise Managed User (EMU) account was invited to a repository in an enterprise with personal user accounts content: application/json: - schema: *176 + schema: *178 '403': *27 x-github: triggersNotification: true @@ -70194,9 +70780,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/collaborators#remove-a-repository-collaborator parameters: - - *368 - - *369 - - *215 + - *370 + - *371 + - *217 responses: '204': description: No Content when collaborator was removed from the repository. @@ -70227,9 +70813,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/collaborators#get-repository-permissions-for-a-user parameters: - - *368 - - *369 - - *215 + - *370 + - *371 + - *217 responses: '200': description: if user has admin permissions @@ -70249,7 +70835,7 @@ paths: user: anyOf: - type: 'null' - - *484 + - *486 required: - permission - role_name @@ -70303,8 +70889,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/comments#list-commit-comments-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -70314,7 +70900,7 @@ paths: application/json: schema: type: array - items: &485 + items: &487 title: Commit Comment description: Commit Comment type: object @@ -70355,8 +70941,8 @@ paths: updated_at: type: string format: date-time - author_association: *138 - reactions: *139 + author_association: *141 + reactions: *142 required: - url - html_url @@ -70372,7 +70958,7 @@ paths: - created_at - updated_at examples: - default: &488 + default: &490 value: - html_url: https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e#commitcomment-1 url: https://api.github.com/repos/octocat/Hello-World/comments/1 @@ -70431,17 +71017,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/comments#get-a-commit-comment parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 responses: '200': description: Response content: application/json: - schema: *485 + schema: *487 examples: - default: &489 + default: &491 value: html_url: https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e#commitcomment-1 url: https://api.github.com/repos/octocat/Hello-World/comments/1 @@ -70498,9 +71084,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/comments#update-a-commit-comment parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 requestBody: required: true content: @@ -70522,7 +71108,7 @@ paths: description: Response content: application/json: - schema: *485 + schema: *487 examples: default: value: @@ -70573,9 +71159,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/comments#delete-a-commit-comment parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 responses: '204': description: Response @@ -70596,9 +71182,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#list-reactions-for-a-commit-comment parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 - name: content description: Returns a single [reaction type](https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to a commit comment. @@ -70624,9 +71210,9 @@ paths: application/json: schema: type: array - items: *357 + items: *359 examples: - default: *359 + default: *361 headers: Link: *38 '404': *6 @@ -70647,9 +71233,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#create-reaction-for-a-commit-comment parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 requestBody: required: true content: @@ -70681,16 +71267,16 @@ paths: description: Reaction exists content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 '201': description: Reaction created content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 '422': *15 x-github: githubCloudOnly: false @@ -70712,10 +71298,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#delete-a-commit-comment-reaction parameters: - - *368 - - *369 - - *150 - - *360 + - *370 + - *371 + - *153 + - *362 responses: '204': description: Response @@ -70764,8 +71350,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/commits#list-commits parameters: - - *368 - - *369 + - *370 + - *371 - name: sha description: 'SHA or branch to start listing commits from. Default: the repository’s default branch (usually `main`).' @@ -70821,9 +71407,9 @@ paths: application/json: schema: type: array - items: *486 + items: *488 examples: - default: &605 + default: &607 value: - url: https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e sha: 6dcb09b5b57875f334f61aebed695e2e4193db5e @@ -70894,10 +71480,10 @@ paths: sha: 6dcb09b5b57875f334f61aebed695e2e4193db5e headers: Link: *38 - '500': *83 + '500': *86 '400': *14 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -70917,9 +71503,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/commits#list-branches-for-head-commit parameters: - - *368 - - *369 - - &487 + - *370 + - *371 + - &489 name: commit_sha description: The SHA of the commit. in: path @@ -70966,7 +71552,7 @@ paths: url: https://api.github.com/repos/octocat/Hello-World/commits/c5b97d5ae6c19d5c5df71a34c7fbeeda2479ccbc protected: false '422': *15 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -70991,9 +71577,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/comments#list-commit-comments parameters: - - *368 - - *369 - - *487 + - *370 + - *371 + - *489 - *17 - *19 responses: @@ -71003,9 +71589,9 @@ paths: application/json: schema: type: array - items: *485 + items: *487 examples: - default: *488 + default: *490 headers: Link: *38 x-github: @@ -71033,9 +71619,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/comments#create-a-commit-comment parameters: - - *368 - - *369 - - *487 + - *370 + - *371 + - *489 requestBody: required: true content: @@ -71070,9 +71656,9 @@ paths: description: Response content: application/json: - schema: *485 + schema: *487 examples: - default: *489 + default: *491 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/comments/1 @@ -71100,9 +71686,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/commits#list-pull-requests-associated-with-a-commit parameters: - - *368 - - *369 - - *487 + - *370 + - *371 + - *489 - *17 - *19 responses: @@ -71112,7 +71698,7 @@ paths: application/json: schema: type: array - items: &596 + items: &598 title: Pull Request Simple description: Pull Request Simple type: object @@ -71232,7 +71818,7 @@ paths: milestone: anyOf: - type: 'null' - - *490 + - *492 active_lock_reason: type: - string @@ -71287,7 +71873,7 @@ paths: type: - array - 'null' - items: *224 + items: *226 head: type: object properties: @@ -71331,7 +71917,7 @@ paths: _links: type: object properties: - comments: &491 + comments: &493 title: Link description: Hypermedia Link type: object @@ -71340,13 +71926,13 @@ paths: type: string required: - href - commits: *491 - statuses: *491 - html: *491 - issue: *491 - review_comments: *491 - review_comment: *491 - self: *491 + commits: *493 + statuses: *493 + html: *493 + issue: *493 + review_comments: *493 + review_comment: *493 + self: *493 required: - comments - commits @@ -71356,8 +71942,8 @@ paths: - review_comments - review_comment - self - author_association: *138 - auto_merge: &598 + author_association: *141 + auto_merge: &600 title: Auto merge description: The status of auto merging a pull request. type: @@ -71422,7 +72008,7 @@ paths: - author_association - auto_merge examples: - default: &597 + default: &599 value: - url: https://api.github.com/repos/octocat/Hello-World/pulls/1347 id: 1 @@ -71902,7 +72488,7 @@ paths: draft: false headers: Link: *38 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -71959,11 +72545,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/commits#get-a-commit parameters: - - *368 - - *369 + - *370 + - *371 - *19 - *17 - - &492 + - &494 name: ref description: The commit reference. Can be a commit SHA, branch name (`heads/BRANCH_NAME`), or tag name (`tags/TAG_NAME`). For more information, see "[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)" @@ -71978,9 +72564,9 @@ paths: description: Response content: application/json: - schema: *486 + schema: *488 examples: - default: &584 + default: &586 value: url: https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e sha: 6dcb09b5b57875f334f61aebed695e2e4193db5e @@ -72066,9 +72652,9 @@ paths: ..... '422': *15 '404': *6 - '500': *83 - '503': *130 - '409': *94 + '500': *86 + '503': *133 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -72093,11 +72679,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/runs#list-check-runs-for-a-git-reference parameters: - - *368 - - *369 - - *492 - - *493 + - *370 + - *371 - *494 + - *495 + - *496 - name: filter description: Filters check runs by their `completed_at` timestamp. `latest` returns the most recent check runs. @@ -72131,9 +72717,9 @@ paths: type: integer check_runs: type: array - items: *441 + items: *443 examples: - default: *495 + default: *497 headers: Link: *38 x-github: @@ -72158,9 +72744,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/suites#list-check-suites-for-a-git-reference parameters: - - *368 - - *369 - - *492 + - *370 + - *371 + - *494 - name: app_id description: Filters check suites by GitHub App `id`. in: query @@ -72168,7 +72754,7 @@ paths: schema: type: integer example: 1 - - *493 + - *495 - *17 - *19 responses: @@ -72186,7 +72772,7 @@ paths: type: integer check_suites: type: array - items: *445 + items: *447 examples: default: value: @@ -72386,9 +72972,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/statuses#get-the-combined-status-for-a-specific-reference parameters: - - *368 - - *369 - - *492 + - *370 + - *371 + - *494 - *17 - *19 responses: @@ -72459,7 +73045,7 @@ paths: type: string total_count: type: integer - repository: *193 + repository: *195 commit_url: type: string format: uri @@ -72590,9 +73176,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/statuses#list-commit-statuses-for-a-reference parameters: - - *368 - - *369 - - *492 + - *370 + - *371 + - *494 - *17 - *19 responses: @@ -72602,7 +73188,7 @@ paths: application/json: schema: type: array - items: &677 + items: &679 title: Status description: The status of a commit. type: object @@ -72683,7 +73269,7 @@ paths: site_admin: false headers: Link: *38 - '301': *382 + '301': *384 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -72711,8 +73297,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/community#get-community-profile-metrics parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -72745,11 +73331,11 @@ paths: code_of_conduct: anyOf: - type: 'null' - - *496 + - *498 code_of_conduct_file: anyOf: - type: 'null' - - &497 + - &499 title: Community Health File type: object properties: @@ -72765,23 +73351,23 @@ paths: license: anyOf: - type: 'null' - - *152 + - *155 contributing: anyOf: - type: 'null' - - *497 + - *499 readme: anyOf: - type: 'null' - - *497 + - *499 issue_template: anyOf: - type: 'null' - - *497 + - *499 pull_request_template: anyOf: - type: 'null' - - *497 + - *499 required: - code_of_conduct - code_of_conduct_file @@ -72910,8 +73496,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/commits#compare-two-commits parameters: - - *368 - - *369 + - *370 + - *371 - *19 - *17 - name: basehead @@ -72959,8 +73545,8 @@ paths: format: uri examples: - https://github.com/octocat/Hello-World/compare/master...topic.patch - base_commit: *486 - merge_base_commit: *486 + base_commit: *488 + merge_base_commit: *488 status: type: string enum: @@ -72984,10 +73570,10 @@ paths: - 6 commits: type: array - items: *486 + items: *488 files: type: array - items: *498 + items: *500 required: - url - html_url @@ -73230,8 +73816,8 @@ paths: patch: "@@ -132,7 +132,7 @@ module Test @@ -1000,7 +1000,7 @@ module Test" '404': *6 - '500': *83 - '503': *130 + '500': *86 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -73273,8 +73859,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/contents#get-repository-content parameters: - - *368 - - *369 + - *370 + - *371 - name: path description: path parameter in: path @@ -73427,7 +74013,7 @@ paths: - type - url examples: - response-if-content-is-a-file: &499 + response-if-content-is-a-file: &501 summary: Response if content is a file value: type: file @@ -73564,7 +74150,7 @@ paths: - size - type - url - - &610 + - &612 title: Content File description: Content File type: object @@ -73782,7 +74368,7 @@ paths: - url - submodule_git_url examples: - response-if-content-is-a-file: *499 + response-if-content-is-a-file: *501 response-if-content-is-a-directory: summary: Response if content is a directory and the application/json media type is requested @@ -73851,7 +74437,7 @@ paths: html: https://github.com/jquery/qunit/tree/6ca3721222109997540bd6d9ccd396902e0ad2f9 '404': *6 '403': *27 - '302': *500 + '302': *502 '304': *35 x-github: githubCloudOnly: false @@ -73874,8 +74460,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/contents#create-or-update-file-contents parameters: - - *368 - - *369 + - *370 + - *371 - name: path description: path parameter in: path @@ -73970,7 +74556,7 @@ paths: description: Response content: application/json: - schema: &501 + schema: &503 title: File Commit description: File Commit type: object @@ -74126,7 +74712,7 @@ paths: description: Response content: application/json: - schema: *501 + schema: *503 examples: example-for-creating-a-file: value: @@ -74180,7 +74766,7 @@ paths: schema: oneOf: - *3 - - &539 + - &541 description: Repository rule violation was detected type: object properties: @@ -74201,7 +74787,7 @@ paths: items: type: object properties: - placeholder_id: &669 + placeholder_id: &671 description: The ID of the push protection bypass placeholder. This value is returned on any push protected routes. @@ -74233,8 +74819,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/contents#delete-a-file parameters: - - *368 - - *369 + - *370 + - *371 - name: path description: path parameter in: path @@ -74295,7 +74881,7 @@ paths: description: Response content: application/json: - schema: *501 + schema: *503 examples: default: value: @@ -74329,8 +74915,8 @@ paths: verified_at: '422': *15 '404': *6 - '409': *94 - '503': *130 + '409': *97 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -74350,8 +74936,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#list-repository-contributors parameters: - - *368 - - *369 + - *370 + - *371 - name: anon description: Set to `1` or `true` to include anonymous contributors in results. in: query @@ -74475,23 +75061,23 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/alerts#list-dependabot-alerts-for-a-repository parameters: - - *368 - - *369 - - *244 - - *245 + - *370 + - *371 - *246 - *247 + - *248 + - *249 - name: manifest in: query description: A comma-separated list of full manifest paths. If specified, only alerts for these manifests will be returned. schema: type: string - - *248 - - *249 - *250 - *251 - - *86 + - *252 + - *253 + - *89 - name: page description: "**Closing down notice**. Page number of the results to fetch. Use cursor-based pagination with `before` or `after` instead." @@ -74508,10 +75094,10 @@ paths: schema: type: integer default: 30 - - *84 - - *85 - - *252 - - *253 + - *87 + - *88 + - *254 + - *255 responses: '200': description: Response @@ -74519,11 +75105,11 @@ paths: application/json: schema: type: array - items: &504 + items: &506 type: object description: A Dependabot alert. properties: - number: *96 + number: *99 state: type: string description: The state of the Dependabot alert. @@ -74538,7 +75124,7 @@ paths: description: Details for the vulnerable dependency. readOnly: true properties: - package: *97 + package: *100 manifest_path: type: string description: The full path to the dependency manifest file, @@ -74569,13 +75155,13 @@ paths: - direct - transitive - - security_advisory: *502 - security_vulnerability: *100 - url: *101 - html_url: *102 - created_at: *103 - updated_at: *104 - dismissed_at: *105 + security_advisory: *504 + security_vulnerability: *103 + url: *104 + html_url: *105 + created_at: *106 + updated_at: *107 + dismissed_at: *108 dismissed_by: anyOf: - type: 'null' @@ -74599,8 +75185,8 @@ paths: description: An optional comment associated with the alert's dismissal. maxLength: 280 - fixed_at: *106 - auto_dismissed_at: *503 + fixed_at: *109 + auto_dismissed_at: *505 required: - number - state @@ -74830,9 +75416,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/alerts#get-a-dependabot-alert parameters: - - *368 - - *369 - - &505 + - *370 + - *371 + - &507 name: alert_number in: path description: |- @@ -74841,13 +75427,13 @@ paths: or in `number` fields in the response from the `GET /repos/{owner}/{repo}/dependabot/alerts` operation. required: true - schema: *96 + schema: *99 responses: '200': description: Response content: application/json: - schema: *504 + schema: *506 examples: default: value: @@ -74960,9 +75546,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/alerts#update-a-dependabot-alert parameters: - - *368 - - *369 - - *505 + - *370 + - *371 + - *507 requestBody: required: true content: @@ -75007,7 +75593,7 @@ paths: description: Response content: application/json: - schema: *504 + schema: *506 examples: default: value: @@ -75113,7 +75699,7 @@ paths: '400': *14 '403': *27 '404': *6 - '409': *94 + '409': *97 '422': *7 x-github: githubCloudOnly: false @@ -75136,8 +75722,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#list-repository-secrets parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -75155,7 +75741,7 @@ paths: type: integer secrets: type: array - items: &508 + items: &510 title: Dependabot Secret description: Set secrets for Dependabot. type: object @@ -75209,16 +75795,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#get-a-repository-public-key parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response content: application/json: - schema: *506 + schema: *508 examples: - default: *507 + default: *509 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -75238,15 +75824,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#get-a-repository-secret parameters: - - *368 - - *369 - - *203 + - *370 + - *371 + - *205 responses: '200': description: Response content: application/json: - schema: *508 + schema: *510 examples: default: value: @@ -75272,9 +75858,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#create-or-update-a-repository-secret parameters: - - *368 - - *369 - - *203 + - *370 + - *371 + - *205 requestBody: required: true content: @@ -75302,7 +75888,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -75326,9 +75912,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#delete-a-repository-secret parameters: - - *368 - - *369 - - *203 + - *370 + - *371 + - *205 responses: '204': description: Response @@ -75350,8 +75936,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependency-graph/dependency-review#get-a-diff-of-the-dependencies-between-commits parameters: - - *368 - - *369 + - *370 + - *371 - name: basehead description: The base and head Git revisions to compare. The Git revisions will be resolved to commit SHAs. Named revisions will be resolved to their @@ -75525,8 +76111,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependency-graph/sboms#export-a-software-bill-of-materials-sbom-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -75786,8 +76372,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependency-graph/dependency-submission#create-a-snapshot-of-dependencies-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -75870,7 +76456,7 @@ paths: - version - url additionalProperties: false - metadata: &509 + metadata: &511 title: metadata description: User-defined metadata to store domain-specific information limited to 8 keys with scalar values. @@ -75909,7 +76495,7 @@ paths: examples: - "/src/build/package-lock.json" additionalProperties: false - metadata: *509 + metadata: *511 resolved: type: object description: A collection of resolved package dependencies. @@ -75923,7 +76509,7 @@ paths: pattern: "^pkg" examples: - pkg:/npm/%40actions/http-client@1.0.11 - metadata: *509 + metadata: *511 relationship: type: string description: A notation of whether a dependency is requested @@ -76056,8 +76642,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/deployments#list-deployments parameters: - - *368 - - *369 + - *370 + - *371 - name: sha description: The SHA recorded at creation time. in: query @@ -76098,9 +76684,9 @@ paths: application/json: schema: type: array - items: *510 + items: *512 examples: - default: *511 + default: *513 headers: Link: *38 x-github: @@ -76166,8 +76752,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/deployments#create-a-deployment parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -76249,7 +76835,7 @@ paths: description: Response content: application/json: - schema: *510 + schema: *512 examples: simple-example: summary: Simple example @@ -76322,9 +76908,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/deployments#get-a-deployment parameters: - - *368 - - *369 - - &512 + - *370 + - *371 + - &514 name: deployment_id description: deployment_id parameter in: path @@ -76336,7 +76922,7 @@ paths: description: Response content: application/json: - schema: *510 + schema: *512 examples: default: value: @@ -76401,9 +76987,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/deployments#delete-a-deployment parameters: - - *368 - - *369 - - *512 + - *370 + - *371 + - *514 responses: '204': description: Response @@ -76425,9 +77011,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/statuses#list-deployment-statuses parameters: - - *368 - - *369 - - *512 + - *370 + - *371 + - *514 - *17 - *19 responses: @@ -76437,7 +77023,7 @@ paths: application/json: schema: type: array - items: &513 + items: &515 title: Deployment Status description: The status of a deployment. type: object @@ -76601,9 +77187,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/statuses#create-a-deployment-status parameters: - - *368 - - *369 - - *512 + - *370 + - *371 + - *514 requestBody: required: true content: @@ -76678,9 +77264,9 @@ paths: description: Response content: application/json: - schema: *513 + schema: *515 examples: - default: &514 + default: &516 value: url: https://api.github.com/repos/octocat/example/deployments/42/statuses/1 id: 1 @@ -76736,9 +77322,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/statuses#get-a-deployment-status parameters: - - *368 - - *369 - - *512 + - *370 + - *371 + - *514 - name: status_id in: path required: true @@ -76749,9 +77335,9 @@ paths: description: Response content: application/json: - schema: *513 + schema: *515 examples: - default: *514 + default: *516 '404': *6 x-github: githubCloudOnly: false @@ -76778,12 +77364,12 @@ paths: category: code-scanning subcategory: alert-dismissal-requests parameters: - - *368 - - *369 - - *515 - - *516 + - *370 + - *371 - *517 - *518 + - *519 + - *520 - *17 - *19 responses: @@ -76793,12 +77379,12 @@ paths: application/json: schema: type: array - items: *519 + items: *521 examples: - default: *520 + default: *522 '404': *6 '403': *27 - '500': *83 + '500': *86 "/repos/{owner}/{repo}/dismissal-requests/code-scanning/{alert_number}": get: summary: Get a dismissal request for a code scanning alert for a repository @@ -76819,8 +77405,8 @@ paths: category: code-scanning subcategory: alert-dismissal-requests parameters: - - *368 - - *369 + - *370 + - *371 - name: alert_number in: path required: true @@ -76832,7 +77418,7 @@ paths: description: A single dismissal request. content: application/json: - schema: *519 + schema: *521 examples: default: value: @@ -76868,7 +77454,7 @@ paths: html_url: https://github.com/octo-org/smile/code-scanning/alerts/1 '404': *6 '403': *27 - '500': *83 + '500': *86 patch: summary: Review a dismissal request for a code scanning alert for a repository description: |- @@ -76888,8 +77474,8 @@ paths: category: code-scanning subcategory: alert-dismissal-requests parameters: - - *368 - - *369 + - *370 + - *371 - name: alert_number in: path required: true @@ -76927,7 +77513,7 @@ paths: '404': *6 '403': *27 '422': *15 - '500': *83 + '500': *86 "/repos/{owner}/{repo}/dismissal-requests/secret-scanning": get: summary: List alert dismissal requests for secret scanning for a repository @@ -76948,12 +77534,12 @@ paths: category: secret-scanning subcategory: alert-dismissal-requests parameters: - - *368 - - *369 - - *216 - - *217 + - *370 + - *371 - *218 - - *521 + - *219 + - *220 + - *523 - *17 - *19 responses: @@ -76963,12 +77549,12 @@ paths: application/json: schema: type: array - items: *522 + items: *524 examples: - default: *523 + default: *525 '404': *6 '403': *27 - '500': *83 + '500': *86 "/repos/{owner}/{repo}/dismissal-requests/secret-scanning/{alert_number}": get: summary: Get an alert dismissal request for secret scanning @@ -76990,8 +77576,8 @@ paths: category: secret-scanning subcategory: alert-dismissal-requests parameters: - - *368 - - *369 + - *370 + - *371 - name: alert_number in: path required: true @@ -77003,7 +77589,7 @@ paths: description: A single dismissal request. content: application/json: - schema: *522 + schema: *524 examples: default: value: @@ -77040,7 +77626,7 @@ paths: html_url: https://github.com/octo-org/smile/security/secret-scanning/17 '404': *6 '403': *27 - '500': *83 + '500': *86 patch: summary: Review an alert dismissal request for secret scanning description: |- @@ -77061,8 +77647,8 @@ paths: category: secret-scanning subcategory: alert-dismissal-requests parameters: - - *368 - - *369 + - *370 + - *371 - name: alert_number in: path required: true @@ -77112,7 +77698,7 @@ paths: '404': *6 '403': *27 '422': *15 - '500': *83 + '500': *86 "/repos/{owner}/{repo}/dispatches": post: summary: Create a repository dispatch event @@ -77131,8 +77717,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#create-a-repository-dispatch-event parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -77189,8 +77775,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/environments#list-environments parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -77208,7 +77794,7 @@ paths: - 5 environments: type: array - items: &525 + items: &527 title: Environment description: Details of a deployment environment type: object @@ -77270,7 +77856,7 @@ paths: type: string examples: - wait_timer - wait_timer: &527 + wait_timer: &529 type: integer description: The amount of time to delay a job after the job is initially triggered. The time (in minutes) @@ -77312,11 +77898,11 @@ paths: items: type: object properties: - type: *524 + type: *526 reviewer: anyOf: - *4 - - *224 + - *226 required: - id - node_id @@ -77339,7 +77925,7 @@ paths: - id - node_id - type - deployment_branch_policy: &528 + deployment_branch_policy: &530 type: - object - 'null' @@ -77456,9 +78042,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/environments#get-an-environment parameters: - - *368 - - *369 - - &526 + - *370 + - *371 + - &528 name: environment_name in: path required: true @@ -77471,9 +78057,9 @@ paths: description: Response content: application/json: - schema: *525 + schema: *527 examples: - default: &529 + default: &531 value: id: 161088068 node_id: MDExOkVudmlyb25tZW50MTYxMDg4MDY4 @@ -77557,9 +78143,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/environments#create-or-update-an-environment parameters: - - *368 - - *369 - - *526 + - *370 + - *371 + - *528 requestBody: required: false content: @@ -77569,7 +78155,7 @@ paths: - object - 'null' properties: - wait_timer: *527 + wait_timer: *529 prevent_self_review: type: boolean description: Whether or not a user who created the job is prevented @@ -77588,14 +78174,14 @@ paths: items: type: object properties: - type: *524 + type: *526 id: type: integer description: The id of the user or team who can review the deployment examples: - 4532992 - deployment_branch_policy: *528 + deployment_branch_policy: *530 additionalProperties: false examples: default: @@ -77615,9 +78201,9 @@ paths: description: Response content: application/json: - schema: *525 + schema: *527 examples: - default: *529 + default: *531 '422': description: Validation error when the environment name is invalid or when `protected_branches` and `custom_branch_policies` in `deployment_branch_policy` @@ -77641,9 +78227,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/environments#delete-an-environment parameters: - - *368 - - *369 - - *526 + - *370 + - *371 + - *528 responses: '204': description: Default response @@ -77668,9 +78254,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/branch-policies#list-deployment-branch-policies parameters: - - *368 - - *369 - - *526 + - *370 + - *371 + - *528 - *17 - *19 responses: @@ -77689,7 +78275,7 @@ paths: - 2 branch_policies: type: array - items: &530 + items: &532 title: Deployment branch policy description: Details of a deployment branch or tag policy. type: object @@ -77750,9 +78336,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/branch-policies#create-a-deployment-branch-policy parameters: - - *368 - - *369 - - *526 + - *370 + - *371 + - *528 requestBody: required: true content: @@ -77800,9 +78386,9 @@ paths: description: Response content: application/json: - schema: *530 + schema: *532 examples: - example-wildcard: &531 + example-wildcard: &533 value: id: 364662 node_id: MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjQ2NjI= @@ -77844,10 +78430,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/branch-policies#get-a-deployment-branch-policy parameters: - - *368 - - *369 - - *526 - - &532 + - *370 + - *371 + - *528 + - &534 name: branch_policy_id in: path required: true @@ -77859,9 +78445,9 @@ paths: description: Response content: application/json: - schema: *530 + schema: *532 examples: - default: *531 + default: *533 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -77880,10 +78466,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/branch-policies#update-a-deployment-branch-policy parameters: - - *368 - - *369 - - *526 - - *532 + - *370 + - *371 + - *528 + - *534 requestBody: required: true content: @@ -77912,9 +78498,9 @@ paths: description: Response content: application/json: - schema: *530 + schema: *532 examples: - default: *531 + default: *533 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -77933,10 +78519,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/branch-policies#delete-a-deployment-branch-policy parameters: - - *368 - - *369 - - *526 - - *532 + - *370 + - *371 + - *528 + - *534 responses: '204': description: Response @@ -77961,9 +78547,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/protection-rules#get-all-deployment-protection-rules-for-an-environment parameters: - - *526 - - *369 - - *368 + - *528 + - *371 + - *370 responses: '200': description: List of deployment protection rules @@ -77980,7 +78566,7 @@ paths: - 10 custom_deployment_protection_rules: type: array - items: &533 + items: &535 title: Deployment protection rule description: Deployment protection rule type: object @@ -78002,7 +78588,7 @@ paths: for the environment. examples: - true - app: &534 + app: &536 title: Custom deployment protection rule app description: A GitHub App that is providing a custom deployment protection rule. @@ -78105,9 +78691,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/protection-rules#create-a-custom-deployment-protection-rule-on-an-environment parameters: - - *526 - - *369 - - *368 + - *528 + - *371 + - *370 requestBody: content: application/json: @@ -78128,9 +78714,9 @@ paths: description: The enabled custom deployment protection rule content: application/json: - schema: *533 + schema: *535 examples: - default: &535 + default: &537 value: id: 3 node_id: IEH37kRlcGxveW1lbnRTdGF0ddiv @@ -78165,9 +78751,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/protection-rules#list-custom-deployment-rule-integrations-available-for-an-environment parameters: - - *526 - - *369 - - *368 + - *528 + - *371 + - *370 - *19 - *17 responses: @@ -78187,7 +78773,7 @@ paths: - 35 available_custom_deployment_protection_rule_integrations: type: array - items: *534 + items: *536 examples: default: value: @@ -78222,10 +78808,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/protection-rules#get-a-custom-deployment-protection-rule parameters: - - *368 - - *369 - - *526 - - &536 + - *370 + - *371 + - *528 + - &538 name: protection_rule_id description: The unique identifier of the protection rule. in: path @@ -78237,9 +78823,9 @@ paths: description: Response content: application/json: - schema: *533 + schema: *535 examples: - default: *535 + default: *537 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -78260,10 +78846,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/protection-rules#disable-a-custom-protection-rule-for-an-environment parameters: - - *526 - - *369 - - *368 - - *536 + - *528 + - *371 + - *370 + - *538 responses: '204': description: Response @@ -78289,9 +78875,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#list-environment-secrets parameters: - - *368 - - *369 - - *526 + - *370 + - *371 + - *528 - *17 - *19 responses: @@ -78309,9 +78895,9 @@ paths: type: integer secrets: type: array - items: *405 + items: *407 examples: - default: *406 + default: *408 headers: Link: *38 x-github: @@ -78336,17 +78922,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#get-an-environment-public-key parameters: - - *368 - - *369 - - *526 + - *370 + - *371 + - *528 responses: '200': description: Response content: application/json: - schema: *407 + schema: *409 examples: - default: *408 + default: *410 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -78368,18 +78954,18 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#get-an-environment-secret parameters: - - *368 - - *369 - - *526 - - *203 + - *370 + - *371 + - *528 + - *205 responses: '200': description: Response content: application/json: - schema: *405 + schema: *407 examples: - default: *537 + default: *539 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -78401,10 +78987,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#create-or-update-an-environment-secret parameters: - - *368 - - *369 - - *526 - - *203 + - *370 + - *371 + - *528 + - *205 requestBody: required: true content: @@ -78435,7 +79021,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -78461,10 +79047,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#delete-an-environment-secret parameters: - - *368 - - *369 - - *526 - - *203 + - *370 + - *371 + - *528 + - *205 responses: '204': description: Default response @@ -78489,10 +79075,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#list-environment-variables parameters: - - *368 - - *369 - - *526 - - *392 + - *370 + - *371 + - *528 + - *394 - *19 responses: '200': @@ -78509,9 +79095,9 @@ paths: type: integer variables: type: array - items: *409 + items: *411 examples: - default: *410 + default: *412 headers: Link: *38 x-github: @@ -78534,9 +79120,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#create-an-environment-variable parameters: - - *368 - - *369 - - *526 + - *370 + - *371 + - *528 requestBody: required: true content: @@ -78563,7 +79149,7 @@ paths: description: Response content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -78588,18 +79174,18 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#get-an-environment-variable parameters: - - *368 - - *369 - - *526 - - *206 + - *370 + - *371 + - *528 + - *208 responses: '200': description: Response content: application/json: - schema: *409 + schema: *411 examples: - default: *538 + default: *540 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -78620,10 +79206,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#update-an-environment-variable parameters: - - *368 - - *369 - - *206 - - *526 + - *370 + - *371 + - *208 + - *528 requestBody: required: true content: @@ -78665,10 +79251,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#delete-an-environment-variable parameters: - - *368 - - *369 - - *206 - - *526 + - *370 + - *371 + - *208 + - *528 responses: '204': description: Response @@ -78690,8 +79276,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/events#list-repository-events parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -78701,7 +79287,7 @@ paths: application/json: schema: type: array - items: *162 + items: *165 examples: 200-response: value: @@ -78768,8 +79354,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/forks#list-forks parameters: - - *368 - - *369 + - *370 + - *371 - name: sort description: The sort order. `stargazers` will sort by star count. in: query @@ -78791,7 +79377,7 @@ paths: application/json: schema: type: array - items: *193 + items: *195 examples: default: value: @@ -78928,8 +79514,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/forks#create-a-fork parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: false content: @@ -78962,9 +79548,9 @@ paths: description: Response content: application/json: - schema: *381 + schema: *383 examples: - default: *383 + default: *385 '400': *14 '422': *15 '403': *27 @@ -78985,8 +79571,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/blobs#create-a-blob parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -79037,7 +79623,7 @@ paths: schema: type: string '404': *6 - '409': *94 + '409': *97 '403': *27 '422': description: Validation failed @@ -79045,8 +79631,8 @@ paths: application/json: schema: oneOf: - - *176 - - *539 + - *178 + - *541 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79071,8 +79657,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/blobs#get-a-blob parameters: - - *368 - - *369 + - *370 + - *371 - name: file_sha in: path required: true @@ -79124,7 +79710,7 @@ paths: '404': *6 '422': *15 '403': *27 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79172,8 +79758,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/commits#create-a-commit parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -79282,7 +79868,7 @@ paths: description: Response content: application/json: - schema: &540 + schema: &542 title: Git Commit description: Low-level Git commit operations within a repository type: object @@ -79459,7 +80045,7 @@ paths: type: string '422': *15 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79509,15 +80095,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/commits#get-a-commit-object parameters: - - *368 - - *369 - - *487 + - *370 + - *371 + - *489 responses: '200': description: Response content: application/json: - schema: *540 + schema: *542 examples: default: value: @@ -79548,7 +80134,7 @@ paths: payload: verified_at: '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79573,9 +80159,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/refs#list-matching-references parameters: - - *368 - - *369 - - &541 + - *370 + - *371 + - &543 name: ref description: The Git reference. For more information, see "[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)" in the Git documentation. @@ -79592,7 +80178,7 @@ paths: application/json: schema: type: array - items: &542 + items: &544 title: Git Reference description: Git references within a repository type: object @@ -79647,7 +80233,7 @@ paths: url: https://api.github.com/repos/octocat/Hello-World/git/commits/612077ae6dffb4d2fbd8ce0cccaa58893b07b5ac headers: Link: *38 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79668,17 +80254,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/refs#get-a-reference parameters: - - *368 - - *369 - - *541 + - *370 + - *371 + - *543 responses: '200': description: Response content: application/json: - schema: *542 + schema: *544 examples: - default: &543 + default: &545 value: ref: refs/heads/featureA node_id: MDM6UmVmcmVmcy9oZWFkcy9mZWF0dXJlQQ== @@ -79688,7 +80274,7 @@ paths: sha: aa218f56b14c9653891f9e74264a383fa43fefbd url: https://api.github.com/repos/octocat/Hello-World/git/commits/aa218f56b14c9653891f9e74264a383fa43fefbd '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79707,8 +80293,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/refs#create-a-reference parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -79737,16 +80323,16 @@ paths: description: Response content: application/json: - schema: *542 + schema: *544 examples: - default: *543 + default: *545 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/git/refs/heads/featureA schema: type: string '422': *15 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79765,9 +80351,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/refs#update-a-reference parameters: - - *368 - - *369 - - *541 + - *370 + - *371 + - *543 requestBody: required: true content: @@ -79796,11 +80382,11 @@ paths: description: Response content: application/json: - schema: *542 + schema: *544 examples: - default: *543 + default: *545 '422': *15 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79816,16 +80402,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/refs#delete-a-reference parameters: - - *368 - - *369 - - *541 + - *370 + - *371 + - *543 responses: '204': description: Response '422': description: Validation failed, an attempt was made to delete the default branch, or the endpoint has been spammed. - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79873,8 +80459,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/tags#create-a-tag-object parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -79941,7 +80527,7 @@ paths: description: Response content: application/json: - schema: &545 + schema: &547 title: Git Tag description: Metadata for a Git tag type: object @@ -79997,7 +80583,7 @@ paths: - sha - type - url - verification: *544 + verification: *546 required: - sha - url @@ -80007,7 +80593,7 @@ paths: - tag - message examples: - default: &546 + default: &548 value: node_id: MDM6VGFnOTQwYmQzMzYyNDhlZmFlMGY5ZWU1YmM3YjJkNWM5ODU4ODdiMTZhYw== tag: v0.0.1 @@ -80034,7 +80620,7 @@ paths: schema: type: string '422': *15 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -80080,8 +80666,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/tags#get-a-tag parameters: - - *368 - - *369 + - *370 + - *371 - name: tag_sha in: path required: true @@ -80092,11 +80678,11 @@ paths: description: Response content: application/json: - schema: *545 + schema: *547 examples: - default: *546 + default: *548 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -80118,8 +80704,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/trees#create-a-tree parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -80193,7 +80779,7 @@ paths: description: Response content: application/json: - schema: &547 + schema: &549 title: Git Tree description: The hierarchy between files in a Git repository. type: object @@ -80272,7 +80858,7 @@ paths: '422': *15 '404': *6 '403': *27 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -80295,8 +80881,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/trees#get-a-tree parameters: - - *368 - - *369 + - *370 + - *371 - name: tree_sha description: The SHA1 value or ref (branch or tag) name of the tree. in: path @@ -80319,7 +80905,7 @@ paths: description: Response content: application/json: - schema: *547 + schema: *549 examples: default-response: summary: Default response @@ -80360,7 +80946,7 @@ paths: truncated: false '422': *15 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -80378,8 +80964,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#list-repository-webhooks parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -80389,7 +80975,7 @@ paths: application/json: schema: type: array - items: &548 + items: &550 title: Webhook description: Webhooks for repositories. type: object @@ -80452,7 +81038,7 @@ paths: format: uri examples: - https://api.github.com/repos/octocat/Hello-World/hooks/1/deliveries - last_response: &806 + last_response: &808 title: Hook Response type: object properties: @@ -80529,8 +81115,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#create-a-repository-webhook parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: false content: @@ -80583,9 +81169,9 @@ paths: description: Response content: application/json: - schema: *548 + schema: *550 examples: - default: &549 + default: &551 value: type: Repository id: 12345678 @@ -80633,17 +81219,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#get-a-repository-webhook parameters: - - *368 - - *369 - - *259 + - *370 + - *371 + - *261 responses: '200': description: Response content: application/json: - schema: *548 + schema: *550 examples: - default: *549 + default: *551 '404': *6 x-github: githubCloudOnly: false @@ -80663,9 +81249,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#update-a-repository-webhook parameters: - - *368 - - *369 - - *259 + - *370 + - *371 + - *261 requestBody: required: true content: @@ -80710,9 +81296,9 @@ paths: description: Response content: application/json: - schema: *548 + schema: *550 examples: - default: *549 + default: *551 '422': *15 '404': *6 x-github: @@ -80733,9 +81319,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#delete-a-repository-webhook parameters: - - *368 - - *369 - - *259 + - *370 + - *371 + - *261 responses: '204': description: Response @@ -80759,9 +81345,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#get-a-webhook-configuration-for-a-repository parameters: - - *368 - - *369 - - *259 + - *370 + - *371 + - *261 responses: '200': description: Response @@ -80788,9 +81374,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#update-a-webhook-configuration-for-a-repository parameters: - - *368 - - *369 - - *259 + - *370 + - *371 + - *261 requestBody: required: false content: @@ -80834,11 +81420,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#list-deliveries-for-a-repository-webhook parameters: - - *368 - - *369 - - *259 + - *370 + - *371 + - *261 - *17 - - *260 + - *262 responses: '200': description: Response @@ -80846,9 +81432,9 @@ paths: application/json: schema: type: array - items: *261 + items: *263 examples: - default: *262 + default: *264 '400': *14 '422': *15 x-github: @@ -80867,18 +81453,18 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#get-a-delivery-for-a-repository-webhook parameters: - - *368 - - *369 - - *259 + - *370 + - *371 + - *261 - *16 responses: '200': description: Response content: application/json: - schema: *263 + schema: *265 examples: - default: *264 + default: *266 '400': *14 '422': *15 x-github: @@ -80897,9 +81483,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#redeliver-a-delivery-for-a-repository-webhook parameters: - - *368 - - *369 - - *259 + - *370 + - *371 + - *261 - *16 responses: '202': *37 @@ -80922,9 +81508,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#ping-a-repository-webhook parameters: - - *368 - - *369 - - *259 + - *370 + - *371 + - *261 responses: '204': description: Response @@ -80949,9 +81535,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#test-the-push-repository-webhook parameters: - - *368 - - *369 - - *259 + - *370 + - *371 + - *261 responses: '204': description: Response @@ -81009,14 +81595,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/source-imports#get-an-import-status parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response content: application/json: - schema: &550 + schema: &552 title: Import description: A repository import from an external source. type: object @@ -81123,7 +81709,7 @@ paths: - html_url - authors_url examples: - default: &553 + default: &555 value: vcs: subversion use_lfs: true @@ -81139,7 +81725,7 @@ paths: authors_url: https://api.github.com/repos/octocat/socm/import/authors repository_url: https://api.github.com/repos/octocat/socm '404': *6 - '503': &551 + '503': &553 description: Unavailable due to service under maintenance. content: application/json: @@ -81168,8 +81754,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/source-imports#start-an-import parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -81217,7 +81803,7 @@ paths: description: Response content: application/json: - schema: *550 + schema: *552 examples: default: value: @@ -81242,7 +81828,7 @@ paths: type: string '422': *15 '404': *6 - '503': *551 + '503': *553 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -81270,8 +81856,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/source-imports#update-an-import parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: false content: @@ -81323,7 +81909,7 @@ paths: description: Response content: application/json: - schema: *550 + schema: *552 examples: example-1: summary: Example 1 @@ -81371,7 +81957,7 @@ paths: html_url: https://import.github.com/octocat/socm/import authors_url: https://api.github.com/repos/octocat/socm/import/authors repository_url: https://api.github.com/repos/octocat/socm - '503': *551 + '503': *553 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -81394,12 +81980,12 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/source-imports#cancel-an-import parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response - '503': *551 + '503': *553 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -81425,9 +82011,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/source-imports#get-commit-authors parameters: - - *368 - - *369 - - &752 + - *370 + - *371 + - &754 name: since description: A user ID. Only return users with an ID greater than this ID. in: query @@ -81441,7 +82027,7 @@ paths: application/json: schema: type: array - items: &552 + items: &554 title: Porter Author description: Porter Author type: object @@ -81495,7 +82081,7 @@ paths: url: https://api.github.com/repos/octocat/socm/import/authors/2268559 import_url: https://api.github.com/repos/octocat/socm/import '404': *6 - '503': *551 + '503': *553 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -81520,8 +82106,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/source-imports#map-a-commit-author parameters: - - *368 - - *369 + - *370 + - *371 - name: author_id in: path required: true @@ -81551,7 +82137,7 @@ paths: description: Response content: application/json: - schema: *552 + schema: *554 examples: default: value: @@ -81564,7 +82150,7 @@ paths: import_url: https://api.github.com/repos/octocat/socm/import '422': *15 '404': *6 - '503': *551 + '503': *553 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -81588,8 +82174,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/source-imports#get-large-files parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -81630,7 +82216,7 @@ paths: path: foo/bar/3 oid: c20ad4d76fe97759aa27a0c99bff6710 size: 12582912 - '503': *551 + '503': *553 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -81658,8 +82244,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/source-imports#update-git-lfs-preference parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -81686,11 +82272,11 @@ paths: description: Response content: application/json: - schema: *550 + schema: *552 examples: - default: *553 + default: *555 '422': *15 - '503': *551 + '503': *553 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -81713,8 +82299,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#get-a-repository-installation-for-the-authenticated-app parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -81722,8 +82308,8 @@ paths: application/json: schema: *20 examples: - default: *554 - '301': *382 + default: *556 + '301': *384 '404': *6 x-github: githubCloudOnly: false @@ -81743,8 +82329,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/interactions/repos#get-interaction-restrictions-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -81752,12 +82338,12 @@ paths: application/json: schema: anyOf: - - *277 + - *279 - type: object properties: {} additionalProperties: false examples: - default: &556 + default: &558 value: limit: collaborators_only origin: repository @@ -81782,13 +82368,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/interactions/repos#set-interaction-restrictions-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: application/json: - schema: *555 + schema: *557 examples: default: summary: Example request body @@ -81800,9 +82386,9 @@ paths: description: Response content: application/json: - schema: *277 + schema: *279 examples: - default: *556 + default: *558 '409': description: Response x-github: @@ -81824,8 +82410,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/interactions/repos#remove-interaction-restrictions-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response @@ -81848,8 +82434,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/invitations#list-repository-invitations parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -81859,9 +82445,9 @@ paths: application/json: schema: type: array - items: *557 + items: *559 examples: - default: &745 + default: &747 value: - id: 1 repository: @@ -81992,9 +82578,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/invitations#update-a-repository-invitation parameters: - - *368 - - *369 - - *281 + - *370 + - *371 + - *283 requestBody: required: false content: @@ -82023,7 +82609,7 @@ paths: description: Response content: application/json: - schema: *557 + schema: *559 examples: default: value: @@ -82154,9 +82740,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/invitations#delete-a-repository-invitation parameters: - - *368 - - *369 - - *281 + - *370 + - *371 + - *283 responses: '204': description: Response @@ -82187,8 +82773,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#list-repository-issues parameters: - - *368 - - *369 + - *370 + - *371 - name: milestone description: If an `integer` is passed, it should refer to a milestone by its `number` field. If the string `*` is passed, issues with any milestone @@ -82236,7 +82822,7 @@ paths: required: false schema: type: string - - *285 + - *287 - name: sort description: What to sort results by. in: query @@ -82248,8 +82834,8 @@ paths: - updated - comments default: created - - *86 - - *141 + - *89 + - *144 - *17 - *19 responses: @@ -82259,9 +82845,9 @@ paths: application/json: schema: type: array - items: *151 + items: *154 examples: - default: &566 + default: &568 value: - id: 1 node_id: MDU6SXNzdWUx @@ -82409,7 +82995,7 @@ paths: state_reason: completed headers: Link: *38 - '301': *382 + '301': *384 '422': *15 '404': *6 x-github: @@ -82438,8 +83024,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#create-an-issue parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -82529,9 +83115,9 @@ paths: description: Response content: application/json: - schema: *151 + schema: *154 examples: - default: &561 + default: &563 value: id: 1 node_id: MDU6SXNzdWUx @@ -82685,9 +83271,9 @@ paths: '400': *14 '403': *27 '422': *15 - '503': *130 + '503': *133 '404': *6 - '410': *379 + '410': *381 x-github: triggersNotification: true githubCloudOnly: false @@ -82715,9 +83301,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/comments#list-issue-comments-for-a-repository parameters: - - *368 - - *369 - - *160 + - *370 + - *371 + - *163 - name: direction description: Either `asc` or `desc`. Ignored without the `sort` parameter. in: query @@ -82727,7 +83313,7 @@ paths: enum: - asc - desc - - *141 + - *144 - *17 - *19 responses: @@ -82737,9 +83323,9 @@ paths: application/json: schema: type: array - items: *558 + items: *560 examples: - default: &563 + default: &565 value: - id: 1 node_id: MDEyOklzc3VlQ29tbWVudDE= @@ -82797,17 +83383,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/comments#get-an-issue-comment parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 responses: '200': description: Response content: application/json: - schema: *558 + schema: *560 examples: - default: &559 + default: &561 value: id: 1 node_id: MDEyOklzc3VlQ29tbWVudDE= @@ -82861,9 +83447,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/comments#update-an-issue-comment parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 requestBody: required: true content: @@ -82885,9 +83471,9 @@ paths: description: Response content: application/json: - schema: *558 + schema: *560 examples: - default: *559 + default: *561 '422': *15 x-github: githubCloudOnly: false @@ -82905,9 +83491,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/comments#delete-an-issue-comment parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 responses: '204': description: Response @@ -82927,9 +83513,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#list-reactions-for-an-issue-comment parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 - name: content description: Returns a single [reaction type](https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to an issue comment. @@ -82955,9 +83541,9 @@ paths: application/json: schema: type: array - items: *357 + items: *359 examples: - default: *359 + default: *361 headers: Link: *38 '404': *6 @@ -82978,9 +83564,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#create-reaction-for-an-issue-comment parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 requestBody: required: true content: @@ -83012,16 +83598,16 @@ paths: description: Reaction exists content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 '201': description: Reaction created content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 '422': *15 x-github: githubCloudOnly: false @@ -83043,10 +83629,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#delete-an-issue-comment-reaction parameters: - - *368 - - *369 - - *150 - - *360 + - *370 + - *371 + - *153 + - *362 responses: '204': description: Response @@ -83066,8 +83652,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/events#list-issue-events-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -83077,7 +83663,7 @@ paths: application/json: schema: type: array - items: &560 + items: &562 title: Issue Event description: Issue Event type: object @@ -83124,7 +83710,7 @@ paths: issue: anyOf: - type: 'null' - - *151 + - *154 label: title: Issue Event Label description: Issue Event Label @@ -83157,7 +83743,7 @@ paths: anyOf: - type: 'null' - *4 - requested_team: *224 + requested_team: *226 dismissed_review: title: Issue Event Dismissed Review type: object @@ -83224,7 +83810,7 @@ paths: required: - from - to - author_association: *138 + author_association: *141 lock_reason: type: - string @@ -83416,8 +84002,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/events#get-an-issue-event parameters: - - *368 - - *369 + - *370 + - *371 - name: event_id in: path required: true @@ -83428,7 +84014,7 @@ paths: description: Response content: application/json: - schema: *560 + schema: *562 examples: default: value: @@ -83621,7 +84207,7 @@ paths: author_association: COLLABORATOR state_reason: completed '404': *6 - '410': *379 + '410': *381 '403': *27 x-github: githubCloudOnly: false @@ -83655,9 +84241,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue parameters: - - *368 - - *369 - - &562 + - *370 + - *371 + - &564 name: issue_number description: The number that identifies the issue. in: path @@ -83669,12 +84255,12 @@ paths: description: Response content: application/json: - schema: *151 + schema: *154 examples: - default: *561 - '301': *382 + default: *563 + '301': *384 '404': *6 - '410': *379 + '410': *381 '304': *35 x-github: githubCloudOnly: false @@ -83699,9 +84285,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#update-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 requestBody: required: false content: @@ -83819,15 +84405,15 @@ paths: description: Response content: application/json: - schema: *151 + schema: *154 examples: - default: *561 + default: *563 '422': *15 - '503': *130 + '503': *133 '403': *27 - '301': *382 + '301': *384 '404': *6 - '410': *379 + '410': *381 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -83845,9 +84431,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/assignees#add-assignees-to-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 requestBody: required: false content: @@ -83873,9 +84459,9 @@ paths: description: Response content: application/json: - schema: *151 + schema: *154 examples: - default: *561 + default: *563 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -83891,9 +84477,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/assignees#remove-assignees-from-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 requestBody: content: application/json: @@ -83918,9 +84504,9 @@ paths: description: Response content: application/json: - schema: *151 + schema: *154 examples: - default: *561 + default: *563 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -83942,9 +84528,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/assignees#check-if-a-user-can-be-assigned-to-a-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 - name: assignee in: path required: true @@ -83984,10 +84570,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/comments#list-issue-comments parameters: - - *368 - - *369 - - *562 - - *141 + - *370 + - *371 + - *564 + - *144 - *17 - *19 responses: @@ -83997,13 +84583,13 @@ paths: application/json: schema: type: array - items: *558 + items: *560 examples: - default: *563 + default: *565 headers: Link: *38 '404': *6 - '410': *379 + '410': *381 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -84032,9 +84618,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/comments#create-an-issue-comment parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 requestBody: required: true content: @@ -84056,16 +84642,16 @@ paths: description: Response content: application/json: - schema: *558 + schema: *560 examples: - default: *559 + default: *561 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/comments/1 schema: type: string '403': *27 - '410': *379 + '410': *381 '422': *15 '404': *6 x-github: @@ -84085,9 +84671,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/events#list-issue-events parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 - *17 - *19 responses: @@ -84101,7 +84687,7 @@ paths: title: Issue Event for Issue description: Issue Event for Issue anyOf: - - &567 + - &569 title: Labeled Issue Event description: Labeled Issue Event type: object @@ -84150,7 +84736,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &568 + - &570 title: Unlabeled Issue Event description: Unlabeled Issue Event type: object @@ -84278,7 +84864,7 @@ paths: - performed_via_github_app - assignee - assigner - - &569 + - &571 title: Milestoned Issue Event description: Milestoned Issue Event type: object @@ -84324,7 +84910,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &570 + - &572 title: Demilestoned Issue Event description: Demilestoned Issue Event type: object @@ -84370,7 +84956,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &571 + - &573 title: Renamed Issue Event description: Renamed Issue Event type: object @@ -84419,7 +85005,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &572 + - &574 title: Review Requested Issue Event description: Review Requested Issue Event type: object @@ -84448,7 +85034,7 @@ paths: - type: 'null' - *5 review_requester: *4 - requested_team: *224 + requested_team: *226 requested_reviewer: *4 required: - review_requester @@ -84461,7 +85047,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &573 + - &575 title: Review Request Removed Issue Event description: Review Request Removed Issue Event type: object @@ -84490,7 +85076,7 @@ paths: - type: 'null' - *5 review_requester: *4 - requested_team: *224 + requested_team: *226 requested_reviewer: *4 required: - review_requester @@ -84503,7 +85089,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &574 + - &576 title: Review Dismissed Issue Event description: Review Dismissed Issue Event type: object @@ -84559,7 +85145,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &575 + - &577 title: Locked Issue Event description: Locked Issue Event type: object @@ -84604,7 +85190,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &576 + - &578 title: Added to Project Issue Event description: Added to Project Issue Event type: object @@ -84665,7 +85251,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &577 + - &579 title: Moved Column in Project Issue Event description: Moved Column in Project Issue Event type: object @@ -84726,7 +85312,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &578 + - &580 title: Removed from Project Issue Event description: Removed from Project Issue Event type: object @@ -84787,7 +85373,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &579 + - &581 title: Converted Note to Issue Issue Event description: Converted Note to Issue Issue Event type: object @@ -84880,7 +85466,7 @@ paths: color: red headers: Link: *38 - '410': *379 + '410': *381 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -84897,9 +85483,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#list-labels-for-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 - *17 - *19 responses: @@ -84909,7 +85495,7 @@ paths: application/json: schema: type: array - items: &564 + items: &566 title: Label description: Color-coded labels help you categorize and filter your issues (just like labels in Gmail). @@ -84964,7 +85550,7 @@ paths: - color - default examples: - default: &565 + default: &567 value: - id: 208045946 node_id: MDU6TGFiZWwyMDgwNDU5NDY= @@ -84982,9 +85568,9 @@ paths: default: false headers: Link: *38 - '301': *382 + '301': *384 '404': *6 - '410': *379 + '410': *381 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -85001,9 +85587,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#add-labels-to-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 requestBody: required: false content: @@ -85062,12 +85648,12 @@ paths: application/json: schema: type: array - items: *564 + items: *566 examples: - default: *565 - '301': *382 + default: *567 + '301': *384 '404': *6 - '410': *379 + '410': *381 '422': *15 x-github: githubCloudOnly: false @@ -85084,9 +85670,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#set-labels-for-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 requestBody: required: false content: @@ -85146,12 +85732,12 @@ paths: application/json: schema: type: array - items: *564 + items: *566 examples: - default: *565 - '301': *382 + default: *567 + '301': *384 '404': *6 - '410': *379 + '410': *381 '422': *15 x-github: githubCloudOnly: false @@ -85168,15 +85754,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#remove-all-labels-from-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 responses: '204': description: Response - '301': *382 + '301': *384 '404': *6 - '410': *379 + '410': *381 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -85195,9 +85781,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#remove-a-label-from-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 - name: name in: path required: true @@ -85210,7 +85796,7 @@ paths: application/json: schema: type: array - items: *564 + items: *566 examples: default: value: @@ -85221,9 +85807,9 @@ paths: description: Something isn't working color: f29513 default: true - '301': *382 + '301': *384 '404': *6 - '410': *379 + '410': *381 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -85243,9 +85829,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#lock-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 requestBody: required: false content: @@ -85274,7 +85860,7 @@ paths: '204': description: Response '403': *27 - '410': *379 + '410': *381 '404': *6 '422': *15 x-github: @@ -85292,9 +85878,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#unlock-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 responses: '204': description: Response @@ -85316,9 +85902,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#list-reactions-for-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 - name: content description: Returns a single [reaction type](https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to an issue. @@ -85344,13 +85930,13 @@ paths: application/json: schema: type: array - items: *357 + items: *359 examples: - default: *359 + default: *361 headers: Link: *38 '404': *6 - '410': *379 + '410': *381 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -85368,9 +85954,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#create-reaction-for-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 requestBody: required: true content: @@ -85402,16 +85988,16 @@ paths: description: Response content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 '201': description: Response content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 '422': *15 x-github: githubCloudOnly: false @@ -85433,10 +86019,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#delete-an-issue-reaction parameters: - - *368 - - *369 - - *562 - - *360 + - *370 + - *371 + - *564 + - *362 responses: '204': description: Response @@ -85465,9 +86051,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/sub-issues#remove-sub-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 requestBody: required: true content: @@ -85489,9 +86075,9 @@ paths: description: Response content: application/json: - schema: *151 + schema: *154 examples: - default: *561 + default: *563 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/1/sub-issue @@ -85524,9 +86110,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/sub-issues#list-sub-issues parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 - *17 - *19 responses: @@ -85536,13 +86122,13 @@ paths: application/json: schema: type: array - items: *151 + items: *154 examples: - default: *566 + default: *568 headers: Link: *38 '404': *6 - '410': *379 + '410': *381 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -85570,9 +86156,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/sub-issues#add-sub-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 requestBody: required: true content: @@ -85599,16 +86185,16 @@ paths: description: Response content: application/json: - schema: *151 + schema: *154 examples: - default: *561 + default: *563 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/sub-issues/1 schema: type: string '403': *27 - '410': *379 + '410': *381 '422': *15 '404': *6 x-github: @@ -85628,9 +86214,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/sub-issues#reprioritize-sub-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 requestBody: required: true content: @@ -85661,13 +86247,13 @@ paths: description: Response content: application/json: - schema: *151 + schema: *154 examples: - default: *561 + default: *563 '403': *27 '404': *6 '422': *7 - '503': *130 + '503': *133 x-github: triggersNotification: true githubCloudOnly: false @@ -85685,9 +86271,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/timeline#list-timeline-events-for-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 - *17 - *19 responses: @@ -85702,8 +86288,6 @@ paths: description: Timeline Event type: object anyOf: - - *567 - - *568 - *569 - *570 - *571 @@ -85715,6 +86299,8 @@ paths: - *577 - *578 - *579 + - *580 + - *581 - title: Timeline Comment Event description: Timeline Comment Event type: object @@ -85762,12 +86348,12 @@ paths: issue_url: type: string format: uri - author_association: *138 + author_association: *141 performed_via_github_app: anyOf: - type: 'null' - *5 - reactions: *139 + reactions: *142 required: - event - actor @@ -85798,7 +86384,7 @@ paths: properties: type: type: string - issue: *151 + issue: *154 required: - event - created_at @@ -86015,7 +86601,7 @@ paths: type: string body_text: type: string - author_association: *138 + author_association: *141 required: - event - id @@ -86038,7 +86624,7 @@ paths: type: string comments: type: array - items: &599 + items: &601 title: Pull Request Review Comment description: Pull Request Review Comments are comments on a portion of the Pull Request's diff. @@ -86143,7 +86729,7 @@ paths: format: uri examples: - https://api.github.com/repos/octocat/Hello-World/pulls/1 - author_association: *138 + author_association: *141 _links: type: object properties: @@ -86238,7 +86824,7 @@ paths: enum: - line - file - reactions: *139 + reactions: *142 body_html: type: string examples: @@ -86276,7 +86862,7 @@ paths: type: string comments: type: array - items: *485 + items: *487 - title: Timeline Assigned Issue Event description: Timeline Assigned Issue Event type: object @@ -86551,7 +87137,7 @@ paths: headers: Link: *38 '404': *6 - '410': *379 + '410': *381 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -86568,8 +87154,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deploy-keys/deploy-keys#list-deploy-keys parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -86579,7 +87165,7 @@ paths: application/json: schema: type: array - items: &580 + items: &582 title: Deploy Key description: An SSH key granting access to a single repository. type: object @@ -86646,8 +87232,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deploy-keys/deploy-keys#create-a-deploy-key parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -86683,9 +87269,9 @@ paths: description: Response content: application/json: - schema: *580 + schema: *582 examples: - default: &581 + default: &583 value: id: 1 key: ssh-rsa AAA... @@ -86719,9 +87305,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deploy-keys/deploy-keys#get-a-deploy-key parameters: - - *368 - - *369 - - &582 + - *370 + - *371 + - &584 name: key_id description: The unique identifier of the key. in: path @@ -86733,9 +87319,9 @@ paths: description: Response content: application/json: - schema: *580 + schema: *582 examples: - default: *581 + default: *583 '404': *6 x-github: githubCloudOnly: false @@ -86753,9 +87339,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deploy-keys/deploy-keys#delete-a-deploy-key parameters: - - *368 - - *369 - - *582 + - *370 + - *371 + - *584 responses: '204': description: Response @@ -86775,8 +87361,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#list-labels-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -86786,9 +87372,9 @@ paths: application/json: schema: type: array - items: *564 + items: *566 examples: - default: *565 + default: *567 headers: Link: *38 '404': *6 @@ -86809,8 +87395,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#create-a-label parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -86846,9 +87432,9 @@ paths: description: Response content: application/json: - schema: *564 + schema: *566 examples: - default: &583 + default: &585 value: id: 208045946 node_id: MDU6TGFiZWwyMDgwNDU5NDY= @@ -86880,8 +87466,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#get-a-label parameters: - - *368 - - *369 + - *370 + - *371 - name: name in: path required: true @@ -86892,9 +87478,9 @@ paths: description: Response content: application/json: - schema: *564 + schema: *566 examples: - default: *583 + default: *585 '404': *6 x-github: githubCloudOnly: false @@ -86911,8 +87497,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#update-a-label parameters: - - *368 - - *369 + - *370 + - *371 - name: name in: path required: true @@ -86951,7 +87537,7 @@ paths: description: Response content: application/json: - schema: *564 + schema: *566 examples: default: value: @@ -86977,8 +87563,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#delete-a-label parameters: - - *368 - - *369 + - *370 + - *371 - name: name in: path required: true @@ -87004,8 +87590,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#list-repository-languages parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -87041,8 +87627,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/lfs#enable-git-lfs-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '202': *37 '403': @@ -87070,8 +87656,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/lfs#disable-git-lfs-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response @@ -87097,9 +87683,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/licenses/licenses#get-the-license-for-a-repository parameters: - - *368 - - *369 - - *463 + - *370 + - *371 + - *465 responses: '200': description: Response @@ -87165,7 +87751,7 @@ paths: license: anyOf: - type: 'null' - - *152 + - *155 required: - _links - git_url @@ -87246,8 +87832,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branches#sync-a-fork-branch-with-the-upstream-repository parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -87312,8 +87898,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branches#merge-a-branch parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -87347,9 +87933,9 @@ paths: description: Successful Response (The resulting merge commit) content: application/json: - schema: *486 + schema: *488 examples: - default: *584 + default: *586 '204': description: Response when already merged '404': @@ -87374,8 +87960,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/milestones#list-milestones parameters: - - *368 - - *369 + - *370 + - *371 - name: state description: The state of the milestone. Either `open`, `closed`, or `all`. in: query @@ -87416,7 +88002,7 @@ paths: application/json: schema: type: array - items: *490 + items: *492 examples: default: value: @@ -87472,8 +88058,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/milestones#create-a-milestone parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -87513,9 +88099,9 @@ paths: description: Response content: application/json: - schema: *490 + schema: *492 examples: - default: &585 + default: &587 value: url: https://api.github.com/repos/octocat/Hello-World/milestones/1 html_url: https://github.com/octocat/Hello-World/milestones/v1.0 @@ -87574,9 +88160,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/milestones#get-a-milestone parameters: - - *368 - - *369 - - &586 + - *370 + - *371 + - &588 name: milestone_number description: The number that identifies the milestone. in: path @@ -87588,9 +88174,9 @@ paths: description: Response content: application/json: - schema: *490 + schema: *492 examples: - default: *585 + default: *587 '404': *6 x-github: githubCloudOnly: false @@ -87607,9 +88193,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/milestones#update-a-milestone parameters: - - *368 - - *369 - - *586 + - *370 + - *371 + - *588 requestBody: required: false content: @@ -87647,9 +88233,9 @@ paths: description: Response content: application/json: - schema: *490 + schema: *492 examples: - default: *585 + default: *587 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -87665,9 +88251,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/milestones#delete-a-milestone parameters: - - *368 - - *369 - - *586 + - *370 + - *371 + - *588 responses: '204': description: Response @@ -87688,9 +88274,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#list-labels-for-issues-in-a-milestone parameters: - - *368 - - *369 - - *586 + - *370 + - *371 + - *588 - *17 - *19 responses: @@ -87700,9 +88286,9 @@ paths: application/json: schema: type: array - items: *564 + items: *566 examples: - default: *565 + default: *567 headers: Link: *38 x-github: @@ -87721,12 +88307,12 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/notifications#list-repository-notifications-for-the-authenticated-user parameters: - - *368 - - *369 - - *587 - - *588 - - *141 + - *370 + - *371 - *589 + - *590 + - *144 + - *591 - *17 - *19 responses: @@ -87736,9 +88322,9 @@ paths: application/json: schema: type: array - items: *163 + items: *166 examples: - default: *590 + default: *592 headers: Link: *38 x-github: @@ -87762,8 +88348,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/notifications#mark-repository-notifications-as-read parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: false content: @@ -87821,14 +88407,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#get-a-apiname-pages-site parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response content: application/json: - schema: &591 + schema: &593 title: GitHub Pages description: The configuration for GitHub Pages for a repository. type: object @@ -87972,7 +88558,7 @@ paths: - custom_404 - public examples: - default: &592 + default: &594 value: url: https://api.github.com/repos/github/developer.github.com/pages status: built @@ -88013,8 +88599,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#create-a-apiname-pages-site parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -88069,11 +88655,11 @@ paths: description: Response content: application/json: - schema: *591 + schema: *593 examples: - default: *592 + default: *594 '422': *15 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -88094,8 +88680,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#update-information-about-a-apiname-pages-site parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -88182,7 +88768,7 @@ paths: description: Response '422': *15 '400': *14 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -88203,14 +88789,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#delete-a-apiname-pages-site parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response '422': *15 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -88230,8 +88816,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#list-apiname-pages-builds parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -88241,7 +88827,7 @@ paths: application/json: schema: type: array - items: &593 + items: &595 title: Page Build description: Page Build type: object @@ -88333,8 +88919,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#request-a-apiname-pages-build parameters: - - *368 - - *369 + - *370 + - *371 responses: '201': description: Response @@ -88381,16 +88967,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#get-latest-pages-build parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response content: application/json: - schema: *593 + schema: *595 examples: - default: &594 + default: &596 value: url: https://api.github.com/repos/github/developer.github.com/pages/builds/5472601 status: built @@ -88438,8 +89024,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#get-apiname-pages-build parameters: - - *368 - - *369 + - *370 + - *371 - name: build_id in: path required: true @@ -88450,9 +89036,9 @@ paths: description: Response content: application/json: - schema: *593 + schema: *595 examples: - default: *594 + default: *596 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -88472,8 +89058,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#create-a-github-pages-deployment parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -88581,9 +89167,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#get-the-status-of-a-github-pages-deployment parameters: - - *368 - - *369 - - &595 + - *370 + - *371 + - &597 name: pages_deployment_id description: The ID of the Pages deployment. You can also give the commit SHA of the deployment. @@ -88641,11 +89227,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#cancel-a-github-pages-deployment parameters: - - *368 - - *369 - - *595 + - *370 + - *371 + - *597 responses: - '204': *116 + '204': *119 '404': *6 x-github: githubCloudOnly: false @@ -88670,8 +89256,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#get-a-dns-health-check-for-github-pages parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -88939,7 +89525,7 @@ paths: description: Empty response content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -88966,8 +89552,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#check-if-private-vulnerability-reporting-is-enabled-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Private vulnerability reporting status @@ -89004,10 +89590,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#enable-private-vulnerability-reporting-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: - '204': *116 + '204': *119 '422': *14 x-github: githubCloudOnly: false @@ -89026,10 +89612,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#disable-private-vulnerability-reporting-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: - '204': *116 + '204': *119 '422': *14 x-github: githubCloudOnly: false @@ -89050,8 +89636,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/projects#list-repository-projects parameters: - - *368 - - *369 + - *370 + - *371 - name: state description: Indicates the state of the projects to return. in: query @@ -89072,7 +89658,7 @@ paths: application/json: schema: type: array - items: *315 + items: *317 examples: default: value: @@ -89112,7 +89698,7 @@ paths: '401': *23 '403': *27 '404': *6 - '410': *379 + '410': *381 '422': *7 x-github: githubCloudOnly: false @@ -89135,8 +89721,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/projects#create-a-repository-project parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -89162,13 +89748,13 @@ paths: description: Response content: application/json: - schema: *315 + schema: *317 examples: - default: *378 + default: *380 '401': *23 '403': *27 '404': *6 - '410': *379 + '410': *381 '422': *7 x-github: githubCloudOnly: false @@ -89191,8 +89777,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/custom-properties#get-all-custom-property-values-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -89200,7 +89786,7 @@ paths: application/json: schema: type: array - items: *317 + items: *319 examples: default: value: @@ -89231,8 +89817,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/custom-properties#create-or-update-custom-property-values-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -89244,7 +89830,7 @@ paths: type: array description: A list of custom property names and associated values to apply to the repositories. - items: *317 + items: *319 required: - properties examples: @@ -89294,8 +89880,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#list-pull-requests parameters: - - *368 - - *369 + - *370 + - *371 - name: state description: Either `open`, `closed`, or `all` to filter by state. in: query @@ -89355,9 +89941,9 @@ paths: application/json: schema: type: array - items: *596 + items: *598 examples: - default: *597 + default: *599 headers: Link: *38 '304': *35 @@ -89389,8 +89975,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#create-a-pull-request parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -89457,7 +90043,7 @@ paths: description: Response content: application/json: - schema: &601 + schema: &603 type: object title: Pull Request description: Pull requests let you tell others about changes you've @@ -89586,7 +90172,7 @@ paths: milestone: anyOf: - type: 'null' - - *490 + - *492 active_lock_reason: type: - string @@ -89641,7 +90227,7 @@ paths: type: - array - 'null' - items: *297 + items: *299 head: type: object properties: @@ -89679,14 +90265,14 @@ paths: _links: type: object properties: - comments: *491 - commits: *491 - statuses: *491 - html: *491 - issue: *491 - review_comments: *491 - review_comment: *491 - self: *491 + comments: *493 + commits: *493 + statuses: *493 + html: *493 + issue: *493 + review_comments: *493 + review_comment: *493 + self: *493 required: - comments - commits @@ -89696,8 +90282,8 @@ paths: - review_comments - review_comment - self - author_association: *138 - auto_merge: *598 + author_association: *141 + auto_merge: *600 draft: description: Indicates whether or not the pull request is a draft. type: boolean @@ -89799,7 +90385,7 @@ paths: - merged_by - review_comments examples: - default: &602 + default: &604 value: url: https://api.github.com/repos/octocat/Hello-World/pulls/1347 id: 1 @@ -90326,8 +90912,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/comments#list-review-comments-in-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - name: sort in: query required: false @@ -90346,7 +90932,7 @@ paths: enum: - asc - desc - - *141 + - *144 - *17 - *19 responses: @@ -90356,9 +90942,9 @@ paths: application/json: schema: type: array - items: *599 + items: *601 examples: - default: &604 + default: &606 value: - url: https://api.github.com/repos/octocat/Hello-World/pulls/comments/1 pull_request_review_id: 42 @@ -90435,17 +91021,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/comments#get-a-review-comment-for-a-pull-request parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 responses: '200': description: Response content: application/json: - schema: *599 + schema: *601 examples: - default: &600 + default: &602 value: url: https://api.github.com/repos/octocat/Hello-World/pulls/comments/1 pull_request_review_id: 42 @@ -90520,9 +91106,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/comments#update-a-review-comment-for-a-pull-request parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 requestBody: required: true content: @@ -90544,9 +91130,9 @@ paths: description: Response content: application/json: - schema: *599 + schema: *601 examples: - default: *600 + default: *602 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -90562,9 +91148,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/comments#delete-a-review-comment-for-a-pull-request parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 responses: '204': description: Response @@ -90585,9 +91171,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#list-reactions-for-a-pull-request-review-comment parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 - name: content description: Returns a single [reaction type](https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to a pull request review comment. @@ -90613,9 +91199,9 @@ paths: application/json: schema: type: array - items: *357 + items: *359 examples: - default: *359 + default: *361 headers: Link: *38 '404': *6 @@ -90636,9 +91222,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#create-reaction-for-a-pull-request-review-comment parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 requestBody: required: true content: @@ -90670,16 +91256,16 @@ paths: description: Reaction exists content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 '201': description: Reaction created content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 '422': *15 x-github: githubCloudOnly: false @@ -90701,10 +91287,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#delete-a-pull-request-comment-reaction parameters: - - *368 - - *369 - - *150 - - *360 + - *370 + - *371 + - *153 + - *362 responses: '204': description: Response @@ -90747,9 +91333,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#get-a-pull-request parameters: - - *368 - - *369 - - &603 + - *370 + - *371 + - &605 name: pull_number description: The number that identifies the pull request. in: path @@ -90762,9 +91348,9 @@ paths: to fetch diff and patch formats. content: application/json: - schema: *601 + schema: *603 examples: - default: *602 + default: *604 '304': *35 '404': *6 '406': @@ -90772,8 +91358,8 @@ paths: content: application/json: schema: *3 - '500': *83 - '503': *130 + '500': *86 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -90799,9 +91385,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#update-a-pull-request parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 requestBody: required: false content: @@ -90843,9 +91429,9 @@ paths: description: Response content: application/json: - schema: *601 + schema: *603 examples: - default: *602 + default: *604 '422': *15 '403': *27 x-github: @@ -90867,9 +91453,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#create-a-codespace-from-a-pull-request parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 requestBody: required: true content: @@ -90930,21 +91516,21 @@ paths: description: Response when the codespace was successfully created content: application/json: - schema: *288 + schema: *290 examples: - default: *477 + default: *479 '202': description: Response when the codespace creation partially failed but is being retried in the background content: application/json: - schema: *288 + schema: *290 examples: - default: *477 + default: *479 '401': *23 '403': *27 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -90970,10 +91556,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/comments#list-review-comments-on-a-pull-request parameters: - - *368 - - *369 - - *603 - - *160 + - *370 + - *371 + - *605 + - *163 - name: direction description: The direction to sort results. Ignored without `sort` parameter. in: query @@ -90983,7 +91569,7 @@ paths: enum: - asc - desc - - *141 + - *144 - *17 - *19 responses: @@ -90993,9 +91579,9 @@ paths: application/json: schema: type: array - items: *599 + items: *601 examples: - default: *604 + default: *606 headers: Link: *38 x-github: @@ -91028,9 +91614,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/comments#create-a-review-comment-for-a-pull-request parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 requestBody: required: true content: @@ -91136,7 +91722,7 @@ paths: description: Response content: application/json: - schema: *599 + schema: *601 examples: example-for-a-multi-line-comment: value: @@ -91224,10 +91810,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/comments#create-a-reply-for-a-review-comment parameters: - - *368 - - *369 - - *603 - - *150 + - *370 + - *371 + - *605 + - *153 requestBody: required: true content: @@ -91249,7 +91835,7 @@ paths: description: Response content: application/json: - schema: *599 + schema: *601 examples: default: value: @@ -91335,9 +91921,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#list-commits-on-a-pull-request parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 - *17 - *19 responses: @@ -91347,9 +91933,9 @@ paths: application/json: schema: type: array - items: *486 + items: *488 examples: - default: *605 + default: *607 headers: Link: *38 x-github: @@ -91379,9 +91965,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#list-pull-requests-files parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 - *17 - *19 responses: @@ -91391,7 +91977,7 @@ paths: application/json: schema: type: array - items: *498 + items: *500 examples: default: value: @@ -91409,8 +91995,8 @@ paths: headers: Link: *38 '422': *15 - '500': *83 - '503': *130 + '500': *86 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -91429,9 +92015,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#check-if-a-pull-request-has-been-merged parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 responses: '204': description: Response if pull request has been merged @@ -91454,9 +92040,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#merge-a-pull-request parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 requestBody: required: false content: @@ -91568,9 +92154,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/review-requests#get-all-requested-reviewers-for-a-pull-request parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 responses: '200': description: Response @@ -91586,7 +92172,7 @@ paths: items: *4 teams: type: array - items: *224 + items: *226 required: - users - teams @@ -91645,9 +92231,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/review-requests#request-reviewers-for-a-pull-request parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 requestBody: required: false content: @@ -91684,7 +92270,7 @@ paths: description: Response content: application/json: - schema: *596 + schema: *598 examples: default: value: @@ -92220,9 +92806,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/review-requests#remove-requested-reviewers-from-a-pull-request parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 requestBody: required: true content: @@ -92256,7 +92842,7 @@ paths: description: Response content: application/json: - schema: *596 + schema: *598 examples: default: value: @@ -92761,9 +93347,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#list-reviews-for-a-pull-request parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 - *17 - *19 responses: @@ -92773,7 +93359,7 @@ paths: application/json: schema: type: array - items: &606 + items: &608 title: Pull Request Review description: Pull Request Reviews are reviews on pull requests. type: object @@ -92847,7 +93433,7 @@ paths: type: string body_text: type: string - author_association: *138 + author_association: *141 required: - id - node_id @@ -92929,9 +93515,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#create-a-review-for-a-pull-request parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 requestBody: required: false content: @@ -93021,9 +93607,9 @@ paths: description: Response content: application/json: - schema: *606 + schema: *608 examples: - default: &608 + default: &610 value: id: 80 node_id: MDE3OlB1bGxSZXF1ZXN0UmV2aWV3ODA= @@ -93086,10 +93672,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#get-a-review-for-a-pull-request parameters: - - *368 - - *369 - - *603 - - &607 + - *370 + - *371 + - *605 + - &609 name: review_id description: The unique identifier of the review. in: path @@ -93101,9 +93687,9 @@ paths: description: Response content: application/json: - schema: *606 + schema: *608 examples: - default: &609 + default: &611 value: id: 80 node_id: MDE3OlB1bGxSZXF1ZXN0UmV2aWV3ODA= @@ -93162,10 +93748,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#update-a-review-for-a-pull-request parameters: - - *368 - - *369 - - *603 - - *607 + - *370 + - *371 + - *605 + - *609 requestBody: required: true content: @@ -93188,7 +93774,7 @@ paths: description: Response content: application/json: - schema: *606 + schema: *608 examples: default: value: @@ -93250,18 +93836,18 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#delete-a-pending-review-for-a-pull-request parameters: - - *368 - - *369 - - *603 - - *607 + - *370 + - *371 + - *605 + - *609 responses: '200': description: Response content: application/json: - schema: *606 + schema: *608 examples: - default: *608 + default: *610 '422': *7 '404': *6 x-github: @@ -93288,10 +93874,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#list-comments-for-a-pull-request-review parameters: - - *368 - - *369 - - *603 - - *607 + - *370 + - *371 + - *605 + - *609 - *17 - *19 responses: @@ -93385,13 +93971,13 @@ paths: format: uri examples: - https://api.github.com/repos/octocat/Hello-World/pulls/1 - author_association: *138 + author_association: *141 _links: type: object properties: - self: *491 - html: *491 - pull_request: *491 + self: *493 + html: *493 + pull_request: *493 required: - self - html @@ -93400,7 +93986,7 @@ paths: type: string body_html: type: string - reactions: *139 + reactions: *142 side: description: The side of the first line of the range for a multi-line comment. @@ -93549,10 +94135,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#dismiss-a-review-for-a-pull-request parameters: - - *368 - - *369 - - *603 - - *607 + - *370 + - *371 + - *605 + - *609 requestBody: required: true content: @@ -93581,7 +94167,7 @@ paths: description: Response content: application/json: - schema: *606 + schema: *608 examples: default: value: @@ -93644,10 +94230,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#submit-a-review-for-a-pull-request parameters: - - *368 - - *369 - - *603 - - *607 + - *370 + - *371 + - *605 + - *609 requestBody: required: true content: @@ -93682,9 +94268,9 @@ paths: description: Response content: application/json: - schema: *606 + schema: *608 examples: - default: *609 + default: *611 '404': *6 '422': *7 '403': *27 @@ -93706,9 +94292,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#update-a-pull-request-branch parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 requestBody: required: false content: @@ -93772,8 +94358,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/contents#get-a-repository-readme parameters: - - *368 - - *369 + - *370 + - *371 - name: ref description: 'The name of the commit/branch/tag. Default: the repository’s default branch.' @@ -93786,9 +94372,9 @@ paths: description: Response content: application/json: - schema: *610 + schema: *612 examples: - default: &611 + default: &613 value: type: file encoding: base64 @@ -93830,8 +94416,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/contents#get-a-repository-readme-for-a-directory parameters: - - *368 - - *369 + - *370 + - *371 - name: dir description: The alternate path to look for a README file in: path @@ -93851,9 +94437,9 @@ paths: description: Response content: application/json: - schema: *610 + schema: *612 examples: - default: *611 + default: *613 '404': *6 '422': *15 x-github: @@ -93875,8 +94461,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/releases#list-releases parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -93886,7 +94472,7 @@ paths: application/json: schema: type: array - items: &612 + items: &614 title: Release description: A release. type: object @@ -93958,7 +94544,7 @@ paths: author: *4 assets: type: array - items: &613 + items: &615 title: Release Asset description: Data related to a release. type: object @@ -94033,7 +94619,7 @@ paths: description: The URL of the release discussion. type: string format: uri - reactions: *139 + reactions: *142 required: - assets_url - upload_url @@ -94144,8 +94730,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/releases#create-a-release parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -94221,9 +94807,9 @@ paths: description: Response content: application/json: - schema: *612 + schema: *614 examples: - default: &616 + default: &618 value: url: https://api.github.com/repos/octocat/Hello-World/releases/1 html_url: https://github.com/octocat/Hello-World/releases/v1.0.0 @@ -94327,9 +94913,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/assets#get-a-release-asset parameters: - - *368 - - *369 - - &614 + - *370 + - *371 + - &616 name: asset_id description: The unique identifier of the asset. in: path @@ -94341,9 +94927,9 @@ paths: description: Response content: application/json: - schema: *613 + schema: *615 examples: - default: &615 + default: &617 value: url: https://api.github.com/repos/octocat/Hello-World/releases/assets/1 browser_download_url: https://github.com/octocat/Hello-World/releases/download/v1.0.0/example.zip @@ -94378,7 +94964,7 @@ paths: type: User site_admin: false '404': *6 - '302': *500 + '302': *502 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -94394,9 +94980,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/assets#update-a-release-asset parameters: - - *368 - - *369 - - *614 + - *370 + - *371 + - *616 requestBody: required: false content: @@ -94425,9 +95011,9 @@ paths: description: Response content: application/json: - schema: *613 + schema: *615 examples: - default: *615 + default: *617 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -94443,9 +95029,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/assets#delete-a-release-asset parameters: - - *368 - - *369 - - *614 + - *370 + - *371 + - *616 responses: '204': description: Response @@ -94469,8 +95055,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/releases#generate-release-notes-content-for-a-release parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -94556,16 +95142,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/releases#get-the-latest-release parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response content: application/json: - schema: *612 + schema: *614 examples: - default: *616 + default: *618 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -94582,8 +95168,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/releases#get-a-release-by-tag-name parameters: - - *368 - - *369 + - *370 + - *371 - name: tag description: tag parameter in: path @@ -94596,9 +95182,9 @@ paths: description: Response content: application/json: - schema: *612 + schema: *614 examples: - default: *616 + default: *618 '404': *6 x-github: githubCloudOnly: false @@ -94620,9 +95206,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/releases#get-a-release parameters: - - *368 - - *369 - - &617 + - *370 + - *371 + - &619 name: release_id description: The unique identifier of the release. in: path @@ -94636,9 +95222,9 @@ paths: For more information, see "[Getting started with the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/getting-started-with-the-rest-api#hypermedia)."' content: application/json: - schema: *612 + schema: *614 examples: - default: *616 + default: *618 '401': description: Unauthorized x-github: @@ -94656,9 +95242,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/releases#update-a-release parameters: - - *368 - - *369 - - *617 + - *370 + - *371 + - *619 requestBody: required: false content: @@ -94722,9 +95308,9 @@ paths: description: Response content: application/json: - schema: *612 + schema: *614 examples: - default: *616 + default: *618 '404': description: Not Found if the discussion category name is invalid content: @@ -94745,9 +95331,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/releases#delete-a-release parameters: - - *368 - - *369 - - *617 + - *370 + - *371 + - *619 responses: '204': description: Response @@ -94767,9 +95353,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/assets#list-release-assets parameters: - - *368 - - *369 - - *617 + - *370 + - *371 + - *619 - *17 - *19 responses: @@ -94779,7 +95365,7 @@ paths: application/json: schema: type: array - items: *613 + items: *615 examples: default: value: @@ -94861,9 +95447,9 @@ paths: description: The URL origin (protocol + host name + port) is included in `upload_url` returned in the response of the "Create a release" endpoint parameters: - - *368 - - *369 - - *617 + - *370 + - *371 + - *619 - name: name in: query required: true @@ -94889,7 +95475,7 @@ paths: description: Response for successful upload content: application/json: - schema: *613 + schema: *615 examples: response-for-successful-upload: value: @@ -94944,9 +95530,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#list-reactions-for-a-release parameters: - - *368 - - *369 - - *617 + - *370 + - *371 + - *619 - name: content description: Returns a single [reaction type](https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to a release. @@ -94970,9 +95556,9 @@ paths: application/json: schema: type: array - items: *357 + items: *359 examples: - default: *359 + default: *361 headers: Link: *38 '404': *6 @@ -94993,9 +95579,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#create-reaction-for-a-release parameters: - - *368 - - *369 - - *617 + - *370 + - *371 + - *619 requestBody: required: true content: @@ -95025,16 +95611,16 @@ paths: description: Reaction exists content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 '201': description: Reaction created content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 '422': *15 x-github: githubCloudOnly: false @@ -95056,10 +95642,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#delete-a-release-reaction parameters: - - *368 - - *369 - - *617 - - *360 + - *370 + - *371 + - *619 + - *362 responses: '204': description: Response @@ -95083,9 +95669,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/rules#get-rules-for-a-branch parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 - *17 - *19 responses: @@ -95101,8 +95687,8 @@ paths: description: A repository rule with ruleset details. oneOf: - allOf: - - *618 - - &620 + - *620 + - &622 title: repository ruleset data for rule description: User-defined metadata to store domain-specific information limited to 8 keys with scalar values. @@ -95121,66 +95707,66 @@ paths: ruleset_id: type: integer description: The ID of the ruleset that includes this rule. - - allOf: - - *619 - - *620 - allOf: - *621 - - *620 - - allOf: - *622 - - *620 - allOf: - *623 - - *620 + - *622 - allOf: - *624 - - *620 + - *622 - allOf: - *625 - - *620 + - *622 - allOf: - *626 - - *620 + - *622 - allOf: - *627 - - *620 + - *622 - allOf: - *628 - - *620 + - *622 - allOf: - *629 - - *620 + - *622 - allOf: - *630 - - *620 + - *622 - allOf: - *631 - - *620 + - *622 - allOf: - *632 - - *620 + - *622 - allOf: - *633 - - *620 + - *622 - allOf: - *634 - - *620 + - *622 - allOf: - *635 - - *620 + - *622 - allOf: - *636 - - *620 + - *622 - allOf: - *637 - - *620 + - *622 - allOf: - *638 - - *620 + - *622 - allOf: - *639 - - *620 + - *622 + - allOf: + - *640 + - *622 + - allOf: + - *641 + - *622 examples: default: value: @@ -95219,8 +95805,8 @@ paths: category: repos subcategory: rules parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 - name: includes_parents @@ -95231,7 +95817,7 @@ paths: schema: type: boolean default: true - - *640 + - *642 responses: '200': description: Response @@ -95239,7 +95825,7 @@ paths: application/json: schema: type: array - items: *126 + items: *129 examples: default: value: @@ -95270,7 +95856,7 @@ paths: created_at: '2023-08-15T08:43:03Z' updated_at: '2023-09-23T16:29:47Z' '404': *6 - '500': *83 + '500': *86 post: summary: Create a repository ruleset description: Create a ruleset for a repository. @@ -95286,8 +95872,8 @@ paths: category: repos subcategory: rules parameters: - - *368 - - *369 + - *370 + - *371 requestBody: description: Request body required: true @@ -95307,16 +95893,16 @@ paths: - tag - push default: branch - enforcement: *123 + enforcement: *126 bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: *124 - conditions: *119 + items: *127 + conditions: *122 rules: type: array description: An array of rules within the ruleset. - items: *125 + items: *128 required: - name - enforcement @@ -95347,9 +95933,9 @@ paths: description: Response content: application/json: - schema: *126 + schema: *129 examples: - default: &649 + default: &651 value: id: 42 name: super cool ruleset @@ -95382,7 +95968,7 @@ paths: created_at: '2023-07-15T08:43:03Z' updated_at: '2023-08-23T16:29:47Z' '404': *6 - '500': *83 + '500': *86 "/repos/{owner}/{repo}/rulesets/rule-suites": get: summary: List repository rule suites @@ -95396,12 +95982,12 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/rule-suites#list-repository-rule-suites parameters: - - *368 - - *369 - - *641 - - *218 - - *642 + - *370 + - *371 - *643 + - *220 + - *644 + - *645 - *17 - *19 responses: @@ -95409,11 +95995,11 @@ paths: description: Response content: application/json: - schema: *644 + schema: *646 examples: - default: *645 + default: *647 '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -95432,19 +96018,19 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/rule-suites#get-a-repository-rule-suite parameters: - - *368 - - *369 - - *646 + - *370 + - *371 + - *648 responses: '200': description: Response content: application/json: - schema: *647 + schema: *649 examples: - default: *648 + default: *650 '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -95470,8 +96056,8 @@ paths: category: repos subcategory: rules parameters: - - *368 - - *369 + - *370 + - *371 - name: ruleset_id description: The ID of the ruleset. in: path @@ -95491,11 +96077,11 @@ paths: description: Response content: application/json: - schema: *126 + schema: *129 examples: - default: *649 + default: *651 '404': *6 - '500': *83 + '500': *86 put: summary: Update a repository ruleset description: Update a ruleset for a repository. @@ -95511,8 +96097,8 @@ paths: category: repos subcategory: rules parameters: - - *368 - - *369 + - *370 + - *371 - name: ruleset_id description: The ID of the ruleset. in: path @@ -95537,16 +96123,16 @@ paths: - branch - tag - push - enforcement: *123 + enforcement: *126 bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: *124 - conditions: *119 + items: *127 + conditions: *122 rules: description: An array of rules within the ruleset. type: array - items: *125 + items: *128 examples: default: value: @@ -95574,11 +96160,11 @@ paths: description: Response content: application/json: - schema: *126 + schema: *129 examples: - default: *649 + default: *651 '404': *6 - '500': *83 + '500': *86 delete: summary: Delete a repository ruleset description: Delete a ruleset for a repository. @@ -95594,8 +96180,8 @@ paths: category: repos subcategory: rules parameters: - - *368 - - *369 + - *370 + - *371 - name: ruleset_id description: The ID of the ruleset. in: path @@ -95606,7 +96192,7 @@ paths: '204': description: Response '404': *6 - '500': *83 + '500': *86 "/repos/{owner}/{repo}/rulesets/{ruleset_id}/history": get: summary: Get repository ruleset history @@ -95618,8 +96204,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/rules#get-repository-ruleset-history parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 - name: ruleset_id @@ -95635,11 +96221,11 @@ paths: application/json: schema: type: array - items: *129 + items: *132 examples: - default: *323 + default: *325 '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -95656,8 +96242,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/rules#get-repository-ruleset-version parameters: - - *368 - - *369 + - *370 + - *371 - name: ruleset_id description: The ID of the ruleset. in: path @@ -95675,7 +96261,7 @@ paths: description: Response content: application/json: - schema: *324 + schema: *326 examples: default: value: @@ -95708,7 +96294,7 @@ paths: operator: contains pattern: github '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -95730,21 +96316,21 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/secret-scanning/secret-scanning#list-secret-scanning-alerts-for-a-repository parameters: - - *368 - - *369 - - *325 - - *326 + - *370 + - *371 - *327 - *328 - - *86 - - *19 - - *17 - - *650 - - *651 - *329 - *330 + - *89 + - *19 + - *17 + - *652 + - *653 - *331 - *332 + - *333 + - *334 responses: '200': description: Response @@ -95752,24 +96338,24 @@ paths: application/json: schema: type: array - items: &655 + items: &657 type: object properties: - number: *96 - created_at: *103 + number: *99 + created_at: *106 updated_at: anyOf: - type: 'null' - - *104 - url: *101 - html_url: *102 + - *107 + url: *104 + html_url: *105 locations_url: type: string format: uri description: The REST API URL of the code locations for this alert. - state: *652 - resolution: *653 + state: *654 + resolution: *655 resolved_at: type: - string @@ -95863,7 +96449,7 @@ paths: first_location_detected: anyOf: - type: 'null' - - *654 + - *656 has_more_locations: type: boolean description: A boolean value representing whether or not the @@ -95990,7 +96576,7 @@ paths: '404': description: Repository is public or secret scanning is disabled for the repository - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -96012,16 +96598,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/secret-scanning/secret-scanning#get-a-secret-scanning-alert parameters: - - *368 - - *369 - - *457 - - *332 + - *370 + - *371 + - *459 + - *334 responses: '200': description: Response content: application/json: - schema: *655 + schema: *657 examples: default: value: @@ -96052,7 +96638,7 @@ paths: '404': description: Repository is public, or secret scanning is disabled for the repository, or the resource is not found - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -96073,9 +96659,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/secret-scanning/secret-scanning#update-a-secret-scanning-alert parameters: - - *368 - - *369 - - *457 + - *370 + - *371 + - *459 requestBody: required: true content: @@ -96083,8 +96669,8 @@ paths: schema: type: object properties: - state: *652 - resolution: *653 + state: *654 + resolution: *655 resolution_comment: description: An optional comment when closing or reopening an alert. Cannot be updated or deleted. @@ -96103,7 +96689,7 @@ paths: description: Response content: application/json: - schema: *655 + schema: *657 examples: default: value: @@ -96156,7 +96742,7 @@ paths: repository, or the resource is not found '422': description: State does not match the resolution or resolution comment - '503': *130 + '503': *133 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -96178,9 +96764,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/secret-scanning/secret-scanning#list-locations-for-a-secret-scanning-alert parameters: - - *368 - - *369 - - *457 + - *370 + - *371 + - *459 - *19 - *17 responses: @@ -96191,7 +96777,7 @@ paths: schema: type: array description: List of locations where the secret was detected - items: &827 + items: &829 type: object properties: type: @@ -96218,8 +96804,6 @@ paths: - commit details: oneOf: - - *656 - - *657 - *658 - *659 - *660 @@ -96231,6 +96815,8 @@ paths: - *666 - *667 - *668 + - *669 + - *670 examples: default: value: @@ -96294,7 +96880,7 @@ paths: '404': description: Repository is public, or secret scanning is disabled for the repository, or the resource is not found - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -96316,8 +96902,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/secret-scanning/secret-scanning#create-a-push-protection-bypass parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -96325,14 +96911,14 @@ paths: schema: type: object properties: - reason: &670 + reason: &672 description: The reason for bypassing push protection. type: string enum: - false_positive - used_in_tests - will_fix_later - placeholder_id: *669 + placeholder_id: *671 required: - reason - placeholder_id @@ -96349,7 +96935,7 @@ paths: schema: type: object properties: - reason: *670 + reason: *672 expire_at: type: - string @@ -96373,7 +96959,7 @@ paths: this repository. '422': description: Bad request, input data missing or incorrect. - '503': *130 + '503': *133 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -96393,13 +96979,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/secret-scanning/secret-scanning#get-secret-scanning-scan-history-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '404': description: Repository does not have GitHub Advanced Security or secret scanning enabled - '503': *130 + '503': *133 '200': description: Response content: @@ -96409,7 +96995,7 @@ paths: properties: incremental_scans: type: array - items: &671 + items: &673 description: Information on a single scan performed by secret scanning on the repository type: object @@ -96437,15 +97023,15 @@ paths: the scan is pending pattern_update_scans: type: array - items: *671 + items: *673 backfill_scans: type: array - items: *671 + items: *673 custom_pattern_backfill_scans: type: array items: allOf: - - *671 + - *673 - type: object properties: pattern_name: @@ -96515,9 +97101,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/repository-advisories#list-repository-security-advisories parameters: - - *368 - - *369 - - *86 + - *370 + - *371 + - *89 - name: sort description: The property to sort the results by. in: query @@ -96529,8 +97115,8 @@ paths: - updated - published default: created - - *84 - - *85 + - *87 + - *88 - name: per_page description: The number of advisories to return per page. For more information, see "[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api)." @@ -96560,9 +97146,9 @@ paths: application/json: schema: type: array - items: *672 + items: *674 examples: - default: *673 + default: *675 '400': *14 '404': *6 x-github: @@ -96585,8 +97171,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/repository-advisories#create-a-repository-security-advisory parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -96666,7 +97252,7 @@ paths: login: type: string description: The username of the user credited. - type: *335 + type: *337 required: - login - type @@ -96756,9 +97342,9 @@ paths: description: Response content: application/json: - schema: *672 + schema: *674 examples: - default: &675 + default: &677 value: ghsa_id: GHSA-abcd-1234-efgh cve_id: CVE-2050-00000 @@ -96991,8 +97577,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/repository-advisories#privately-report-a-security-vulnerability parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -97105,7 +97691,7 @@ paths: description: Response content: application/json: - schema: *672 + schema: *674 examples: default: value: @@ -97252,17 +97838,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/repository-advisories#get-a-repository-security-advisory parameters: - - *368 - - *369 - - *674 + - *370 + - *371 + - *676 responses: '200': description: Response content: application/json: - schema: *672 + schema: *674 examples: - default: *675 + default: *677 '403': *27 '404': *6 x-github: @@ -97286,9 +97872,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/repository-advisories#update-a-repository-security-advisory parameters: - - *368 - - *369 - - *674 + - *370 + - *371 + - *676 requestBody: required: true content: @@ -97368,7 +97954,7 @@ paths: login: type: string description: The username of the user credited. - type: *335 + type: *337 required: - login - type @@ -97459,17 +98045,17 @@ paths: description: Response content: application/json: - schema: *672 + schema: *674 examples: - default: *675 - add_credit: *675 + default: *677 + add_credit: *677 '403': *27 '404': *6 '422': description: Validation failed, or the endpoint has been spammed. content: application/json: - schema: *176 + schema: *178 examples: invalid_state_transition: value: @@ -97500,9 +98086,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/repository-advisories#request-a-cve-for-a-repository-security-advisory parameters: - - *368 - - *369 - - *674 + - *370 + - *371 + - *676 responses: '202': *37 '400': *14 @@ -97529,17 +98115,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/repository-advisories#create-a-temporary-private-fork parameters: - - *368 - - *369 - - *674 + - *370 + - *371 + - *676 responses: '202': description: Response content: application/json: - schema: *381 + schema: *383 examples: - default: *383 + default: *385 '400': *14 '422': *15 '403': *27 @@ -97565,8 +98151,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/starring#list-stargazers parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -97662,8 +98248,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/statistics#get-the-weekly-commit-activity parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Returns a weekly aggregate of the number of additions and deletions @@ -97672,7 +98258,7 @@ paths: application/json: schema: type: array - items: &676 + items: &678 title: Code Frequency Stat description: Code Frequency Stat type: array @@ -97685,7 +98271,7 @@ paths: - 1124 - -435 '202': *37 - '204': *116 + '204': *119 '422': description: Repository contains more than 10,000 commits x-github: @@ -97705,8 +98291,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/statistics#get-the-last-year-of-commit-activity parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -97757,7 +98343,7 @@ paths: total: 89 week: 1336280400 '202': *37 - '204': *116 + '204': *119 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -97784,8 +98370,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/statistics#get-all-contributor-commit-activity parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -97857,7 +98443,7 @@ paths: d: 77 c: 10 '202': *37 - '204': *116 + '204': *119 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -97879,8 +98465,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/statistics#get-the-weekly-commit-count parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: The array order is oldest week (index 0) to most recent week. @@ -98034,8 +98620,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/statistics#get-the-hourly-commit-count-for-each-day parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: For example, `[2, 14, 25]` indicates that there were 25 total @@ -98045,7 +98631,7 @@ paths: application/json: schema: type: array - items: *676 + items: *678 examples: default: value: @@ -98058,7 +98644,7 @@ paths: - - 0 - 2 - 21 - '204': *116 + '204': *119 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -98078,8 +98664,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/statuses#create-a-commit-status parameters: - - *368 - - *369 + - *370 + - *371 - name: sha in: path required: true @@ -98135,7 +98721,7 @@ paths: description: Response content: application/json: - schema: *677 + schema: *679 examples: default: value: @@ -98189,8 +98775,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/watching#list-watchers parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -98202,7 +98788,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: *38 x-github: @@ -98222,14 +98808,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/watching#get-a-repository-subscription parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: if you subscribe to the repository content: application/json: - schema: &678 + schema: &680 title: Repository Invitation description: Repository invitations let you manage who you collaborate with. @@ -98302,8 +98888,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/watching#set-a-repository-subscription parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: false content: @@ -98329,7 +98915,7 @@ paths: description: Response content: application/json: - schema: *678 + schema: *680 examples: default: value: @@ -98356,8 +98942,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/watching#delete-a-repository-subscription parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response @@ -98377,8 +98963,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#list-repository-tags parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -98460,8 +99046,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/tags#closing-down---list-tag-protection-states-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -98469,7 +99055,7 @@ paths: application/json: schema: type: array - items: &679 + items: &681 title: Tag protection description: Tag protection type: object @@ -98526,8 +99112,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/tags#closing-down---create-a-tag-protection-state-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -98550,7 +99136,7 @@ paths: description: Response content: application/json: - schema: *679 + schema: *681 examples: default: value: @@ -98581,8 +99167,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/tags#closing-down---delete-a-tag-protection-state-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - name: tag_protection_id description: The unique identifier of the tag protection. in: path @@ -98619,8 +99205,8 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/repos/contents#download-a-repository-archive-tar operationId: repos/download-tarball-archive parameters: - - *368 - - *369 + - *370 + - *371 - name: ref in: path required: true @@ -98656,8 +99242,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#list-repository-teams parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -98667,9 +99253,9 @@ paths: application/json: schema: type: array - items: *224 + items: *226 examples: - default: *298 + default: *300 headers: Link: *38 '404': *6 @@ -98689,8 +99275,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#get-all-repository-topics parameters: - - *368 - - *369 + - *370 + - *371 - *19 - *17 responses: @@ -98698,7 +99284,7 @@ paths: description: Response content: application/json: - schema: &680 + schema: &682 title: Topic description: A topic aggregates entities that are related to a subject. type: object @@ -98710,7 +99296,7 @@ paths: required: - names examples: - default: &681 + default: &683 value: names: - octocat @@ -98733,8 +99319,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#replace-all-repository-topics parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -98765,9 +99351,9 @@ paths: description: Response content: application/json: - schema: *680 + schema: *682 examples: - default: *681 + default: *683 '404': *6 '422': *7 x-github: @@ -98788,9 +99374,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/traffic#get-repository-clones parameters: - - *368 - - *369 - - &682 + - *370 + - *371 + - &684 name: per description: The time frame to display results for. in: query @@ -98821,7 +99407,7 @@ paths: - 128 clones: type: array - items: &683 + items: &685 title: Traffic type: object properties: @@ -98908,8 +99494,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/traffic#get-top-referral-paths parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -99003,8 +99589,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/traffic#get-top-referral-sources parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -99067,9 +99653,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/traffic#get-page-views parameters: - - *368 - - *369 - - *682 + - *370 + - *371 + - *684 responses: '200': description: Response @@ -99090,7 +99676,7 @@ paths: - 3782 views: type: array - items: *683 + items: *685 required: - uniques - count @@ -99167,8 +99753,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#transfer-a-repository parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -99204,7 +99790,7 @@ paths: description: Response content: application/json: - schema: *193 + schema: *195 examples: default: value: @@ -99442,8 +100028,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#check-if-vulnerability-alerts-are-enabled-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response if repository is enabled with vulnerability alerts @@ -99466,8 +100052,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#enable-vulnerability-alerts parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response @@ -99489,8 +100075,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#disable-vulnerability-alerts parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response @@ -99516,8 +100102,8 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/repos/contents#download-a-repository-archive-zip operationId: repos/download-zipball-archive parameters: - - *368 - - *369 + - *370 + - *371 - name: ref in: path required: true @@ -99609,9 +100195,9 @@ paths: description: Response content: application/json: - schema: *381 + schema: *383 examples: - default: *383 + default: *385 headers: Location: example: https://api.github.com/repos/octocat/Hello-World @@ -99652,7 +100238,7 @@ paths: application/json: schema: type: array - items: *193 + items: *195 examples: default: value: @@ -99762,7 +100348,7 @@ paths: value: Engineering externalId: value: 8aa1a0c0-c4c3-4bc0-b4a5-2ef676900159 - - &691 + - &693 name: excludedAttributes description: Excludes the specified attribute from being returned in the results. Using this parameter can speed up response time. @@ -99772,7 +100358,7 @@ paths: type: string examples: - members - - &696 + - &698 name: startIndex description: 'Used for pagination: the starting index of the first result to return when paginating through values.' @@ -99784,7 +100370,7 @@ paths: format: int32 examples: - 1 - - &697 + - &699 name: count description: 'Used for pagination: the number of results to return per page.' in: query @@ -99828,7 +100414,7 @@ paths: Resources: type: array description: Information about each provisioned group. - items: &685 + items: &687 allOf: - type: object required: @@ -99910,7 +100496,7 @@ paths: - value: 0db508eb-91e2-46e4-809c-30dcbda0c685 "$+ref": https://api.github.localhost/scim/v2/Users/0db508eb-91e2-46e4-809c-30dcbda0c685 displayName: User 2 - meta: &698 + meta: &700 type: object description: The metadata associated with the creation/updates to the user. @@ -99975,31 +100561,31 @@ paths: location: https://api.github.localhost/scim/v2/Groups/24b28bbb-5fc4-4686-a153-a020debb1155 startIndex: 1 itemsPerPage: 20 - '400': &686 + '400': &688 description: Bad request content: application/json: - schema: *684 + schema: *686 application/scim+json: - schema: *684 - '401': &687 + schema: *686 + '401': &689 description: Authorization failure - '403': &688 + '403': &690 description: Permission denied - '429': &689 + '429': &691 description: Too many requests content: application/json: - schema: *684 + schema: *686 application/scim+json: - schema: *684 - '500': &690 + schema: *686 + '500': &692 description: Internal server error content: application/json: - schema: *684 + schema: *686 application/scim+json: - schema: *684 + schema: *686 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -100023,7 +100609,7 @@ paths: required: true content: application/json: - schema: &694 + schema: &696 type: object required: - schemas @@ -100083,9 +100669,9 @@ paths: description: Group has been created content: application/scim+json: - schema: *685 + schema: *687 examples: - group: &692 + group: &694 value: schemas: - urn:ietf:params:scim:schemas:core:2.0:Group @@ -100104,13 +100690,13 @@ paths: created: '2012-03-27T19:59:26.000Z' lastModified: '2018-03-27T19:59:26.000Z' location: https://api.github.localhost/scim/v2/Groups/24b28bbb-5fc4-4686-a153-a020debb1155 - '400': *686 - '401': *687 - '403': *688 - '409': &695 + '400': *688 + '401': *689 + '403': *690 + '409': &697 description: Duplicate record detected - '429': *689 - '500': *690 + '429': *691 + '500': *692 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -100127,7 +100713,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/scim#get-scim-provisioning-information-for-an-enterprise-group parameters: - - &693 + - &695 name: scim_group_id description: A unique identifier of the SCIM group. in: path @@ -100136,22 +100722,22 @@ paths: type: string examples: - 7fce0092-d52e-4f76-b727-3955bd72c939 - - *691 + - *693 - *39 responses: '200': description: Success, a group was found content: application/scim+json: - schema: *685 + schema: *687 examples: - default: *692 - '400': *686 - '401': *687 - '403': *688 + default: *694 + '400': *688 + '401': *689 + '403': *690 '404': *6 - '429': *689 - '500': *690 + '429': *691 + '500': *692 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -100170,13 +100756,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/scim#set-scim-information-for-a-provisioned-enterprise-group parameters: - - *693 + - *695 - *39 requestBody: required: true content: application/json: - schema: *694 + schema: *696 examples: group: summary: Group @@ -100202,17 +100788,17 @@ paths: description: Group was updated content: application/scim+json: - schema: *685 + schema: *687 examples: - group: *692 - groupWithMembers: *692 - '400': *686 - '401': *687 - '403': *688 + group: *694 + groupWithMembers: *694 + '400': *688 + '401': *689 + '403': *690 '404': *6 - '409': *695 - '429': *689 - '500': *690 + '409': *697 + '429': *691 + '500': *692 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -100236,13 +100822,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/scim#update-an-attribute-for-a-scim-enterprise-group parameters: - - *693 + - *695 - *39 requestBody: required: true content: application/json: - schema: &705 + schema: &707 type: object required: - Operations @@ -100302,17 +100888,17 @@ paths: description: Success, group was updated content: application/scim+json: - schema: *685 + schema: *687 examples: - updateGroup: *692 - addMembers: *692 - '400': *686 - '401': *687 - '403': *688 + updateGroup: *694 + addMembers: *694 + '400': *688 + '401': *689 + '403': *690 '404': *6 - '409': *695 - '429': *689 - '500': *690 + '409': *697 + '429': *691 + '500': *692 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -100328,17 +100914,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/scim#delete-a-scim-group-from-an-enterprise parameters: - - *693 + - *695 - *39 responses: '204': description: Group was deleted, no content - '400': *686 - '401': *687 - '403': *688 + '400': *688 + '401': *689 + '403': *690 '404': *6 - '429': *689 - '500': *690 + '429': *691 + '500': *692 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -100372,8 +100958,8 @@ paths: value: userName eq 'E012345' externalId: value: externalId eq 'E012345' - - *696 - - *697 + - *698 + - *699 - *39 responses: '200': @@ -100407,7 +100993,7 @@ paths: Resources: type: array description: Information about each provisioned account. - items: &700 + items: &702 allOf: - type: object required: @@ -100499,7 +101085,7 @@ paths: address. examples: - true - roles: &699 + roles: &701 type: array description: The roles assigned to the user. items: @@ -100558,7 +101144,7 @@ paths: type: string description: Provisioned SCIM groups that the user is a member of. - meta: *698 + meta: *700 startIndex: type: integer description: A starting index for the returned page @@ -100597,11 +101183,11 @@ paths: primary: false startIndex: 1 itemsPerPage: 20 - '400': *686 - '401': *687 - '403': *688 - '429': *689 - '500': *690 + '400': *688 + '401': *689 + '403': *690 + '429': *691 + '500': *692 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -100625,7 +101211,7 @@ paths: required: true content: application/json: - schema: &703 + schema: &705 type: object required: - schemas @@ -100718,9 +101304,9 @@ paths: description: Whether this email address is the primary address. examples: - true - roles: *699 + roles: *701 examples: - user: &704 + user: &706 summary: User value: schemas: @@ -100767,9 +101353,9 @@ paths: description: User has been created content: application/scim+json: - schema: *700 + schema: *702 examples: - user: &701 + user: &703 value: schemas: - urn:ietf:params:scim:schemas:core:2.0:User @@ -100795,13 +101381,13 @@ paths: created: '2012-03-27T19:59:26.000Z' lastModified: '2018-03-27T19:59:26.000Z' location: https://api.github.localhost/scim/v2/Users/7fce0092-d52e-4f76-b727-3955bd72c939 - enterpriseOwner: *701 - '400': *686 - '401': *687 - '403': *688 - '409': *695 - '429': *689 - '500': *690 + enterpriseOwner: *703 + '400': *688 + '401': *689 + '403': *690 + '409': *697 + '429': *691 + '500': *692 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -100818,7 +101404,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/scim#get-scim-provisioning-information-for-an-enterprise-user parameters: - - &702 + - &704 name: scim_user_id description: The unique identifier of the SCIM user. in: path @@ -100831,15 +101417,15 @@ paths: description: Success, a user was found content: application/scim+json: - schema: *700 + schema: *702 examples: - default: *701 - '400': *686 - '401': *687 - '403': *688 + default: *703 + '400': *688 + '401': *689 + '403': *690 '404': *6 - '429': *689 - '500': *690 + '429': *691 + '500': *692 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -100861,30 +101447,30 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/scim#set-scim-information-for-a-provisioned-enterprise-user parameters: - - *702 + - *704 - *39 requestBody: required: true content: application/json: - schema: *703 + schema: *705 examples: - user: *704 + user: *706 responses: '200': description: User was updated content: application/scim+json: - schema: *700 + schema: *702 examples: - user: *701 - '400': *686 - '401': *687 - '403': *688 + user: *703 + '400': *688 + '401': *689 + '403': *690 '404': *6 - '409': *695 - '429': *689 - '500': *690 + '409': *697 + '429': *691 + '500': *692 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -100919,13 +101505,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/scim#update-an-attribute-for-a-scim-enterprise-user parameters: - - *702 + - *704 - *39 requestBody: required: true content: application/json: - schema: *705 + schema: *707 examples: userMultiValuedProperties: summary: Multi Valued Property @@ -100965,18 +101551,18 @@ paths: description: Success, user was updated content: application/scim+json: - schema: *700 + schema: *702 examples: - userMultiValuedProperties: *701 - userSingleValuedProperties: *701 - disableUser: *701 - '400': *686 - '401': *687 - '403': *688 + userMultiValuedProperties: *703 + userSingleValuedProperties: *703 + disableUser: *703 + '400': *688 + '401': *689 + '403': *690 '404': *6 - '409': *695 - '429': *689 - '500': *690 + '409': *697 + '429': *691 + '500': *692 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -100996,17 +101582,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/scim#delete-a-scim-user-from-an-enterprise parameters: - - *702 + - *704 - *39 responses: '204': description: User was deleted, no content - '400': *686 - '401': *687 - '403': *688 + '400': *688 + '401': *689 + '403': *690 '404': *6 - '429': *689 - '500': *690 + '429': *691 + '500': *692 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -101039,7 +101625,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/scim/scim#list-scim-provisioned-identities parameters: - - *167 + - *71 - name: startIndex description: 'Used for pagination: the index of the first result to return.' in: query @@ -101097,7 +101683,7 @@ paths: - 1 Resources: type: array - items: &706 + items: &708 title: SCIM /Users description: SCIM /Users provisioning endpoints type: object @@ -101344,22 +101930,22 @@ paths: lastModified: '2017-03-09T16:11:13-05:00' location: https://api.github.com/scim/v2/organizations/octo-org/Users/77563764-eb6-24-0598234-958243 '304': *35 - '404': &707 + '404': &709 description: Resource not found content: application/json: - schema: *684 + schema: *686 application/scim+json: - schema: *684 - '403': &708 + schema: *686 + '403': &710 description: Forbidden content: application/json: - schema: *684 + schema: *686 application/scim+json: - schema: *684 - '400': *686 - '429': *689 + schema: *686 + '400': *688 + '429': *691 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -101379,15 +101965,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/scim/scim#provision-and-invite-a-scim-user parameters: - - *167 + - *71 responses: '201': description: Response content: application/scim+json: - schema: *706 + schema: *708 examples: - default: &709 + default: &711 value: schemas: - urn:ietf:params:scim:schemas:core:2.0:User @@ -101410,17 +101996,17 @@ paths: lastModified: '2017-03-09T16:11:13-05:00' location: https://api.github.com/scim/v2/organizations/octo-org/Users/edefdfedf-050c-11e7-8d32 '304': *35 - '404': *707 - '403': *708 - '500': *690 + '404': *709 + '403': *710 + '500': *692 '409': description: Conflict content: application/json: - schema: *684 + schema: *686 application/scim+json: - schema: *684 - '400': *686 + schema: *686 + '400': *688 requestBody: required: true content: @@ -101519,18 +102105,18 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/scim/scim#get-scim-provisioning-information-for-a-user parameters: - - *167 - - *702 + - *71 + - *704 responses: '200': description: Response content: application/scim+json: - schema: *706 + schema: *708 examples: - default: *709 - '404': *707 - '403': *708 + default: *711 + '404': *709 + '403': *710 '304': *35 x-github: githubCloudOnly: true @@ -101553,19 +102139,19 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/scim/scim#update-a-provisioned-organization-membership parameters: - - *167 - - *702 + - *71 + - *704 responses: '200': description: Response content: application/scim+json: - schema: *706 + schema: *708 examples: - default: *709 + default: *711 '304': *35 - '404': *707 - '403': *708 + '404': *709 + '403': *710 requestBody: required: true content: @@ -101679,20 +102265,20 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/scim/scim#update-an-attribute-for-a-scim-user parameters: - - *167 - - *702 + - *71 + - *704 responses: '200': description: Response content: application/scim+json: - schema: *706 + schema: *708 examples: - default: *709 + default: *711 '304': *35 - '404': *707 - '403': *708 - '400': *686 + '404': *709 + '403': *710 + '400': *688 '429': description: Response content: @@ -101787,13 +102373,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/scim/scim#delete-a-scim-user-from-an-organization parameters: - - *167 - - *702 + - *71 + - *704 responses: '204': description: Response - '404': *707 - '403': *708 + '404': *709 + '403': *710 '304': *35 x-github: githubCloudOnly: true @@ -101908,7 +102494,7 @@ paths: html_url: type: string format: uri - repository: *193 + repository: *195 score: type: number file_size: @@ -101927,7 +102513,7 @@ paths: examples: - 73..77 - 77..78 - text_matches: &710 + text_matches: &712 title: Search Result Text Matches type: array items: @@ -102042,7 +102628,7 @@ paths: releases_url: http://api.github.com/repos/octocat/Hello-World/releases{/id} score: 1 '304': *35 - '503': *130 + '503': *133 '422': *15 '403': *27 x-github: @@ -102091,7 +102677,7 @@ paths: enum: - author-date - committer-date - - &711 + - &713 name: order description: Determines whether the first search result returned is the highest number of matches (`desc`) or lowest number of matches (`asc`). This parameter @@ -102160,7 +102746,7 @@ paths: committer: anyOf: - type: 'null' - - *425 + - *427 comment_count: type: integer message: @@ -102179,7 +102765,7 @@ paths: url: type: string format: uri - verification: *544 + verification: *546 required: - author - committer @@ -102194,7 +102780,7 @@ paths: committer: anyOf: - type: 'null' - - *425 + - *427 parents: type: array items: @@ -102206,12 +102792,12 @@ paths: type: string sha: type: string - repository: *193 + repository: *195 score: type: number node_id: type: string - text_matches: *710 + text_matches: *712 required: - sha - node_id @@ -102394,7 +102980,7 @@ paths: - interactions - created - updated - - *711 + - *713 - *17 - *19 - name: advanced_search @@ -102518,7 +103104,7 @@ paths: milestone: anyOf: - type: 'null' - - *490 + - *492 comments: type: integer created_at: @@ -102532,7 +103118,7 @@ paths: - string - 'null' format: date-time - text_matches: *710 + text_matches: *712 pull_request: type: object properties: @@ -102570,7 +103156,7 @@ paths: type: string score: type: number - author_association: *138 + author_association: *141 draft: type: boolean repository: *62 @@ -102581,12 +103167,12 @@ paths: timeline_url: type: string format: uri - type: *282 + type: *284 performed_via_github_app: anyOf: - type: 'null' - *5 - reactions: *139 + reactions: *142 required: - assignee - closed_at @@ -102702,7 +103288,7 @@ paths: locked: true author_association: COLLABORATOR state_reason: completed - '503': *130 + '503': *133 '422': *15 '304': *35 '403': *27 @@ -102758,7 +103344,7 @@ paths: enum: - created - updated - - *711 + - *713 - *17 - *19 responses: @@ -102803,7 +103389,7 @@ paths: - 'null' score: type: number - text_matches: *710 + text_matches: *712 required: - id - node_id @@ -102889,7 +103475,7 @@ paths: - forks - help-wanted-issues - updated - - *711 + - *713 - *17 - *19 responses: @@ -103108,7 +103694,7 @@ paths: license: anyOf: - type: 'null' - - *152 + - *155 permissions: type: object properties: @@ -103126,7 +103712,7 @@ paths: - admin - pull - push - text_matches: *710 + text_matches: *712 temp_clone_token: type: string allow_merge_commit: @@ -103329,7 +103915,7 @@ paths: spdx_id: MIT node_id: MDc6TGljZW5zZW1pdA== html_url: https://api.github.com/licenses/mit - '503': *130 + '503': *133 '422': *15 '304': *35 x-github: @@ -103435,7 +104021,7 @@ paths: - string - 'null' format: uri - text_matches: *710 + text_matches: *712 related: type: - array @@ -103630,7 +104216,7 @@ paths: - followers - repositories - joined - - *711 + - *713 - *17 - *19 responses: @@ -103740,7 +104326,7 @@ paths: type: - boolean - 'null' - text_matches: *710 + text_matches: *712 blog: type: - string @@ -103802,7 +104388,7 @@ paths: events_url: https://api.github.com/users/mojombo/events{/privacy} site_admin: true '304': *35 - '503': *130 + '503': *133 '422': *15 x-github: githubCloudOnly: false @@ -103822,7 +104408,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#get-a-team-legacy parameters: - - &712 + - &714 name: team_id description: The unique identifier of the team. in: path @@ -103834,9 +104420,9 @@ paths: description: Response content: application/json: - schema: *349 + schema: *351 examples: - default: *350 + default: *352 '404': *6 x-github: githubCloudOnly: false @@ -103863,7 +104449,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#update-a-team-legacy parameters: - - *712 + - *714 requestBody: required: true content: @@ -103927,16 +104513,16 @@ paths: description: Response when the updated information already exists content: application/json: - schema: *349 + schema: *351 examples: - default: *350 + default: *352 '201': description: Response content: application/json: - schema: *349 + schema: *351 examples: - default: *350 + default: *352 '404': *6 '422': *15 '403': *27 @@ -103964,7 +104550,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#delete-a-team-legacy parameters: - - *712 + - *714 responses: '204': description: Response @@ -103995,8 +104581,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussions#list-discussions-legacy parameters: - - *712 - - *86 + - *714 + - *89 - *17 - *19 responses: @@ -104006,9 +104592,9 @@ paths: application/json: schema: type: array - items: *351 + items: *353 examples: - default: *713 + default: *715 headers: Link: *38 x-github: @@ -104037,7 +104623,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussions#create-a-discussion-legacy parameters: - - *712 + - *714 requestBody: required: true content: @@ -104071,9 +104657,9 @@ paths: description: Response content: application/json: - schema: *351 + schema: *353 examples: - default: *352 + default: *354 x-github: triggersNotification: true githubCloudOnly: false @@ -104100,16 +104686,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussions#get-a-discussion-legacy parameters: - - *712 - - *353 + - *714 + - *355 responses: '200': description: Response content: application/json: - schema: *351 + schema: *353 examples: - default: *352 + default: *354 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -104134,8 +104720,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussions#update-a-discussion-legacy parameters: - - *712 - - *353 + - *714 + - *355 requestBody: required: false content: @@ -104158,9 +104744,9 @@ paths: description: Response content: application/json: - schema: *351 + schema: *353 examples: - default: *714 + default: *716 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -104185,8 +104771,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussions#delete-a-discussion-legacy parameters: - - *712 - - *353 + - *714 + - *355 responses: '204': description: Response @@ -104215,9 +104801,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussion-comments#list-discussion-comments-legacy parameters: - - *712 - - *353 - - *86 + - *714 + - *355 + - *89 - *17 - *19 responses: @@ -104227,9 +104813,9 @@ paths: application/json: schema: type: array - items: *354 + items: *356 examples: - default: *715 + default: *717 headers: Link: *38 x-github: @@ -104258,8 +104844,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussion-comments#create-a-discussion-comment-legacy parameters: - - *712 - - *353 + - *714 + - *355 requestBody: required: true content: @@ -104281,9 +104867,9 @@ paths: description: Response content: application/json: - schema: *354 + schema: *356 examples: - default: *355 + default: *357 x-github: triggersNotification: true githubCloudOnly: false @@ -104310,17 +104896,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussion-comments#get-a-discussion-comment-legacy parameters: - - *712 - - *353 - - *356 + - *714 + - *355 + - *358 responses: '200': description: Response content: application/json: - schema: *354 + schema: *356 examples: - default: *355 + default: *357 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -104345,9 +104931,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussion-comments#update-a-discussion-comment-legacy parameters: - - *712 - - *353 - - *356 + - *714 + - *355 + - *358 requestBody: required: true content: @@ -104369,9 +104955,9 @@ paths: description: Response content: application/json: - schema: *354 + schema: *356 examples: - default: *716 + default: *718 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -104396,9 +104982,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussion-comments#delete-a-discussion-comment-legacy parameters: - - *712 - - *353 - - *356 + - *714 + - *355 + - *358 responses: '204': description: Response @@ -104427,9 +105013,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#list-reactions-for-a-team-discussion-comment-legacy parameters: - - *712 - - *353 - - *356 + - *714 + - *355 + - *358 - name: content description: Returns a single [reaction type](https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to a team discussion comment. @@ -104455,9 +105041,9 @@ paths: application/json: schema: type: array - items: *357 + items: *359 examples: - default: *359 + default: *361 headers: Link: *38 x-github: @@ -104486,9 +105072,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#create-reaction-for-a-team-discussion-comment-legacy parameters: - - *712 - - *353 - - *356 + - *714 + - *355 + - *358 requestBody: required: true content: @@ -104520,9 +105106,9 @@ paths: description: Response content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -104548,8 +105134,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#list-reactions-for-a-team-discussion-legacy parameters: - - *712 - - *353 + - *714 + - *355 - name: content description: Returns a single [reaction type](https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to a team discussion. @@ -104575,9 +105161,9 @@ paths: application/json: schema: type: array - items: *357 + items: *359 examples: - default: *359 + default: *361 headers: Link: *38 x-github: @@ -104606,8 +105192,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#create-reaction-for-a-team-discussion-legacy parameters: - - *712 - - *353 + - *714 + - *355 requestBody: required: true content: @@ -104639,9 +105225,9 @@ paths: description: Response content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -104665,7 +105251,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#list-pending-team-invitations-legacy parameters: - - *712 + - *714 - *17 - *19 responses: @@ -104675,9 +105261,9 @@ paths: application/json: schema: type: array - items: *279 + items: *281 examples: - default: *280 + default: *282 headers: Link: *38 x-github: @@ -104703,7 +105289,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#list-team-members-legacy parameters: - - *712 + - *714 - name: role description: Filters members returned by their role in the team. in: query @@ -104726,7 +105312,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: *38 '404': *6 @@ -104754,8 +105340,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#get-team-member-legacy parameters: - - *712 - - *215 + - *714 + - *217 responses: '204': description: if user is a member @@ -104791,8 +105377,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#add-team-member-legacy parameters: - - *712 - - *215 + - *714 + - *217 responses: '204': description: Response @@ -104831,8 +105417,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#remove-team-member-legacy parameters: - - *712 - - *215 + - *714 + - *217 responses: '204': description: Response @@ -104868,16 +105454,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#get-team-membership-for-a-user-legacy parameters: - - *712 - - *215 + - *714 + - *217 responses: '200': description: Response content: application/json: - schema: *365 + schema: *367 examples: - response-if-user-is-a-team-maintainer: *717 + response-if-user-is-a-team-maintainer: *719 '404': *6 x-github: githubCloudOnly: false @@ -104910,8 +105496,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#add-or-update-team-membership-for-a-user-legacy parameters: - - *712 - - *215 + - *714 + - *217 requestBody: required: false content: @@ -104936,9 +105522,9 @@ paths: description: Response content: application/json: - schema: *365 + schema: *367 examples: - response-if-users-membership-with-team-is-now-pending: *718 + response-if-users-membership-with-team-is-now-pending: *720 '403': description: Forbidden if team synchronization is set up '422': @@ -104972,8 +105558,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#remove-team-membership-for-a-user-legacy parameters: - - *712 - - *215 + - *714 + - *217 responses: '204': description: Response @@ -105001,7 +105587,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#list-team-projects-legacy parameters: - - *712 + - *714 - *17 - *19 responses: @@ -105011,9 +105597,9 @@ paths: application/json: schema: type: array - items: *366 + items: *368 examples: - default: *719 + default: *721 headers: Link: *38 '404': *6 @@ -105039,16 +105625,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#check-team-permissions-for-a-project-legacy parameters: - - *712 - - *367 + - *714 + - *369 responses: '200': description: Response content: application/json: - schema: *366 + schema: *368 examples: - default: *720 + default: *722 '404': description: Not Found if project is not managed by this team x-github: @@ -105072,8 +105658,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#add-or-update-team-project-permissions-legacy parameters: - - *712 - - *367 + - *714 + - *369 requestBody: required: false content: @@ -105140,8 +105726,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#remove-a-project-from-a-team-legacy parameters: - - *712 - - *367 + - *714 + - *369 responses: '204': description: Response @@ -105168,7 +105754,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#list-team-repositories-legacy parameters: - - *712 + - *714 - *17 - *19 responses: @@ -105178,9 +105764,9 @@ paths: application/json: schema: type: array - items: *193 + items: *195 examples: - default: *305 + default: *307 headers: Link: *38 '404': *6 @@ -105210,15 +105796,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#check-team-permissions-for-a-repository-legacy parameters: - - *712 - - *368 - - *369 + - *714 + - *370 + - *371 responses: '200': description: Alternative response with extra repository information content: application/json: - schema: *721 + schema: *723 examples: alternative-response-with-extra-repository-information: value: @@ -105369,9 +105955,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#add-or-update-team-repository-permissions-legacy parameters: - - *712 - - *368 - - *369 + - *714 + - *370 + - *371 requestBody: required: false content: @@ -105421,9 +106007,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#remove-a-repository-from-a-team-legacy parameters: - - *712 - - *368 - - *369 + - *714 + - *370 + - *371 responses: '204': description: Response @@ -105452,15 +106038,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/team-sync#list-idp-groups-for-a-team-legacy parameters: - - *712 + - *714 responses: '200': description: Response content: application/json: - schema: *370 + schema: *372 examples: - default: *371 + default: *373 '403': *27 '404': *6 x-github: @@ -105487,7 +106073,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/team-sync#create-or-update-idp-group-connections-legacy parameters: - - *712 + - *714 requestBody: required: true content: @@ -105548,7 +106134,7 @@ paths: description: Response content: application/json: - schema: *370 + schema: *372 examples: default: value: @@ -105579,7 +106165,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#list-child-teams-legacy parameters: - - *712 + - *714 - *17 - *19 responses: @@ -105589,9 +106175,9 @@ paths: application/json: schema: type: array - items: *224 + items: *226 examples: - response-if-child-teams-exist: *722 + response-if-child-teams-exist: *724 headers: Link: *38 '404': *6 @@ -105624,7 +106210,7 @@ paths: application/json: schema: oneOf: - - &724 + - &726 title: Private User description: Private User type: object @@ -105874,7 +106460,7 @@ paths: - private_gists - total_private_repos - two_factor_authentication - - *723 + - *725 examples: response-with-public-and-private-profile-information: summary: Response with public and private profile information @@ -106034,7 +106620,7 @@ paths: description: Response content: application/json: - schema: *724 + schema: *726 examples: default: value: @@ -106113,7 +106699,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 '304': *35 '404': *6 '403': *27 @@ -106136,7 +106722,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/blocking#check-if-a-user-is-blocked-by-the-authenticated-user parameters: - - *215 + - *217 responses: '204': description: If the user is blocked @@ -106164,7 +106750,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/blocking#block-a-user parameters: - - *215 + - *217 responses: '204': description: Response @@ -106188,7 +106774,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/blocking#unblock-a-user parameters: - - *215 + - *217 responses: '204': description: Response @@ -106237,11 +106823,11 @@ paths: type: integer codespaces: type: array - items: *288 + items: *290 examples: - default: *289 + default: *291 '304': *35 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -106378,21 +106964,21 @@ paths: description: Response when the codespace was successfully created content: application/json: - schema: *288 + schema: *290 examples: - default: *477 + default: *479 '202': description: Response when the codespace creation partially failed but is being retried in the background content: application/json: - schema: *288 + schema: *290 examples: - default: *477 + default: *479 '401': *23 '403': *27 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -106432,7 +107018,7 @@ paths: type: integer secrets: type: array - items: &725 + items: &727 title: Codespaces Secret description: Secrets for a GitHub Codespace. type: object @@ -106474,7 +107060,7 @@ paths: - visibility - selected_repositories_url examples: - default: *479 + default: *481 headers: Link: *38 x-github: @@ -106546,13 +107132,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/secrets#get-a-secret-for-the-authenticated-user parameters: - - *203 + - *205 responses: '200': description: Response content: application/json: - schema: *725 + schema: *727 examples: default: value: @@ -106582,7 +107168,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/secrets#create-or-update-a-secret-for-the-authenticated-user parameters: - - *203 + - *205 requestBody: required: true content: @@ -106627,7 +107213,7 @@ paths: description: Response after successfully creating a secret content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -106655,7 +107241,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/secrets#delete-a-secret-for-the-authenticated-user parameters: - - *203 + - *205 responses: '204': description: Response @@ -106680,7 +107266,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/secrets#list-selected-repositories-for-a-user-secret parameters: - - *203 + - *205 responses: '200': description: Response @@ -106696,13 +107282,13 @@ paths: type: integer repositories: type: array - items: *193 + items: *195 examples: - default: *726 + default: *728 '401': *23 '403': *27 '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -106723,7 +107309,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/secrets#set-selected-repositories-for-a-user-secret parameters: - - *203 + - *205 requestBody: required: true content: @@ -106755,7 +107341,7 @@ paths: '401': *23 '403': *27 '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -106777,7 +107363,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/secrets#add-a-selected-repository-to-a-user-secret parameters: - - *203 + - *205 - name: repository_id in: path required: true @@ -106789,7 +107375,7 @@ paths: '401': *23 '403': *27 '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -106810,7 +107396,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/secrets#remove-a-selected-repository-from-a-user-secret parameters: - - *203 + - *205 - name: repository_id in: path required: true @@ -106822,7 +107408,7 @@ paths: '401': *23 '403': *27 '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -106842,17 +107428,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#get-a-codespace-for-the-authenticated-user parameters: - - *290 + - *292 responses: '200': description: Response content: application/json: - schema: *288 + schema: *290 examples: - default: *477 + default: *479 '304': *35 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -106876,7 +107462,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#update-a-codespace-for-the-authenticated-user parameters: - - *290 + - *292 requestBody: required: false content: @@ -106906,9 +107492,9 @@ paths: description: Response content: application/json: - schema: *288 + schema: *290 examples: - default: *477 + default: *479 '401': *23 '403': *27 '404': *6 @@ -106930,11 +107516,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#delete-a-codespace-for-the-authenticated-user parameters: - - *290 + - *292 responses: '202': *37 '304': *35 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -106959,13 +107545,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#export-a-codespace-for-the-authenticated-user parameters: - - *290 + - *292 responses: '202': description: Response content: application/json: - schema: &727 + schema: &729 type: object title: Fetches information about an export of a codespace. description: An export of a codespace. Also, latest export details @@ -107018,7 +107604,7 @@ paths: examples: - https://github.com/octocat/hello-world/tree/:branch examples: - default: &728 + default: &730 value: state: succeeded completed_at: '2022-01-01T14:59:22Z' @@ -107026,7 +107612,7 @@ paths: sha: fd95a81ca01e48ede9f39c799ecbcef817b8a3b2 id: latest export_url: https://api.github.com/user/codespaces/:name/exports/latest - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -107050,7 +107636,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#get-details-about-a-codespace-export parameters: - - *290 + - *292 - name: export_id in: path required: true @@ -107063,9 +107649,9 @@ paths: description: Response content: application/json: - schema: *727 + schema: *729 examples: - default: *728 + default: *730 '404': *6 x-github: githubCloudOnly: false @@ -107086,7 +107672,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/machines#list-machine-types-for-a-codespace parameters: - - *290 + - *292 responses: '200': description: Response @@ -107102,11 +107688,11 @@ paths: type: integer machines: type: array - items: *478 + items: *480 examples: - default: *729 + default: *731 '304': *35 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -107133,7 +107719,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#create-a-repository-from-an-unpublished-codespace parameters: - - *290 + - *292 requestBody: required: true content: @@ -107189,11 +107775,11 @@ paths: - 26a7c758-7299-4a73-b978-5a92a7ae98a0 owner: *4 billable_owner: *4 - repository: *381 + repository: *383 machine: anyOf: - type: 'null' - - *478 + - *480 devcontainer_path: description: Path to devcontainer.json from repo root used to create Codespace. @@ -107990,17 +108576,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#start-a-codespace-for-the-authenticated-user parameters: - - *290 + - *292 responses: '200': description: Response content: application/json: - schema: *288 + schema: *290 examples: - default: *477 + default: *479 '304': *35 - '500': *83 + '500': *86 '400': *14 '401': *23 '402': @@ -108010,7 +108596,7 @@ paths: schema: *3 '403': *27 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -108030,16 +108616,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#stop-a-codespace-for-the-authenticated-user parameters: - - *290 + - *292 responses: '200': description: Response content: application/json: - schema: *288 + schema: *290 examples: - default: *477 - '500': *83 + default: *479 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -108068,9 +108654,9 @@ paths: application/json: schema: type: array - items: *299 + items: *301 examples: - default: &742 + default: &744 value: - id: 197 name: hello_docker @@ -108171,7 +108757,7 @@ paths: application/json: schema: type: array - items: &730 + items: &732 title: Email description: Email type: object @@ -108241,9 +108827,9 @@ paths: application/json: schema: type: array - items: *730 + items: *732 examples: - default: &744 + default: &746 value: - email: octocat@github.com verified: true @@ -108320,7 +108906,7 @@ paths: application/json: schema: type: array - items: *730 + items: *732 examples: default: value: @@ -108432,7 +109018,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: *38 '304': *35 @@ -108465,7 +109051,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: *38 '304': *35 @@ -108487,7 +109073,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/followers#check-if-a-person-is-followed-by-the-authenticated-user parameters: - - *215 + - *217 responses: '204': description: if the person is followed by the authenticated user @@ -108517,7 +109103,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/followers#follow-a-user parameters: - - *215 + - *217 responses: '204': description: Response @@ -108542,7 +109128,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/followers#unfollow-a-user parameters: - - *215 + - *217 responses: '204': description: Response @@ -108578,7 +109164,7 @@ paths: application/json: schema: type: array - items: &731 + items: &733 title: GPG Key description: A unique encryption key type: object @@ -108723,7 +109309,7 @@ paths: - subkeys - revoked examples: - default: &758 + default: &760 value: - id: 3 name: Octocat's GPG Key @@ -108808,9 +109394,9 @@ paths: description: Response content: application/json: - schema: *731 + schema: *733 examples: - default: &732 + default: &734 value: id: 3 name: Octocat's GPG Key @@ -108867,7 +109453,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/gpg-keys#get-a-gpg-key-for-the-authenticated-user parameters: - - &733 + - &735 name: gpg_key_id description: The unique identifier of the GPG key. in: path @@ -108879,9 +109465,9 @@ paths: description: Response content: application/json: - schema: *731 + schema: *733 examples: - default: *732 + default: *734 '404': *6 '304': *35 '403': *27 @@ -108904,7 +109490,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/gpg-keys#delete-a-gpg-key-for-the-authenticated-user parameters: - - *733 + - *735 responses: '204': description: Response @@ -109095,7 +109681,7 @@ paths: type: array items: *62 examples: - default: *734 + default: *736 headers: Link: *38 '404': *6 @@ -109120,7 +109706,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/apps/installations#add-a-repository-to-an-app-installation parameters: - *21 - - *188 + - *190 responses: '204': description: Response @@ -109146,7 +109732,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/apps/installations#remove-a-repository-from-an-app-installation parameters: - *21 - - *188 + - *190 responses: '204': description: Response @@ -109180,12 +109766,12 @@ paths: application/json: schema: anyOf: - - *277 + - *279 - type: object properties: {} additionalProperties: false examples: - default: *278 + default: *280 '204': description: Response when there are no restrictions x-github: @@ -109209,7 +109795,7 @@ paths: required: true content: application/json: - schema: *555 + schema: *557 examples: default: value: @@ -109220,7 +109806,7 @@ paths: description: Response content: application/json: - schema: *277 + schema: *279 examples: default: value: @@ -109301,7 +109887,7 @@ paths: - closed - all default: open - - *285 + - *287 - name: sort description: What to sort results by. in: query @@ -109313,8 +109899,8 @@ paths: - updated - comments default: created - - *86 - - *141 + - *89 + - *144 - *17 - *19 responses: @@ -109324,9 +109910,9 @@ paths: application/json: schema: type: array - items: *151 + items: *154 examples: - default: *286 + default: *288 headers: Link: *38 '404': *6 @@ -109359,7 +109945,7 @@ paths: application/json: schema: type: array - items: &735 + items: &737 title: Key description: Key type: object @@ -109457,9 +110043,9 @@ paths: description: Response content: application/json: - schema: *735 + schema: *737 examples: - default: &736 + default: &738 value: key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 id: 2 @@ -109492,15 +110078,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/keys#get-a-public-ssh-key-for-the-authenticated-user parameters: - - *582 + - *584 responses: '200': description: Response content: application/json: - schema: *735 + schema: *737 examples: - default: *736 + default: *738 '404': *6 '304': *35 '403': *27 @@ -109523,7 +110109,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/keys#delete-a-public-ssh-key-for-the-authenticated-user parameters: - - *582 + - *584 responses: '204': description: Response @@ -109556,7 +110142,7 @@ paths: application/json: schema: type: array - items: &737 + items: &739 title: User Marketplace Purchase description: User Marketplace Purchase type: object @@ -109624,7 +110210,7 @@ paths: - id - type - login - plan: *154 + plan: *157 required: - billing_cycle - next_billing_date @@ -109635,7 +110221,7 @@ paths: - account - plan examples: - default: &738 + default: &740 value: - billing_cycle: monthly next_billing_date: '2017-11-11T00:00:00Z' @@ -109697,9 +110283,9 @@ paths: application/json: schema: type: array - items: *737 + items: *739 examples: - default: *738 + default: *740 headers: Link: *38 '304': *35 @@ -109739,7 +110325,7 @@ paths: application/json: schema: type: array - items: *291 + items: *293 examples: default: value: @@ -109841,13 +110427,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#get-an-organization-membership-for-the-authenticated-user parameters: - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: *291 + schema: *293 examples: default: value: @@ -109905,7 +110491,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#update-an-organization-membership-for-the-authenticated-user parameters: - - *167 + - *71 requestBody: required: true content: @@ -109930,7 +110516,7 @@ paths: description: Response content: application/json: - schema: *291 + schema: *293 examples: default: value: @@ -109998,7 +110584,7 @@ paths: application/json: schema: type: array - items: *293 + items: *295 examples: default: value: @@ -110260,7 +110846,7 @@ paths: description: Response content: application/json: - schema: *293 + schema: *295 examples: default: value: @@ -110440,7 +111026,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/users#get-a-user-migration-status parameters: - - *294 + - *296 - name: exclude in: query required: false @@ -110453,7 +111039,7 @@ paths: description: Response content: application/json: - schema: *293 + schema: *295 examples: default: value: @@ -110647,7 +111233,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/users#download-a-user-migration-archive parameters: - - *294 + - *296 responses: '302': description: Response @@ -110673,7 +111259,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/users#delete-a-user-migration-archive parameters: - - *294 + - *296 responses: '204': description: Response @@ -110702,8 +111288,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/users#unlock-a-user-repository parameters: - - *294 - - *739 + - *296 + - *741 responses: '204': description: Response @@ -110727,7 +111313,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/users#list-repositories-for-a-user-migration parameters: - - *294 + - *296 - *17 - *19 responses: @@ -110737,9 +111323,9 @@ paths: application/json: schema: type: array - items: *193 + items: *195 examples: - default: *305 + default: *307 headers: Link: *38 '404': *6 @@ -110776,7 +111362,7 @@ paths: type: array items: *57 examples: - default: *740 + default: *742 headers: Link: *38 '304': *35 @@ -110818,7 +111404,7 @@ paths: - docker - nuget - container - - *741 + - *743 - *19 - *17 responses: @@ -110828,10 +111414,10 @@ paths: application/json: schema: type: array - items: *299 + items: *301 examples: - default: *742 - '400': *743 + default: *744 + '400': *745 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -110851,16 +111437,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#get-a-package-for-the-authenticated-user parameters: - - *301 - - *302 + - *303 + - *304 responses: '200': description: Response content: application/json: - schema: *299 + schema: *301 examples: - default: &759 + default: &761 value: id: 40201 name: octo-name @@ -110973,8 +111559,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#delete-a-package-for-the-authenticated-user parameters: - - *301 - - *302 + - *303 + - *304 responses: '204': description: Response @@ -111004,8 +111590,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#restore-a-package-for-the-authenticated-user parameters: - - *301 - - *302 + - *303 + - *304 - name: token description: package token schema: @@ -111037,8 +111623,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#list-package-versions-for-a-package-owned-by-the-authenticated-user parameters: - - *301 - - *302 + - *303 + - *304 - *19 - *17 - name: state @@ -111058,7 +111644,7 @@ paths: application/json: schema: type: array - items: *303 + items: *305 examples: default: value: @@ -111107,15 +111693,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#get-a-package-version-for-the-authenticated-user parameters: - - *301 - - *302 + - *303 - *304 + - *306 responses: '200': description: Response content: application/json: - schema: *303 + schema: *305 examples: default: value: @@ -111151,9 +111737,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#delete-a-package-version-for-the-authenticated-user parameters: - - *301 - - *302 + - *303 - *304 + - *306 responses: '204': description: Response @@ -111183,9 +111769,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#restore-a-package-version-for-the-authenticated-user parameters: - - *301 - - *302 + - *303 - *304 + - *306 responses: '204': description: Response @@ -111243,7 +111829,7 @@ paths: description: Response content: application/json: - schema: *315 + schema: *317 examples: default: value: @@ -111315,9 +111901,9 @@ paths: application/json: schema: type: array - items: *730 + items: *732 examples: - default: *744 + default: *746 headers: Link: *38 '304': *35 @@ -111430,7 +112016,7 @@ paths: type: array items: *62 examples: - default: &751 + default: &753 summary: Default response value: - id: 1296269 @@ -111748,9 +112334,9 @@ paths: description: Response content: application/json: - schema: *381 + schema: *383 examples: - default: *383 + default: *385 headers: Location: example: https://api.github.com/repos/octocat/Hello-World @@ -111788,9 +112374,9 @@ paths: application/json: schema: type: array - items: *557 + items: *559 examples: - default: *745 + default: *747 headers: Link: *38 '304': *35 @@ -111813,12 +112399,12 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/invitations#accept-a-repository-invitation parameters: - - *281 + - *283 responses: '204': description: Response '403': *27 - '409': *94 + '409': *97 '404': *6 '304': *35 x-github: @@ -111836,11 +112422,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/invitations#decline-a-repository-invitation parameters: - - *281 + - *283 responses: '204': description: Response - '409': *94 + '409': *97 '304': *35 '404': *6 '403': *27 @@ -111869,7 +112455,7 @@ paths: application/json: schema: type: array - items: &746 + items: &748 title: Social account description: Social media account type: object @@ -111886,7 +112472,7 @@ paths: - provider - url examples: - default: &747 + default: &749 value: - provider: twitter url: https://twitter.com/github @@ -111949,9 +112535,9 @@ paths: application/json: schema: type: array - items: *746 + items: *748 examples: - default: *747 + default: *749 '422': *15 '304': *35 '404': *6 @@ -112039,7 +112625,7 @@ paths: application/json: schema: type: array - items: &748 + items: &750 title: SSH Signing Key description: A public SSH key used to sign Git commits type: object @@ -112059,7 +112645,7 @@ paths: - title - created_at examples: - default: &760 + default: &762 value: - key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 id: 2 @@ -112126,9 +112712,9 @@ paths: description: Response content: application/json: - schema: *748 + schema: *750 examples: - default: &749 + default: &751 value: key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 id: 2 @@ -112159,7 +112745,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/ssh-signing-keys#get-an-ssh-signing-key-for-the-authenticated-user parameters: - - &750 + - &752 name: ssh_signing_key_id description: The unique identifier of the SSH signing key. in: path @@ -112171,9 +112757,9 @@ paths: description: Response content: application/json: - schema: *748 + schema: *750 examples: - default: *749 + default: *751 '404': *6 '304': *35 '403': *27 @@ -112196,7 +112782,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/ssh-signing-keys#delete-an-ssh-signing-key-for-the-authenticated-user parameters: - - *750 + - *752 responses: '204': description: Response @@ -112225,7 +112811,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/starring#list-repositories-starred-by-the-authenticated-user parameters: - - &761 + - &763 name: sort description: The property to sort the results by. `created` means when the repository was starred. `updated` means when the repository was last pushed @@ -112238,7 +112824,7 @@ paths: - created - updated default: created - - *86 + - *89 - *17 - *19 responses: @@ -112250,11 +112836,11 @@ paths: type: array items: *62 examples: - default-response: *751 + default-response: *753 application/vnd.github.v3.star+json: schema: type: array - items: &762 + items: &764 title: Starred Repository description: Starred Repository type: object @@ -112410,8 +112996,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/starring#check-if-a-repository-is-starred-by-the-authenticated-user parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response if this repository is starred by you @@ -112439,8 +113025,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/starring#star-a-repository-for-the-authenticated-user parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response @@ -112464,8 +113050,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/starring#unstar-a-repository-for-the-authenticated-user parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response @@ -112498,9 +113084,9 @@ paths: application/json: schema: type: array - items: *193 + items: *195 examples: - default: *305 + default: *307 headers: Link: *38 '304': *35 @@ -112537,7 +113123,7 @@ paths: application/json: schema: type: array - items: *349 + items: *351 examples: default: value: @@ -112615,7 +113201,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/users#get-a-user-using-their-id parameters: - - *156 + - *159 responses: '200': description: Response @@ -112623,10 +113209,10 @@ paths: application/json: schema: oneOf: - - *724 - - *723 + - *726 + - *725 examples: - default-response: &753 + default-response: &755 summary: Default response value: login: octocat @@ -112661,7 +113247,7 @@ paths: following: 0 created_at: '2008-01-14T04:33:35Z' updated_at: '2008-01-14T04:33:35Z' - response-with-git-hub-plan-information: &754 + response-with-git-hub-plan-information: &756 summary: Response with GitHub plan information value: login: octocat @@ -112721,7 +113307,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/users#list-users parameters: - - *752 + - *754 - *17 responses: '200': @@ -112732,7 +113318,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: example: ; rel="next" @@ -112762,7 +113348,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/users#get-a-user parameters: - - *215 + - *217 responses: '200': description: Response @@ -112770,11 +113356,11 @@ paths: application/json: schema: oneOf: - - *724 - - *723 + - *726 + - *725 examples: - default-response: *753 - response-with-git-hub-plan-information: *754 + default-response: *755 + response-with-git-hub-plan-information: *756 '404': *6 x-github: githubCloudOnly: false @@ -112798,9 +113384,9 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/users/attestations#list-attestations-by-bulk-subject-digests parameters: - *17 - - *84 - - *85 - - *215 + - *87 + - *88 + - *217 requestBody: required: true content: @@ -112823,8 +113409,8 @@ paths: required: - subject_digests examples: - default: *755 - withPredicateType: *756 + default: *757 + withPredicateType: *758 responses: '200': description: Response @@ -112878,7 +113464,7 @@ paths: description: The cursor to the previous page. description: Information about the current page. examples: - default: *757 + default: *759 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -112896,7 +113482,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/attestations#delete-attestations-in-bulk parameters: - - *215 + - *217 requestBody: required: true content: @@ -112961,7 +113547,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/attestations#delete-attestations-by-subject-digest parameters: - - *215 + - *217 - name: subject_digest description: Subject Digest in: path @@ -112992,7 +113578,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/attestations#delete-attestations-by-id parameters: - - *215 + - *217 - name: attestation_id description: Attestation ID in: path @@ -113028,9 +113614,9 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/users/attestations#list-attestations parameters: - *17 - - *84 - - *85 - - *215 + - *87 + - *88 + - *217 - name: subject_digest description: Subject Digest in: path @@ -113080,12 +113666,12 @@ paths: bundle_url: type: string examples: - default: *421 + default: *423 '201': description: Response content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -113111,7 +113697,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#get-list-of-conflicting-packages-during-docker-migration-for-user parameters: - - *215 + - *217 responses: '200': description: Response @@ -113119,9 +113705,9 @@ paths: application/json: schema: type: array - items: *299 + items: *301 examples: - default: *742 + default: *744 '403': *27 '401': *23 x-github: @@ -113144,7 +113730,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/events#list-events-for-the-authenticated-user parameters: - - *215 + - *217 - *17 - *19 responses: @@ -113154,7 +113740,7 @@ paths: application/json: schema: type: array - items: *162 + items: *165 examples: default: value: @@ -113225,8 +113811,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/events#list-organization-events-for-the-authenticated-user parameters: - - *215 - - *167 + - *217 + - *71 - *17 - *19 responses: @@ -113236,7 +113822,7 @@ paths: application/json: schema: type: array - items: *162 + items: *165 examples: default: value: @@ -113315,7 +113901,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/events#list-public-events-for-a-user parameters: - - *215 + - *217 - *17 - *19 responses: @@ -113325,7 +113911,7 @@ paths: application/json: schema: type: array - items: *162 + items: *165 examples: default: value: @@ -113392,7 +113978,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/followers#list-followers-of-a-user parameters: - - *215 + - *217 - *17 - *19 responses: @@ -113404,7 +113990,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: *38 x-github: @@ -113423,7 +114009,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/followers#list-the-people-a-user-follows parameters: - - *215 + - *217 - *17 - *19 responses: @@ -113435,7 +114021,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: *38 x-github: @@ -113454,7 +114040,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/followers#check-if-a-user-follows-another-user parameters: - - *215 + - *217 - name: target_user in: path required: true @@ -113481,8 +114067,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#list-gists-for-a-user parameters: - - *215 - - *141 + - *217 + - *144 - *17 - *19 responses: @@ -113492,9 +114078,9 @@ paths: application/json: schema: type: array - items: *142 + items: *145 examples: - default: *143 + default: *146 headers: Link: *38 '422': *15 @@ -113515,7 +114101,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/gpg-keys#list-gpg-keys-for-a-user parameters: - - *215 + - *217 - *17 - *19 responses: @@ -113525,9 +114111,9 @@ paths: application/json: schema: type: array - items: *731 + items: *733 examples: - default: *758 + default: *760 headers: Link: *38 x-github: @@ -113551,7 +114137,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/users#get-contextual-information-for-a-user parameters: - - *215 + - *217 - name: subject_type description: Identifies which additional information you'd like to receive about the person's hovercard. Can be `organization`, `repository`, `issue`, @@ -113623,7 +114209,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#get-a-user-installation-for-the-authenticated-app parameters: - - *215 + - *217 responses: '200': description: Response @@ -113631,7 +114217,7 @@ paths: application/json: schema: *20 examples: - default: *554 + default: *556 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -113649,7 +114235,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/keys#list-public-keys-for-a-user parameters: - - *215 + - *217 - *17 - *19 responses: @@ -113700,7 +114286,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/orgs#list-organizations-for-a-user parameters: - - *215 + - *217 - *17 - *19 responses: @@ -113712,7 +114298,7 @@ paths: type: array items: *57 examples: - default: *740 + default: *742 headers: Link: *38 x-github: @@ -113751,8 +114337,8 @@ paths: - docker - nuget - container - - *741 - - *215 + - *743 + - *217 - *19 - *17 responses: @@ -113762,12 +114348,12 @@ paths: application/json: schema: type: array - items: *299 + items: *301 examples: - default: *742 + default: *744 '403': *27 '401': *23 - '400': *743 + '400': *745 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -113787,17 +114373,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#get-a-package-for-a-user parameters: - - *301 - - *302 - - *215 + - *303 + - *304 + - *217 responses: '200': description: Response content: application/json: - schema: *299 + schema: *301 examples: - default: *759 + default: *761 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -113818,9 +114404,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#delete-a-package-for-a-user parameters: - - *301 - - *302 - - *215 + - *303 + - *304 + - *217 responses: '204': description: Response @@ -113852,9 +114438,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#restore-a-package-for-a-user parameters: - - *301 - - *302 - - *215 + - *303 + - *304 + - *217 - name: token description: package token schema: @@ -113886,9 +114472,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#list-package-versions-for-a-package-owned-by-a-user parameters: - - *301 - - *302 - - *215 + - *303 + - *304 + - *217 responses: '200': description: Response @@ -113896,7 +114482,7 @@ paths: application/json: schema: type: array - items: *303 + items: *305 examples: default: value: @@ -113954,16 +114540,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#get-a-package-version-for-a-user parameters: - - *301 - - *302 + - *303 - *304 - - *215 + - *306 + - *217 responses: '200': description: Response content: application/json: - schema: *303 + schema: *305 examples: default: value: @@ -113998,10 +114584,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#delete-package-version-for-a-user parameters: - - *301 - - *302 - - *215 + - *303 - *304 + - *217 + - *306 responses: '204': description: Response @@ -114033,10 +114619,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#restore-package-version-for-a-user parameters: - - *301 - - *302 - - *215 + - *303 - *304 + - *217 + - *306 responses: '204': description: Response @@ -114062,7 +114648,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/projects#list-user-projects parameters: - - *215 + - *217 - name: state description: Indicates the state of the projects to return. in: query @@ -114083,7 +114669,7 @@ paths: application/json: schema: type: array - items: *315 + items: *317 examples: default: value: @@ -114145,7 +114731,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/events#list-events-received-by-the-authenticated-user parameters: - - *215 + - *217 - *17 - *19 responses: @@ -114155,7 +114741,7 @@ paths: application/json: schema: type: array - items: *162 + items: *165 examples: default: value: @@ -114234,7 +114820,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/events#list-public-events-received-by-a-user parameters: - - *215 + - *217 - *17 - *19 responses: @@ -114244,7 +114830,7 @@ paths: application/json: schema: type: array - items: *162 + items: *165 examples: default: value: @@ -114321,7 +114907,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#list-repositories-for-a-user parameters: - - *215 + - *217 - name: type description: Limit results to repositories of the specified type. in: query @@ -114364,9 +114950,9 @@ paths: application/json: schema: type: array - items: *193 + items: *195 examples: - default: *305 + default: *307 headers: Link: *38 x-github: @@ -114390,15 +114976,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/billing/billing#get-github-actions-billing-for-a-user parameters: - - *215 + - *217 responses: '200': description: Response content: application/json: - schema: *336 + schema: *338 examples: - default: *337 + default: *339 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -114420,15 +115006,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/billing/billing#get-github-packages-billing-for-a-user parameters: - - *215 + - *217 responses: '200': description: Response content: application/json: - schema: *341 + schema: *343 examples: - default: *342 + default: *344 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -114450,15 +115036,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/billing/billing#get-shared-storage-billing-for-a-user parameters: - - *215 + - *217 responses: '200': description: Response content: application/json: - schema: *343 + schema: *345 examples: - default: *344 + default: *346 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -114478,11 +115064,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/billing/enhanced-billing#get-billing-usage-report-for-a-user parameters: - - *215 - - *168 - - *169 + - *217 - *170 - *171 + - *172 + - *173 responses: '200': description: Response when getting a billing usage report @@ -114552,8 +115138,8 @@ paths: repositoryName: user/example '400': *14 '403': *27 - '500': *83 - '503': *130 + '500': *86 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -114571,7 +115157,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/social-accounts#list-social-accounts-for-a-user parameters: - - *215 + - *217 - *17 - *19 responses: @@ -114581,9 +115167,9 @@ paths: application/json: schema: type: array - items: *746 + items: *748 examples: - default: *747 + default: *749 headers: Link: *38 x-github: @@ -114603,7 +115189,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/ssh-signing-keys#list-ssh-signing-keys-for-a-user parameters: - - *215 + - *217 - *17 - *19 responses: @@ -114613,9 +115199,9 @@ paths: application/json: schema: type: array - items: *748 + items: *750 examples: - default: *760 + default: *762 headers: Link: *38 x-github: @@ -114639,9 +115225,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/starring#list-repositories-starred-by-a-user parameters: - - *215 - - *761 - - *86 + - *217 + - *763 + - *89 - *17 - *19 responses: @@ -114652,11 +115238,11 @@ paths: schema: anyOf: - type: array - items: *762 + items: *764 - type: array items: *62 examples: - default-response: *751 + default-response: *753 headers: Link: *38 x-github: @@ -114675,7 +115261,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/watching#list-repositories-watched-by-a-user parameters: - - *215 + - *217 - *17 - *19 responses: @@ -114685,9 +115271,9 @@ paths: application/json: schema: type: array - items: *193 + items: *195 examples: - default: *305 + default: *307 headers: Link: *38 x-github: @@ -114816,7 +115402,7 @@ webhooks: type: string enum: - disabled - enterprise: &763 + enterprise: &765 title: Enterprise description: |- An enterprise on GitHub. Webhook payloads contain the `enterprise` property when the webhook is configured @@ -114885,7 +115471,7 @@ webhooks: - created_at - updated_at - avatar_url - installation: &764 + installation: &766 title: Simple Installation description: |- The GitHub App installation. Webhook payloads contain the `installation` property when the event is configured @@ -114906,7 +115492,7 @@ webhooks: required: - id - node_id - organization: &765 + organization: &767 title: Organization Simple description: |- A GitHub organization. Webhook payloads contain the `organization` property when the webhook is configured for an @@ -114979,7 +115565,7 @@ webhooks: - public_members_url - avatar_url - description - repository: &766 + repository: &768 title: Repository description: |- The repository on GitHub where the event occurred. Webhook payloads contain the `repository` property @@ -115008,7 +115594,7 @@ webhooks: license: anyOf: - type: 'null' - - *152 + - *155 organization: anyOf: - type: 'null' @@ -115892,10 +116478,10 @@ webhooks: type: string enum: - enabled - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -115971,11 +116557,11 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - rule: &767 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + rule: &769 title: branch protection rule description: The branch protection rule. Includes a `name` and all the [branch protection settings](https://docs.github.com/enterprise-cloud@latest//github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches#about-branch-protection-settings) @@ -116198,11 +116784,11 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - rule: *767 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + rule: *769 sender: *4 required: - action @@ -116390,11 +116976,11 @@ webhooks: - everyone required: - from - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - rule: *767 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + rule: *769 sender: *4 required: - action @@ -116465,7 +117051,7 @@ webhooks: required: true content: application/json: - schema: &770 + schema: &772 title: Exemption request cancellation event type: object properties: @@ -116473,11 +117059,11 @@ webhooks: type: string enum: - cancelled - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - exemption_request: &768 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + exemption_request: &770 title: Exemption Request description: A request from a user to be exempted from a set of rules. @@ -116715,7 +117301,7 @@ webhooks: - array - 'null' description: The responses to the exemption request. - items: &769 + items: &771 title: Exemption response description: A response to an exemption request by a delegated bypasser. @@ -116825,7 +117411,7 @@ webhooks: required: true content: application/json: - schema: &771 + schema: &773 title: Exemption request completed event type: object properties: @@ -116833,11 +117419,11 @@ webhooks: type: string enum: - completed - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - exemption_request: *768 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + exemption_request: *770 sender: *4 required: - action @@ -116907,7 +117493,7 @@ webhooks: required: true content: application/json: - schema: &772 + schema: &774 title: Exemption request created event type: object properties: @@ -116915,11 +117501,11 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - exemption_request: *768 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + exemption_request: *770 sender: *4 required: - action @@ -116989,7 +117575,7 @@ webhooks: required: true content: application/json: - schema: &773 + schema: &775 title: Exemption response dismissed event type: object properties: @@ -116997,12 +117583,12 @@ webhooks: type: string enum: - response_dismissed - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - exemption_request: *768 - exemption_response: *769 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + exemption_request: *770 + exemption_response: *771 sender: *4 required: - action @@ -117074,7 +117660,7 @@ webhooks: required: true content: application/json: - schema: &774 + schema: &776 title: Exemption response submitted event type: object properties: @@ -117082,12 +117668,12 @@ webhooks: type: string enum: - response_submitted - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - exemption_request: *768 - exemption_response: *769 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + exemption_request: *770 + exemption_response: *771 sender: *4 required: - action @@ -117160,7 +117746,7 @@ webhooks: required: true content: application/json: - schema: *770 + schema: *772 responses: '200': description: Return a 200 status to indicate that the data was received @@ -117227,7 +117813,7 @@ webhooks: required: true content: application/json: - schema: *771 + schema: *773 responses: '200': description: Return a 200 status to indicate that the data was received @@ -117294,7 +117880,7 @@ webhooks: required: true content: application/json: - schema: *772 + schema: *774 responses: '200': description: Return a 200 status to indicate that the data was received @@ -117361,7 +117947,7 @@ webhooks: required: true content: application/json: - schema: *773 + schema: *775 responses: '200': description: Return a 200 status to indicate that the data was received @@ -117429,7 +118015,7 @@ webhooks: required: true content: application/json: - schema: *774 + schema: *776 responses: '200': description: Return a 200 status to indicate that the data was received @@ -117507,7 +118093,7 @@ webhooks: type: string enum: - completed - check_run: &776 + check_run: &778 title: CheckRun description: A check performed on the code of a given code change type: object @@ -117572,8 +118158,8 @@ webhooks: - MDEwOkNoZWNrU3VpdGU1 pull_requests: type: array - items: *440 - repository: *193 + items: *442 + repository: *195 status: type: string enum: @@ -117617,7 +118203,7 @@ webhooks: - examples: - neutral - deployment: *775 + deployment: *777 details_url: type: string examples: @@ -117677,7 +118263,7 @@ webhooks: - annotations_url pull_requests: type: array - items: *440 + items: *442 started_at: type: string format: date-time @@ -117715,9 +118301,9 @@ webhooks: - output - app - pull_requests - installation: *764 - organization: *765 - repository: *766 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - check_run @@ -118110,10 +118696,10 @@ webhooks: type: string enum: - created - check_run: *776 - installation: *764 - organization: *765 - repository: *766 + check_run: *778 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - check_run @@ -118509,10 +119095,10 @@ webhooks: type: string enum: - requested_action - check_run: *776 - installation: *764 - organization: *765 - repository: *766 + check_run: *778 + installation: *766 + organization: *767 + repository: *768 requested_action: description: The action requested by the user. type: object @@ -118917,10 +119503,10 @@ webhooks: type: string enum: - rerequested - check_run: *776 - installation: *764 - organization: *765 - repository: *766 + check_run: *778 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - check_run @@ -119912,10 +120498,10 @@ webhooks: - latest_check_runs_count - check_runs_url - head_commit - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -120600,10 +121186,10 @@ webhooks: - latest_check_runs_count - check_runs_url - head_commit - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -121282,10 +121868,10 @@ webhooks: - latest_check_runs_count - check_runs_url - head_commit - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -121451,7 +122037,7 @@ webhooks: required: - login - id - dismissed_comment: *452 + dismissed_comment: *454 dismissed_reason: description: The reason for dismissing or closing the alert. type: @@ -121603,20 +122189,20 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: &777 + commit_oid: &779 description: The commit SHA of the code scanning alert. When the action is `reopened_by_user` or `closed_by_user`, the event was triggered by the `sender` and this value will be empty. type: string - enterprise: *763 - installation: *764 - organization: *765 - ref: &778 + enterprise: *765 + installation: *766 + organization: *767 + ref: &780 description: The Git reference of the code scanning alert. When the action is `reopened_by_user` or `closed_by_user`, the event was triggered by the `sender` and this value will be empty. type: string - repository: *766 + repository: *768 sender: *4 required: - action @@ -121780,7 +122366,7 @@ webhooks: required: - login - id - dismissed_comment: *452 + dismissed_comment: *454 dismissed_reason: description: The reason for dismissing or closing the alert. type: @@ -122021,12 +122607,12 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: *777 - enterprise: *763 - installation: *764 - organization: *765 - ref: *778 - repository: *766 + commit_oid: *779 + enterprise: *765 + installation: *766 + organization: *767 + ref: *780 + repository: *768 sender: *4 required: - action @@ -122124,7 +122710,7 @@ webhooks: dismissed_by: type: - 'null' - dismissed_comment: *452 + dismissed_comment: *454 dismissed_reason: description: 'The reason for dismissing or closing the alert. Can be one of: `false positive`, `won''t fix`, and `used in @@ -122306,12 +122892,12 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: *777 - enterprise: *763 - installation: *764 - organization: *765 - ref: *778 - repository: *766 + commit_oid: *779 + enterprise: *765 + installation: *766 + organization: *767 + ref: *780 + repository: *768 sender: *4 required: - action @@ -122477,7 +123063,7 @@ webhooks: required: - login - id - dismissed_comment: *452 + dismissed_comment: *454 dismissed_reason: description: The reason for dismissing or closing the alert. type: @@ -122654,12 +123240,12 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: *777 - enterprise: *763 - installation: *764 - organization: *765 - ref: *778 - repository: *766 + commit_oid: *779 + enterprise: *765 + installation: *766 + organization: *767 + ref: *780 + repository: *768 sender: *4 required: - action @@ -122759,7 +123345,7 @@ webhooks: type: - object - 'null' - dismissed_comment: *452 + dismissed_comment: *454 dismissed_reason: description: 'The reason for dismissing or closing the alert. Can be one of: `false positive`, `won''t fix`, and `used in @@ -122939,9 +123525,9 @@ webhooks: type: - string - 'null' - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 ref: description: The Git reference of the code scanning alert. When the action is `reopened_by_user` or `closed_by_user`, the event @@ -122949,7 +123535,7 @@ webhooks: type: - string - 'null' - repository: *766 + repository: *768 sender: *4 required: - action @@ -123045,7 +123631,7 @@ webhooks: dismissed_by: type: - 'null' - dismissed_comment: *452 + dismissed_comment: *454 dismissed_reason: description: 'The reason for dismissing or closing the alert. Can be one of: `false positive`, `won''t fix`, and `used in @@ -123192,12 +123778,12 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: *777 - enterprise: *763 - installation: *764 - organization: *765 - ref: *778 - repository: *766 + commit_oid: *779 + enterprise: *765 + installation: *766 + organization: *767 + ref: *780 + repository: *768 sender: *4 required: - action @@ -123459,10 +124045,10 @@ webhooks: - updated_at - author_association - body - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -123543,18 +124129,18 @@ webhooks: type: - string - 'null' - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 master_branch: description: The name of the repository's default branch (usually `main`). type: string - organization: *765 - pusher_type: &779 + organization: *767 + pusher_type: &781 description: The pusher type for the event. Can be either `user` or a deploy key. type: string - ref: &780 + ref: &782 description: The [`git ref`](https://docs.github.com/enterprise-cloud@latest//rest/git/refs#get-a-reference) resource. type: string @@ -123564,7 +124150,7 @@ webhooks: enum: - tag - branch - repository: *766 + repository: *768 sender: *4 required: - ref @@ -123646,10 +124232,10 @@ webhooks: type: string enum: - created - definition: *112 - enterprise: *763 - installation: *764 - organization: *765 + definition: *115 + enterprise: *765 + installation: *766 + organization: *767 sender: *4 required: - action @@ -123734,9 +124320,9 @@ webhooks: description: The name of the property that was deleted. required: - property_name - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 sender: *4 required: - action @@ -123813,10 +124399,10 @@ webhooks: type: string enum: - promote_to_enterprise - definition: *112 - enterprise: *763 - installation: *764 - organization: *765 + definition: *115 + enterprise: *765 + installation: *766 + organization: *767 sender: *4 required: - action @@ -123893,10 +124479,10 @@ webhooks: type: string enum: - updated - definition: *112 - enterprise: *763 - installation: *764 - organization: *765 + definition: *115 + enterprise: *765 + installation: *766 + organization: *767 sender: *4 required: - action @@ -123973,19 +124559,19 @@ webhooks: type: string enum: - updated - enterprise: *763 - installation: *764 - repository: *766 - organization: *765 + enterprise: *765 + installation: *766 + repository: *768 + organization: *767 sender: *4 new_property_values: type: array description: The new custom property values for the repository. - items: *317 + items: *319 old_property_values: type: array description: The old custom property values for the repository. - items: *317 + items: *319 required: - action - repository @@ -124061,18 +124647,18 @@ webhooks: title: delete event type: object properties: - enterprise: *763 - installation: *764 - organization: *765 - pusher_type: *779 - ref: *780 + enterprise: *765 + installation: *766 + organization: *767 + pusher_type: *781 + ref: *782 ref_type: description: The type of Git ref object deleted in the repository. type: string enum: - tag - branch - repository: *766 + repository: *768 sender: *4 required: - ref @@ -124156,11 +124742,11 @@ webhooks: type: string enum: - auto_dismissed - alert: *504 - installation: *764 - organization: *765 - enterprise: *763 - repository: *766 + alert: *506 + installation: *766 + organization: *767 + enterprise: *765 + repository: *768 sender: *4 required: - action @@ -124244,11 +124830,11 @@ webhooks: type: string enum: - auto_reopened - alert: *504 - installation: *764 - organization: *765 - enterprise: *763 - repository: *766 + alert: *506 + installation: *766 + organization: *767 + enterprise: *765 + repository: *768 sender: *4 required: - action @@ -124332,11 +124918,11 @@ webhooks: type: string enum: - created - alert: *504 - installation: *764 - organization: *765 - enterprise: *763 - repository: *766 + alert: *506 + installation: *766 + organization: *767 + enterprise: *765 + repository: *768 sender: *4 required: - action @@ -124418,11 +125004,11 @@ webhooks: type: string enum: - dismissed - alert: *504 - installation: *764 - organization: *765 - enterprise: *763 - repository: *766 + alert: *506 + installation: *766 + organization: *767 + enterprise: *765 + repository: *768 sender: *4 required: - action @@ -124504,11 +125090,11 @@ webhooks: type: string enum: - fixed - alert: *504 - installation: *764 - organization: *765 - enterprise: *763 - repository: *766 + alert: *506 + installation: *766 + organization: *767 + enterprise: *765 + repository: *768 sender: *4 required: - action @@ -124591,11 +125177,11 @@ webhooks: type: string enum: - reintroduced - alert: *504 - installation: *764 - organization: *765 - enterprise: *763 - repository: *766 + alert: *506 + installation: *766 + organization: *767 + enterprise: *765 + repository: *768 sender: *4 required: - action @@ -124677,11 +125263,11 @@ webhooks: type: string enum: - reopened - alert: *504 - installation: *764 - organization: *765 - enterprise: *763 - repository: *766 + alert: *506 + installation: *766 + organization: *767 + enterprise: *765 + repository: *768 sender: *4 required: - action @@ -124758,9 +125344,9 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - key: &781 + enterprise: *765 + installation: *766 + key: &783 description: The [`deploy key`](https://docs.github.com/enterprise-cloud@latest//rest/deploy-keys/deploy-keys#get-a-deploy-key) resource. type: object @@ -124798,8 +125384,8 @@ webhooks: - verified - created_at - read_only - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -124876,11 +125462,11 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - key: *781 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + key: *783 + organization: *767 + repository: *768 sender: *4 required: - action @@ -125452,12 +126038,12 @@ webhooks: - updated_at - statuses_url - repository_url - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 - workflow: &785 + workflow: &787 title: Workflow type: - object @@ -126195,13 +126781,13 @@ webhooks: description: The URL to review the deployment protection rule. type: string format: uri - deployment: *510 + deployment: *512 pull_requests: type: array - items: *601 - repository: *766 - organization: *765 - installation: *764 + items: *603 + repository: *768 + organization: *767 + installation: *766 sender: *4 responses: '200': @@ -126272,7 +126858,7 @@ webhooks: type: string enum: - approved - approver: &782 + approver: &784 type: object properties: avatar_url: @@ -126315,11 +126901,11 @@ webhooks: type: string comment: type: string - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - reviewers: &783 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + reviewers: &785 type: array items: type: object @@ -126400,7 +126986,7 @@ webhooks: sender: *4 since: type: string - workflow_job_run: &784 + workflow_job_run: &786 type: object properties: conclusion: @@ -127146,18 +127732,18 @@ webhooks: type: string enum: - rejected - approver: *782 + approver: *784 comment: type: string - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - reviewers: *783 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + reviewers: *785 sender: *4 since: type: string - workflow_job_run: *784 + workflow_job_run: *786 workflow_job_runs: type: array items: @@ -127874,13 +128460,13 @@ webhooks: type: string enum: - requested - enterprise: *763 + enterprise: *765 environment: type: string - installation: *764 - organization: *765 - repository: *766 - requestor: &790 + installation: *766 + organization: *767 + repository: *768 + requestor: &792 title: User type: - object @@ -129823,12 +130409,12 @@ webhooks: - updated_at - deployment_url - repository_url - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 - workflow: *785 + workflow: *787 workflow_run: title: Deployment Workflow Run type: @@ -130519,7 +131105,7 @@ webhooks: type: string enum: - answered - answer: &788 + answer: &790 type: object properties: author_association: @@ -130679,7 +131265,7 @@ webhooks: - created_at - updated_at - body - discussion: &786 + discussion: &788 title: Discussion description: A Discussion in a repository. type: object @@ -130975,7 +131561,7 @@ webhooks: - id labels: type: array - items: *564 + items: *566 required: - repository_url - category @@ -130997,10 +131583,10 @@ webhooks: - author_association - active_lock_reason - body - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -131127,11 +131713,11 @@ webhooks: - from required: - category - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -131214,11 +131800,11 @@ webhooks: type: string enum: - closed - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -131300,7 +131886,7 @@ webhooks: type: string enum: - created - comment: &787 + comment: &789 type: object properties: author_association: @@ -131460,11 +132046,11 @@ webhooks: - updated_at - body - reactions - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -131547,12 +132133,12 @@ webhooks: type: string enum: - deleted - comment: *787 - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + comment: *789 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -131647,12 +132233,12 @@ webhooks: - from required: - body - comment: *787 - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + comment: *789 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -131736,11 +132322,11 @@ webhooks: type: string enum: - created - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -131822,11 +132408,11 @@ webhooks: type: string enum: - deleted - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -131926,11 +132512,11 @@ webhooks: type: string required: - from - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -132012,10 +132598,10 @@ webhooks: type: string enum: - labeled - discussion: *786 - enterprise: *763 - installation: *764 - label: &789 + discussion: *788 + enterprise: *765 + installation: *766 + label: &791 title: Label type: object properties: @@ -132048,8 +132634,8 @@ webhooks: - color - default - description - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -132132,11 +132718,11 @@ webhooks: type: string enum: - locked - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -132218,11 +132804,11 @@ webhooks: type: string enum: - pinned - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -132304,11 +132890,11 @@ webhooks: type: string enum: - reopened - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -132393,16 +132979,16 @@ webhooks: changes: type: object properties: - new_discussion: *786 - new_repository: *766 + new_discussion: *788 + new_repository: *768 required: - new_discussion - new_repository - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -132485,10 +133071,10 @@ webhooks: type: string enum: - unanswered - discussion: *786 - old_answer: *788 - organization: *765 - repository: *766 + discussion: *788 + old_answer: *790 + organization: *767 + repository: *768 sender: *4 required: - action @@ -132570,12 +133156,12 @@ webhooks: type: string enum: - unlabeled - discussion: *786 - enterprise: *763 - installation: *764 - label: *789 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + label: *791 + organization: *767 + repository: *768 sender: *4 required: - action @@ -132658,11 +133244,11 @@ webhooks: type: string enum: - unlocked - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -132744,11 +133330,11 @@ webhooks: type: string enum: - unpinned - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -132817,7 +133403,7 @@ webhooks: required: true content: application/json: - schema: *772 + schema: *774 responses: '200': description: Return a 200 status to indicate that the data was received @@ -132880,7 +133466,7 @@ webhooks: required: true content: application/json: - schema: *774 + schema: *776 responses: '200': description: Return a 200 status to indicate that the data was received @@ -132946,7 +133532,7 @@ webhooks: required: true content: application/json: - schema: *770 + schema: *772 responses: '200': description: Return a 200 status to indicate that the data was received @@ -133012,7 +133598,7 @@ webhooks: required: true content: application/json: - schema: *771 + schema: *773 responses: '200': description: Return a 200 status to indicate that the data was received @@ -133078,7 +133664,7 @@ webhooks: required: true content: application/json: - schema: *772 + schema: *774 responses: '200': description: Return a 200 status to indicate that the data was received @@ -133144,7 +133730,7 @@ webhooks: required: true content: application/json: - schema: *773 + schema: *775 responses: '200': description: Return a 200 status to indicate that the data was received @@ -133210,7 +133796,7 @@ webhooks: required: true content: application/json: - schema: *774 + schema: *776 responses: '200': description: Return a 200 status to indicate that the data was received @@ -133277,7 +133863,7 @@ webhooks: description: A user forks a repository. type: object properties: - enterprise: *763 + enterprise: *765 forkee: description: The created [`repository`](https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#get-a-repository) resource. @@ -133955,9 +134541,9 @@ webhooks: type: integer watchers_count: type: integer - installation: *764 - organization: *765 - repository: *766 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - forkee @@ -134103,9 +134689,9 @@ webhooks: title: gollum event type: object properties: - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 pages: description: The pages that were updated. type: array @@ -134143,7 +134729,7 @@ webhooks: - action - sha - html_url - repository: *766 + repository: *768 sender: *4 required: - pages @@ -134219,10 +134805,10 @@ webhooks: type: string enum: - created - enterprise: *763 + enterprise: *765 installation: *20 - organization: *765 - repositories: &791 + organization: *767 + repositories: &793 description: An array of repository objects that the installation can access. type: array @@ -134248,8 +134834,8 @@ webhooks: - name - full_name - private - repository: *766 - requester: *790 + repository: *768 + requester: *792 sender: *4 required: - action @@ -134324,11 +134910,11 @@ webhooks: type: string enum: - deleted - enterprise: *763 + enterprise: *765 installation: *20 - organization: *765 - repositories: *791 - repository: *766 + organization: *767 + repositories: *793 + repository: *768 requester: type: - 'null' @@ -134405,11 +134991,11 @@ webhooks: type: string enum: - new_permissions_accepted - enterprise: *763 + enterprise: *765 installation: *20 - organization: *765 - repositories: *791 - repository: *766 + organization: *767 + repositories: *793 + repository: *768 requester: type: - 'null' @@ -134486,10 +135072,10 @@ webhooks: type: string enum: - added - enterprise: *763 + enterprise: *765 installation: *20 - organization: *765 - repositories_added: &792 + organization: *767 + repositories_added: &794 description: An array of repository objects, which were added to the installation. type: array @@ -134535,15 +135121,15 @@ webhooks: private: description: Whether the repository is private or public. type: boolean - repository: *766 - repository_selection: &793 + repository: *768 + repository_selection: &795 description: Describe whether all repositories have been selected or there's a selection involved type: string enum: - all - selected - requester: *790 + requester: *792 sender: *4 required: - action @@ -134622,10 +135208,10 @@ webhooks: type: string enum: - removed - enterprise: *763 + enterprise: *765 installation: *20 - organization: *765 - repositories_added: *792 + organization: *767 + repositories_added: *794 repositories_removed: description: An array of repository objects, which were removed from the installation. @@ -134652,9 +135238,9 @@ webhooks: - name - full_name - private - repository: *766 - repository_selection: *793 - requester: *790 + repository: *768 + repository_selection: *795 + requester: *792 sender: *4 required: - action @@ -134733,11 +135319,11 @@ webhooks: type: string enum: - suspend - enterprise: *763 + enterprise: *765 installation: *20 - organization: *765 - repositories: *791 - repository: *766 + organization: *767 + repositories: *793 + repository: *768 requester: type: - 'null' @@ -134920,10 +135506,10 @@ webhooks: type: string required: - from - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 target_type: type: string @@ -135002,11 +135588,11 @@ webhooks: type: string enum: - unsuspend - enterprise: *763 + enterprise: *765 installation: *20 - organization: *765 - repositories: *791 - repository: *766 + organization: *767 + repositories: *793 + repository: *768 requester: type: - 'null' @@ -135254,8 +135840,8 @@ webhooks: - performed_via_github_app - body - reactions - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 issue: description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) the comment belongs to. @@ -136102,7 +136688,7 @@ webhooks: title: description: Title of the issue type: string - type: *282 + type: *284 updated_at: type: string format: date-time @@ -136446,8 +137032,8 @@ webhooks: - state - locked - assignee - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -136527,7 +137113,7 @@ webhooks: type: string enum: - deleted - comment: &794 + comment: &796 title: issue comment description: The [comment](https://docs.github.com/enterprise-cloud@latest//rest/issues/comments#get-an-issue-comment) itself. @@ -136694,8 +137280,8 @@ webhooks: - performed_via_github_app - body - reactions - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 issue: description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) the comment belongs to. @@ -137538,7 +138124,7 @@ webhooks: title: description: Title of the issue type: string - type: *282 + type: *284 updated_at: type: string format: date-time @@ -137884,8 +138470,8 @@ webhooks: - state - locked - assignee - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -137965,7 +138551,7 @@ webhooks: type: string enum: - edited - changes: &819 + changes: &821 description: The changes to the comment. type: object properties: @@ -137977,9 +138563,9 @@ webhooks: type: string required: - from - comment: *794 - enterprise: *763 - installation: *764 + comment: *796 + enterprise: *765 + installation: *766 issue: description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) the comment belongs to. @@ -138825,7 +139411,7 @@ webhooks: title: description: Title of the issue type: string - type: *282 + type: *284 updated_at: type: string format: date-time @@ -139169,8 +139755,8 @@ webhooks: - state - locked - assignee - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -139252,10 +139838,10 @@ webhooks: type: string enum: - assigned - assignee: *790 - enterprise: *763 - installation: *764 - issue: &797 + assignee: *792 + enterprise: *765 + installation: *766 + issue: &799 title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) itself. @@ -140097,7 +140683,7 @@ webhooks: title: description: Title of the issue type: string - type: *282 + type: *284 updated_at: type: string format: date-time @@ -140200,8 +140786,8 @@ webhooks: - active_lock_reason - body - reactions - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -140281,8 +140867,8 @@ webhooks: type: string enum: - closed - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 issue: description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) itself. @@ -141129,7 +141715,7 @@ webhooks: title: description: Title of the issue type: string - type: *282 + type: *284 updated_at: type: string format: date-time @@ -141375,8 +141961,8 @@ webhooks: required: - state - closed_at - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -141455,8 +142041,8 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -142294,7 +142880,7 @@ webhooks: title: description: Title of the issue type: string - type: *282 + type: *284 updated_at: type: string format: date-time @@ -142396,8 +142982,8 @@ webhooks: - active_lock_reason - body - reactions - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -142476,8 +143062,8 @@ webhooks: type: string enum: - demilestoned - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -143338,7 +143924,7 @@ webhooks: title: description: Title of the issue type: string - type: *282 + type: *284 updated_at: type: string format: date-time @@ -143419,7 +144005,7 @@ webhooks: format: uri user_view_type: type: string - milestone: &795 + milestone: &797 title: Milestone description: A collection of related issues and pull requests. type: object @@ -143562,8 +144148,8 @@ webhooks: - updated_at - due_on - closed_at - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -143662,8 +144248,8 @@ webhooks: type: string required: - from - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -144502,7 +145088,7 @@ webhooks: timeline_url: type: string format: uri - type: *282 + type: *284 title: description: Title of the issue type: string @@ -144608,9 +145194,9 @@ webhooks: - active_lock_reason - body - reactions - label: *789 - organization: *765 - repository: *766 + label: *791 + organization: *767 + repository: *768 sender: *4 required: - action @@ -144690,8 +145276,8 @@ webhooks: type: string enum: - labeled - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -145529,7 +146115,7 @@ webhooks: timeline_url: type: string format: uri - type: *282 + type: *284 title: description: Title of the issue type: string @@ -145635,9 +146221,9 @@ webhooks: - active_lock_reason - body - reactions - label: *789 - organization: *765 - repository: *766 + label: *791 + organization: *767 + repository: *768 sender: *4 required: - action @@ -145717,8 +146303,8 @@ webhooks: type: string enum: - locked - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -146581,7 +147167,7 @@ webhooks: timeline_url: type: string format: uri - type: *282 + type: *284 title: description: Title of the issue type: string @@ -146664,8 +147250,8 @@ webhooks: format: uri user_view_type: type: string - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -146744,8 +147330,8 @@ webhooks: type: string enum: - milestoned - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -147605,7 +148191,7 @@ webhooks: title: description: Title of the issue type: string - type: *282 + type: *284 updated_at: type: string format: date-time @@ -147685,9 +148271,9 @@ webhooks: format: uri user_view_type: type: string - milestone: *795 - organization: *765 - repository: *766 + milestone: *797 + organization: *767 + repository: *768 sender: *4 required: - action @@ -148688,7 +149274,7 @@ webhooks: required: - login - id - type: *282 + type: *284 required: - id - number @@ -149169,8 +149755,8 @@ webhooks: required: - old_issue - old_repository - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -150012,7 +150598,7 @@ webhooks: title: description: Title of the issue type: string - type: *282 + type: *284 updated_at: type: string format: date-time @@ -150114,8 +150700,8 @@ webhooks: - active_lock_reason - body - reactions - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -150195,9 +150781,9 @@ webhooks: type: string enum: - pinned - enterprise: *763 - installation: *764 - issue: &796 + enterprise: *765 + installation: *766 + issue: &798 title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) itself. @@ -151033,7 +151619,7 @@ webhooks: title: description: Title of the issue type: string - type: *282 + type: *284 updated_at: type: string format: date-time @@ -151135,8 +151721,8 @@ webhooks: - active_lock_reason - body - reactions - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -151215,8 +151801,8 @@ webhooks: type: string enum: - reopened - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -152160,9 +152746,9 @@ webhooks: format: uri user_view_type: type: string - type: *282 - organization: *765 - repository: *766 + type: *284 + organization: *767 + repository: *768 sender: *4 required: - action @@ -153081,7 +153667,7 @@ webhooks: title: description: Title of the issue type: string - type: *282 + type: *284 updated_at: type: string format: date-time @@ -153663,11 +154249,11 @@ webhooks: required: - new_issue - new_repository - enterprise: *763 - installation: *764 - issue: *796 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + issue: *798 + organization: *767 + repository: *768 sender: *4 required: - action @@ -153747,12 +154333,12 @@ webhooks: type: string enum: - typed - enterprise: *763 - installation: *764 - issue: *797 - type: *282 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + issue: *799 + type: *284 + organization: *767 + repository: *768 sender: *4 required: - action @@ -153833,7 +154419,7 @@ webhooks: type: string enum: - unassigned - assignee: &822 + assignee: &824 title: User type: - object @@ -153905,11 +154491,11 @@ webhooks: required: - login - id - enterprise: *763 - installation: *764 - issue: *797 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + issue: *799 + organization: *767 + repository: *768 sender: *4 required: - action @@ -153988,12 +154574,12 @@ webhooks: type: string enum: - unlabeled - enterprise: *763 - installation: *764 - issue: *797 - label: *789 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + issue: *799 + label: *791 + organization: *767 + repository: *768 sender: *4 required: - action @@ -154073,8 +154659,8 @@ webhooks: type: string enum: - unlocked - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -154938,7 +155524,7 @@ webhooks: title: description: Title of the issue type: string - type: *282 + type: *284 updated_at: type: string format: date-time @@ -155018,8 +155604,8 @@ webhooks: format: uri user_view_type: type: string - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -155099,11 +155685,11 @@ webhooks: type: string enum: - unpinned - enterprise: *763 - installation: *764 - issue: *796 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + issue: *798 + organization: *767 + repository: *768 sender: *4 required: - action @@ -155182,12 +155768,12 @@ webhooks: type: string enum: - untyped - enterprise: *763 - installation: *764 - issue: *797 - type: *282 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + issue: *799 + type: *284 + organization: *767 + repository: *768 sender: *4 required: - action @@ -155267,11 +155853,11 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - label: *789 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + label: *791 + organization: *767 + repository: *768 sender: *4 required: - action @@ -155349,11 +155935,11 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - label: *789 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + label: *791 + organization: *767 + repository: *768 sender: *4 required: - action @@ -155463,11 +156049,11 @@ webhooks: type: string required: - from - enterprise: *763 - installation: *764 - label: *789 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + label: *791 + organization: *767 + repository: *768 sender: *4 required: - action @@ -155549,9 +156135,9 @@ webhooks: - cancelled effective_date: type: string - enterprise: *763 - installation: *764 - marketplace_purchase: &798 + enterprise: *765 + installation: *766 + marketplace_purchase: &800 title: Marketplace Purchase type: object required: @@ -155639,8 +156225,8 @@ webhooks: type: integer unit_count: type: integer - organization: *765 - previous_marketplace_purchase: &799 + organization: *767 + previous_marketplace_purchase: &801 title: Marketplace Purchase type: object properties: @@ -155724,7 +156310,7 @@ webhooks: - on_free_trial - free_trial_ends_on - plan - repository: *766 + repository: *768 sender: *4 required: - action @@ -155804,10 +156390,10 @@ webhooks: - changed effective_date: type: string - enterprise: *763 - installation: *764 - marketplace_purchase: *798 - organization: *765 + enterprise: *765 + installation: *766 + marketplace_purchase: *800 + organization: *767 previous_marketplace_purchase: title: Marketplace Purchase type: object @@ -155895,7 +156481,7 @@ webhooks: - on_free_trial - free_trial_ends_on - plan - repository: *766 + repository: *768 sender: *4 required: - action @@ -155977,10 +156563,10 @@ webhooks: - pending_change effective_date: type: string - enterprise: *763 - installation: *764 - marketplace_purchase: *798 - organization: *765 + enterprise: *765 + installation: *766 + marketplace_purchase: *800 + organization: *767 previous_marketplace_purchase: title: Marketplace Purchase type: object @@ -156066,7 +156652,7 @@ webhooks: - on_free_trial - free_trial_ends_on - plan - repository: *766 + repository: *768 sender: *4 required: - action @@ -156147,8 +156733,8 @@ webhooks: - pending_change_cancelled effective_date: type: string - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 marketplace_purchase: title: Marketplace Purchase type: object @@ -156234,9 +156820,9 @@ webhooks: type: integer unit_count: type: integer - organization: *765 - previous_marketplace_purchase: *799 - repository: *766 + organization: *767 + previous_marketplace_purchase: *801 + repository: *768 sender: *4 required: - action @@ -156316,12 +156902,12 @@ webhooks: - purchased effective_date: type: string - enterprise: *763 - installation: *764 - marketplace_purchase: *798 - organization: *765 - previous_marketplace_purchase: *799 - repository: *766 + enterprise: *765 + installation: *766 + marketplace_purchase: *800 + organization: *767 + previous_marketplace_purchase: *801 + repository: *768 sender: *4 required: - action @@ -156423,11 +157009,11 @@ webhooks: type: string required: - to - enterprise: *763 - installation: *764 - member: *790 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + member: *792 + organization: *767 + repository: *768 sender: *4 required: - action @@ -156529,11 +157115,11 @@ webhooks: type: - string - 'null' - enterprise: *763 - installation: *764 - member: *790 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + member: *792 + organization: *767 + repository: *768 sender: *4 required: - action @@ -156612,11 +157198,11 @@ webhooks: type: string enum: - removed - enterprise: *763 - installation: *764 - member: *790 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + member: *792 + organization: *767 + repository: *768 sender: *4 required: - action @@ -156694,11 +157280,11 @@ webhooks: type: string enum: - added - enterprise: *763 - installation: *764 - member: *790 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + member: *792 + organization: *767 + repository: *768 scope: description: The scope of the membership. Currently, can only be `team`. @@ -156776,7 +157362,7 @@ webhooks: required: - login - id - team: &800 + team: &802 title: Team description: Groups of organization members that gives permissions on specified repositories. @@ -156969,11 +157555,11 @@ webhooks: type: string enum: - removed - enterprise: *763 - installation: *764 - member: *790 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + member: *792 + organization: *767 + repository: *768 scope: description: The scope of the membership. Currently, can only be `team`. @@ -157052,7 +157638,7 @@ webhooks: required: - login - id - team: *800 + team: *802 required: - action - scope @@ -157134,8 +157720,8 @@ webhooks: type: string enum: - checks_requested - installation: *764 - merge_group: &801 + installation: *766 + merge_group: &803 type: object title: Merge Group description: A group of pull requests that the merge queue has grouped @@ -157154,15 +157740,15 @@ webhooks: description: The full ref of the branch the merge group will be merged into. type: string - head_commit: *444 + head_commit: *446 required: - head_sha - head_ref - base_sha - base_ref - head_commit - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -157248,10 +157834,10 @@ webhooks: - merged - invalidated - dequeued - installation: *764 - merge_group: *801 - organization: *765 - repository: *766 + installation: *766 + merge_group: *803 + organization: *767 + repository: *768 sender: *4 required: - action @@ -157324,7 +157910,7 @@ webhooks: type: string enum: - deleted - enterprise: *763 + enterprise: *765 hook: description: 'The deleted webhook. This will contain different keys based on the type of webhook it is: repository, organization, @@ -157433,12 +158019,12 @@ webhooks: hook_id: description: The id of the modified webhook. type: integer - installation: *764 - organization: *765 + installation: *766 + organization: *767 repository: anyOf: - type: 'null' - - *766 + - *768 sender: *4 required: - action @@ -157518,11 +158104,11 @@ webhooks: type: string enum: - closed - enterprise: *763 - installation: *764 - milestone: *795 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + milestone: *797 + organization: *767 + repository: *768 sender: *4 required: - action @@ -157601,9 +158187,9 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - milestone: &802 + enterprise: *765 + installation: *766 + milestone: &804 title: Milestone description: A collection of related issues and pull requests. type: object @@ -157745,8 +158331,8 @@ webhooks: - updated_at - due_on - closed_at - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -157825,11 +158411,11 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - milestone: *795 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + milestone: *797 + organization: *767 + repository: *768 sender: *4 required: - action @@ -157939,11 +158525,11 @@ webhooks: type: string required: - from - enterprise: *763 - installation: *764 - milestone: *795 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + milestone: *797 + organization: *767 + repository: *768 sender: *4 required: - action @@ -158023,11 +158609,11 @@ webhooks: type: string enum: - opened - enterprise: *763 - installation: *764 - milestone: *802 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + milestone: *804 + organization: *767 + repository: *768 sender: *4 required: - action @@ -158106,11 +158692,11 @@ webhooks: type: string enum: - blocked - blocked_user: *790 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + blocked_user: *792 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -158189,11 +158775,11 @@ webhooks: type: string enum: - unblocked - blocked_user: *790 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + blocked_user: *792 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -158272,9 +158858,9 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - membership: &803 + enterprise: *765 + installation: *766 + membership: &805 title: Membership description: The membership between the user and the organization. Not present when the action is `member_invited`. @@ -158368,8 +158954,8 @@ webhooks: - role - organization_url - user - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -158447,11 +159033,11 @@ webhooks: type: string enum: - member_added - enterprise: *763 - installation: *764 - membership: *803 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + membership: *805 + organization: *767 + repository: *768 sender: *4 required: - action @@ -158530,8 +159116,8 @@ webhooks: type: string enum: - member_invited - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 invitation: description: The invitation for the user or email if the action is `member_invited`. @@ -158653,10 +159239,10 @@ webhooks: - inviter - team_count - invitation_teams_url - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 - user: *790 + user: *792 required: - action - invitation @@ -158734,11 +159320,11 @@ webhooks: type: string enum: - member_removed - enterprise: *763 - installation: *764 - membership: *803 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + membership: *805 + organization: *767 + repository: *768 sender: *4 required: - action @@ -158825,11 +159411,11 @@ webhooks: properties: from: type: string - enterprise: *763 - installation: *764 - membership: *803 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + membership: *805 + organization: *767 + repository: *768 sender: *4 required: - action @@ -158905,9 +159491,9 @@ webhooks: type: string enum: - published - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 package: description: Information about the package. type: object @@ -159430,7 +160016,7 @@ webhooks: - published_at rubygems_metadata: type: array - items: &804 + items: &806 title: Ruby Gems metadata type: object properties: @@ -159527,7 +160113,7 @@ webhooks: - owner - package_version - registry - repository: *766 + repository: *768 sender: *4 required: - action @@ -159603,9 +160189,9 @@ webhooks: type: string enum: - updated - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 package: description: Information about the package. type: object @@ -159967,7 +160553,7 @@ webhooks: - published_at rubygems_metadata: type: array - items: *804 + items: *806 source_url: type: string format: uri @@ -160038,7 +160624,7 @@ webhooks: - owner - package_version - registry - repository: *766 + repository: *768 sender: *4 required: - action @@ -160219,12 +160805,12 @@ webhooks: - duration - created_at - updated_at - enterprise: *763 + enterprise: *765 id: type: integer - installation: *764 - organization: *765 - repository: *766 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - id @@ -160301,7 +160887,7 @@ webhooks: type: string enum: - approved - personal_access_token_request: &805 + personal_access_token_request: &807 title: Personal Access Token Request description: Details of a Personal Access Token Request. type: object @@ -160451,10 +161037,10 @@ webhooks: - token_expired - token_expires_at - token_last_used_at - enterprise: *763 - organization: *765 + enterprise: *765 + organization: *767 sender: *4 - installation: *764 + installation: *766 required: - action - personal_access_token_request @@ -160531,11 +161117,11 @@ webhooks: type: string enum: - cancelled - personal_access_token_request: *805 - enterprise: *763 - organization: *765 + personal_access_token_request: *807 + enterprise: *765 + organization: *767 sender: *4 - installation: *764 + installation: *766 required: - action - personal_access_token_request @@ -160611,11 +161197,11 @@ webhooks: type: string enum: - created - personal_access_token_request: *805 - enterprise: *763 - organization: *765 + personal_access_token_request: *807 + enterprise: *765 + organization: *767 sender: *4 - installation: *764 + installation: *766 required: - action - personal_access_token_request @@ -160690,11 +161276,11 @@ webhooks: type: string enum: - denied - personal_access_token_request: *805 - organization: *765 - enterprise: *763 + personal_access_token_request: *807 + organization: *767 + enterprise: *765 sender: *4 - installation: *764 + installation: *766 required: - action - personal_access_token_request @@ -160799,7 +161385,7 @@ webhooks: id: description: Unique identifier of the webhook. type: integer - last_response: *806 + last_response: *808 name: description: The type of webhook. The only valid value is 'web'. type: string @@ -160831,8 +161417,8 @@ webhooks: hook_id: description: The ID of the webhook that triggered the ping. type: integer - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 zen: description: Random string of GitHub zen. @@ -161077,10 +161663,10 @@ webhooks: - from required: - note - enterprise: *763 - installation: *764 - organization: *765 - project_card: &807 + enterprise: *765 + installation: *766 + organization: *767 + project_card: &809 title: Project Card type: object properties: @@ -161203,7 +161789,7 @@ webhooks: - creator - created_at - updated_at - repository: *766 + repository: *768 sender: *4 required: - action @@ -161284,11 +161870,11 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - organization: *765 - project_card: *807 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + project_card: *809 + repository: *768 sender: *4 required: - action @@ -161368,9 +161954,9 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 project_card: title: Project Card type: object @@ -161500,7 +162086,7 @@ webhooks: repository: anyOf: - type: 'null' - - *766 + - *768 sender: *4 required: - action @@ -161594,11 +162180,11 @@ webhooks: - from required: - note - enterprise: *763 - installation: *764 - organization: *765 - project_card: *807 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + project_card: *809 + repository: *768 sender: *4 required: - action @@ -161692,9 +162278,9 @@ webhooks: - from required: - column_id - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 project_card: allOf: - title: Project Card @@ -161891,7 +162477,7 @@ webhooks: type: string required: - after_id - repository: *766 + repository: *768 sender: *4 required: - action @@ -161971,10 +162557,10 @@ webhooks: type: string enum: - closed - enterprise: *763 - installation: *764 - organization: *765 - project: &809 + enterprise: *765 + installation: *766 + organization: *767 + project: &811 title: Project type: object properties: @@ -162101,7 +162687,7 @@ webhooks: - creator - created_at - updated_at - repository: *766 + repository: *768 sender: *4 required: - action @@ -162181,10 +162767,10 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - organization: *765 - project_column: &808 + enterprise: *765 + installation: *766 + organization: *767 + project_column: &810 title: Project Column type: object properties: @@ -162224,7 +162810,7 @@ webhooks: - name - created_at - updated_at - repository: *766 + repository: *768 sender: *4 required: - action @@ -162303,14 +162889,14 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - organization: *765 - project_column: *808 + enterprise: *765 + installation: *766 + organization: *767 + project_column: *810 repository: anyOf: - type: 'null' - - *766 + - *768 sender: *4 required: - action @@ -162399,11 +162985,11 @@ webhooks: type: string required: - from - enterprise: *763 - installation: *764 - organization: *765 - project_column: *808 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + project_column: *810 + repository: *768 sender: *4 required: - action @@ -162483,11 +163069,11 @@ webhooks: type: string enum: - moved - enterprise: *763 - installation: *764 - organization: *765 - project_column: *808 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + project_column: *810 + repository: *768 sender: *4 required: - action @@ -162567,11 +163153,11 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - organization: *765 - project: *809 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + project: *811 + repository: *768 sender: *4 required: - action @@ -162651,14 +163237,14 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - organization: *765 - project: *809 + enterprise: *765 + installation: *766 + organization: *767 + project: *811 repository: anyOf: - type: 'null' - - *766 + - *768 sender: *4 required: - action @@ -162759,11 +163345,11 @@ webhooks: type: string required: - from - enterprise: *763 - installation: *764 - organization: *765 - project: *809 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + project: *811 + repository: *768 sender: *4 required: - action @@ -162842,11 +163428,11 @@ webhooks: type: string enum: - reopened - enterprise: *763 - installation: *764 - organization: *765 - project: *809 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + project: *811 + repository: *768 sender: *4 required: - action @@ -162927,9 +163513,9 @@ webhooks: type: string enum: - closed - installation: *764 - organization: *765 - projects_v2: &810 + installation: *766 + organization: *767 + projects_v2: &812 title: Projects v2 Project description: A projects v2 project type: object @@ -163077,9 +163663,9 @@ webhooks: type: string enum: - created - installation: *764 - organization: *765 - projects_v2: *810 + installation: *766 + organization: *767 + projects_v2: *812 sender: *4 required: - action @@ -163160,9 +163746,9 @@ webhooks: type: string enum: - deleted - installation: *764 - organization: *765 - projects_v2: *810 + installation: *766 + organization: *767 + projects_v2: *812 sender: *4 required: - action @@ -163283,9 +163869,9 @@ webhooks: type: string to: type: string - installation: *764 - organization: *765 - projects_v2: *810 + installation: *766 + organization: *767 + projects_v2: *812 sender: *4 required: - action @@ -163368,7 +163954,7 @@ webhooks: type: string enum: - archived - changes: &814 + changes: &816 type: object properties: archived_at: @@ -163384,9 +163970,9 @@ webhooks: - string - 'null' format: date-time - installation: *764 - organization: *765 - projects_v2_item: &811 + installation: *766 + organization: *767 + projects_v2_item: &813 title: Projects v2 Item description: An item belonging to a project type: object @@ -163525,9 +164111,9 @@ webhooks: - 'null' to: type: string - installation: *764 - organization: *765 - projects_v2_item: *811 + installation: *766 + organization: *767 + projects_v2_item: *813 sender: *4 required: - action @@ -163609,9 +164195,9 @@ webhooks: type: string enum: - created - installation: *764 - organization: *765 - projects_v2_item: *811 + installation: *766 + organization: *767 + projects_v2_item: *813 sender: *4 required: - action @@ -163692,9 +164278,9 @@ webhooks: type: string enum: - deleted - installation: *764 - organization: *765 - projects_v2_item: *811 + installation: *766 + organization: *767 + projects_v2_item: *813 sender: *4 required: - action @@ -163799,7 +164385,7 @@ webhooks: oneOf: - type: string - type: integer - - &812 + - &814 title: Projects v2 Single Select Option description: An option for a single select field type: object @@ -163819,7 +164405,7 @@ webhooks: required: - id - name - - &813 + - &815 title: Projects v2 Iteration Setting description: An iteration setting for an iteration field type: object @@ -163848,8 +164434,8 @@ webhooks: oneOf: - type: string - type: integer - - *812 - - *813 + - *814 + - *815 type: - 'null' - string @@ -163872,9 +164458,9 @@ webhooks: - 'null' required: - body - installation: *764 - organization: *765 - projects_v2_item: *811 + installation: *766 + organization: *767 + projects_v2_item: *813 sender: *4 required: - action @@ -163971,9 +164557,9 @@ webhooks: type: - string - 'null' - installation: *764 - organization: *765 - projects_v2_item: *811 + installation: *766 + organization: *767 + projects_v2_item: *813 sender: *4 required: - action @@ -164056,10 +164642,10 @@ webhooks: type: string enum: - restored - changes: *814 - installation: *764 - organization: *765 - projects_v2_item: *811 + changes: *816 + installation: *766 + organization: *767 + projects_v2_item: *813 sender: *4 required: - action @@ -164141,9 +164727,9 @@ webhooks: type: string enum: - reopened - installation: *764 - organization: *765 - projects_v2: *810 + installation: *766 + organization: *767 + projects_v2: *812 sender: *4 required: - action @@ -164224,9 +164810,9 @@ webhooks: type: string enum: - created - installation: *764 - organization: *765 - projects_v2_status_update: &815 + installation: *766 + organization: *767 + projects_v2_status_update: &817 title: Projects v2 Status Update description: An status update belonging to a project type: object @@ -164361,9 +164947,9 @@ webhooks: type: string enum: - deleted - installation: *764 - organization: *765 - projects_v2_status_update: *815 + installation: *766 + organization: *767 + projects_v2_status_update: *817 sender: *4 required: - action @@ -164509,9 +165095,9 @@ webhooks: - string - 'null' format: date - installation: *764 - organization: *765 - projects_v2_status_update: *815 + installation: *766 + organization: *767 + projects_v2_status_update: *817 sender: *4 required: - action @@ -164582,10 +165168,10 @@ webhooks: title: public event type: object properties: - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - repository @@ -164662,13 +165248,13 @@ webhooks: type: string enum: - assigned - assignee: *790 - enterprise: *763 - installation: *764 - number: &816 + assignee: *792 + enterprise: *765 + installation: *766 + number: &818 description: The pull request number. type: integer - organization: *765 + organization: *767 pull_request: title: Pull Request type: object @@ -167017,7 +167603,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 sender: *4 required: - action @@ -167099,11 +167685,11 @@ webhooks: type: string enum: - auto_merge_disabled - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 number: type: integer - organization: *765 + organization: *767 pull_request: title: Pull Request type: object @@ -169445,7 +170031,7 @@ webhooks: - draft reason: type: string - repository: *766 + repository: *768 sender: *4 required: - action @@ -169527,11 +170113,11 @@ webhooks: type: string enum: - auto_merge_enabled - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 number: type: integer - organization: *765 + organization: *767 pull_request: title: Pull Request type: object @@ -171873,7 +172459,7 @@ webhooks: - draft reason: type: string - repository: *766 + repository: *768 sender: *4 required: - action @@ -171955,13 +172541,13 @@ webhooks: type: string enum: - closed - enterprise: *763 - installation: *764 - number: *816 - organization: *765 - pull_request: &817 + enterprise: *765 + installation: *766 + number: *818 + organization: *767 + pull_request: &819 allOf: - - *601 + - *603 - type: object properties: allow_auto_merge: @@ -172023,7 +172609,7 @@ webhooks: Please use `squash_merge_commit_title` instead.** type: boolean default: false - repository: *766 + repository: *768 sender: *4 required: - action @@ -172104,12 +172690,12 @@ webhooks: type: string enum: - converted_to_draft - enterprise: *763 - installation: *764 - number: *816 - organization: *765 - pull_request: *817 - repository: *766 + enterprise: *765 + installation: *766 + number: *818 + organization: *767 + pull_request: *819 + repository: *768 sender: *4 required: - action @@ -172189,11 +172775,11 @@ webhooks: type: string enum: - demilestoned - enterprise: *763 - milestone: *490 - number: *816 - organization: *765 - pull_request: &818 + enterprise: *765 + milestone: *492 + number: *818 + organization: *767 + pull_request: &820 title: Pull Request type: object properties: @@ -174520,7 +175106,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 sender: *4 required: - action @@ -174599,11 +175185,11 @@ webhooks: type: string enum: - dequeued - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 number: type: integer - organization: *765 + organization: *767 pull_request: title: Pull Request type: object @@ -176949,7 +177535,7 @@ webhooks: - BRANCH_PROTECTIONS - GIT_TREE_INVALID - INVALID_MERGE_COMMIT - repository: *766 + repository: *768 sender: *4 required: - action @@ -177073,12 +177659,12 @@ webhooks: type: string required: - from - enterprise: *763 - installation: *764 - number: *816 - organization: *765 - pull_request: *817 - repository: *766 + enterprise: *765 + installation: *766 + number: *818 + organization: *767 + pull_request: *819 + repository: *768 sender: *4 required: - action @@ -177158,11 +177744,11 @@ webhooks: type: string enum: - enqueued - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 number: type: integer - organization: *765 + organization: *767 pull_request: title: Pull Request type: object @@ -179493,7 +180079,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 sender: *4 required: - action @@ -179573,11 +180159,11 @@ webhooks: type: string enum: - labeled - enterprise: *763 - installation: *764 - label: *789 - number: *816 - organization: *765 + enterprise: *765 + installation: *766 + label: *791 + number: *818 + organization: *767 pull_request: title: Pull Request type: object @@ -181925,7 +182511,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 sender: *4 required: - action @@ -182006,10 +182592,10 @@ webhooks: type: string enum: - locked - enterprise: *763 - installation: *764 - number: *816 - organization: *765 + enterprise: *765 + installation: *766 + number: *818 + organization: *767 pull_request: title: Pull Request type: object @@ -184355,7 +184941,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 sender: *4 required: - action @@ -184435,12 +185021,12 @@ webhooks: type: string enum: - milestoned - enterprise: *763 - milestone: *490 - number: *816 - organization: *765 - pull_request: *818 - repository: *766 + enterprise: *765 + milestone: *492 + number: *818 + organization: *767 + pull_request: *820 + repository: *768 sender: *4 required: - action @@ -184519,12 +185105,12 @@ webhooks: type: string enum: - opened - enterprise: *763 - installation: *764 - number: *816 - organization: *765 - pull_request: *817 - repository: *766 + enterprise: *765 + installation: *766 + number: *818 + organization: *767 + pull_request: *819 + repository: *768 sender: *4 required: - action @@ -184605,12 +185191,12 @@ webhooks: type: string enum: - ready_for_review - enterprise: *763 - installation: *764 - number: *816 - organization: *765 - pull_request: *817 - repository: *766 + enterprise: *765 + installation: *766 + number: *818 + organization: *767 + pull_request: *819 + repository: *768 sender: *4 required: - action @@ -184690,12 +185276,12 @@ webhooks: type: string enum: - reopened - enterprise: *763 - installation: *764 - number: *816 - organization: *765 - pull_request: *817 - repository: *766 + enterprise: *765 + installation: *766 + number: *818 + organization: *767 + pull_request: *819 + repository: *768 sender: *4 required: - action @@ -185070,9 +185656,9 @@ webhooks: - start_side - side - reactions - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 pull_request: type: object properties: @@ -187302,7 +187888,7 @@ webhooks: - _links - author_association - active_lock_reason - repository: *766 + repository: *768 sender: *4 required: - action @@ -187382,7 +187968,7 @@ webhooks: type: string enum: - deleted - comment: &820 + comment: &822 title: Pull Request Review Comment description: The [comment](https://docs.github.com/enterprise-cloud@latest//rest/pulls/comments#get-a-review-comment-for-a-pull-request) itself. @@ -187675,9 +188261,9 @@ webhooks: - start_side - side - reactions - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 pull_request: type: object properties: @@ -189895,7 +190481,7 @@ webhooks: - _links - author_association - active_lock_reason - repository: *766 + repository: *768 sender: *4 required: - action @@ -189975,11 +190561,11 @@ webhooks: type: string enum: - edited - changes: *819 - comment: *820 - enterprise: *763 - installation: *764 - organization: *765 + changes: *821 + comment: *822 + enterprise: *765 + installation: *766 + organization: *767 pull_request: type: object properties: @@ -192200,7 +192786,7 @@ webhooks: - _links - author_association - active_lock_reason - repository: *766 + repository: *768 sender: *4 required: - action @@ -192281,9 +192867,9 @@ webhooks: type: string enum: - dismissed - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 pull_request: title: Simple Pull Request type: object @@ -194516,7 +195102,7 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *766 + repository: *768 review: description: The review that was affected. type: object @@ -194762,9 +195348,9 @@ webhooks: type: string required: - from - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 pull_request: title: Simple Pull Request type: object @@ -196878,8 +197464,8 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *766 - review: &821 + repository: *768 + review: &823 description: The review that was affected. type: object properties: @@ -197112,12 +197698,12 @@ webhooks: type: string enum: - review_request_removed - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 number: description: The pull request number. type: integer - organization: *765 + organization: *767 pull_request: title: Pull Request type: object @@ -199464,7 +200050,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 requested_reviewer: title: User type: @@ -199550,12 +200136,12 @@ webhooks: type: string enum: - review_request_removed - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 number: description: The pull request number. type: integer - organization: *765 + organization: *767 pull_request: title: Pull Request type: object @@ -201909,7 +202495,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 requested_team: title: Team description: Groups of organization members that gives permissions @@ -202104,12 +202690,12 @@ webhooks: type: string enum: - review_requested - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 number: description: The pull request number. type: integer - organization: *765 + organization: *767 pull_request: title: Pull Request type: object @@ -204458,7 +205044,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 requested_reviewer: title: User type: @@ -204545,12 +205131,12 @@ webhooks: type: string enum: - review_requested - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 number: description: The pull request number. type: integer - organization: *765 + organization: *767 pull_request: title: Pull Request type: object @@ -206890,7 +207476,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 requested_team: title: Team description: Groups of organization members that gives permissions @@ -207074,9 +207660,9 @@ webhooks: type: string enum: - submitted - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 pull_request: title: Simple Pull Request type: object @@ -209312,8 +209898,8 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *766 - review: *821 + repository: *768 + review: *823 sender: *4 required: - action @@ -209393,9 +209979,9 @@ webhooks: type: string enum: - resolved - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 pull_request: title: Simple Pull Request type: object @@ -211526,7 +212112,7 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *766 + repository: *768 sender: *4 thread: type: object @@ -211918,9 +212504,9 @@ webhooks: type: string enum: - unresolved - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 pull_request: title: Simple Pull Request type: object @@ -214034,7 +214620,7 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *766 + repository: *768 sender: *4 thread: type: object @@ -214428,10 +215014,10 @@ webhooks: type: string before: type: string - enterprise: *763 - installation: *764 - number: *816 - organization: *765 + enterprise: *765 + installation: *766 + number: *818 + organization: *767 pull_request: title: Pull Request type: object @@ -216766,7 +217352,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 sender: *4 required: - action @@ -216848,11 +217434,11 @@ webhooks: type: string enum: - unassigned - assignee: *822 - enterprise: *763 - installation: *764 - number: *816 - organization: *765 + assignee: *824 + enterprise: *765 + installation: *766 + number: *818 + organization: *767 pull_request: title: Pull Request type: object @@ -219202,7 +219788,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 sender: *4 required: - action @@ -219281,11 +219867,11 @@ webhooks: type: string enum: - unlabeled - enterprise: *763 - installation: *764 - label: *789 - number: *816 - organization: *765 + enterprise: *765 + installation: *766 + label: *791 + number: *818 + organization: *767 pull_request: title: Pull Request type: object @@ -221624,7 +222210,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 sender: *4 required: - action @@ -221705,10 +222291,10 @@ webhooks: type: string enum: - unlocked - enterprise: *763 - installation: *764 - number: *816 - organization: *765 + enterprise: *765 + installation: *766 + number: *818 + organization: *767 pull_request: title: Pull Request type: object @@ -224037,7 +224623,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 sender: *4 required: - action @@ -224240,7 +224826,7 @@ webhooks: deleted: description: Whether this push deleted the `ref`. type: boolean - enterprise: *763 + enterprise: *765 forced: description: Whether this push was a force push of the `ref`. type: boolean @@ -224335,8 +224921,8 @@ webhooks: - url - author - committer - installation: *764 - organization: *765 + installation: *766 + organization: *767 pusher: title: Committer description: Metaproperties for Git author/committer information. @@ -224924,9 +225510,9 @@ webhooks: type: string enum: - published - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 registry_package: type: object properties: @@ -225403,7 +225989,7 @@ webhooks: type: string rubygems_metadata: type: array - items: *804 + items: *806 summary: type: string tag_name: @@ -225459,7 +226045,7 @@ webhooks: - owner - package_version - registry - repository: *766 + repository: *768 sender: *4 required: - action @@ -225537,9 +226123,9 @@ webhooks: type: string enum: - updated - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 registry_package: type: object properties: @@ -225851,7 +226437,7 @@ webhooks: - published_at rubygems_metadata: type: array - items: *804 + items: *806 summary: type: string tag_name: @@ -225901,7 +226487,7 @@ webhooks: - owner - package_version - registry - repository: *766 + repository: *768 sender: *4 required: - action @@ -225978,10 +226564,10 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - organization: *765 - release: &823 + enterprise: *765 + installation: *766 + organization: *767 + release: &825 title: Release description: The [release](https://docs.github.com/enterprise-cloud@latest//rest/releases/releases/#get-a-release) object. @@ -226302,7 +226888,7 @@ webhooks: - tarball_url - zipball_url - body - repository: *766 + repository: *768 sender: *4 required: - action @@ -226379,11 +226965,11 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - organization: *765 - release: *823 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + release: *825 + repository: *768 sender: *4 required: - action @@ -226500,11 +227086,11 @@ webhooks: type: boolean required: - to - enterprise: *763 - installation: *764 - organization: *765 - release: *823 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + release: *825 + repository: *768 sender: *4 required: - action @@ -226582,9 +227168,9 @@ webhooks: type: string enum: - prereleased - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 release: title: Release description: The [release](https://docs.github.com/enterprise-cloud@latest//rest/releases/releases/#get-a-release) @@ -226910,7 +227496,7 @@ webhooks: - string - 'null' format: uri - repository: *766 + repository: *768 sender: *4 required: - action @@ -226986,10 +227572,10 @@ webhooks: type: string enum: - published - enterprise: *763 - installation: *764 - organization: *765 - release: &824 + enterprise: *765 + installation: *766 + organization: *767 + release: &826 title: Release description: The [release](https://docs.github.com/enterprise-cloud@latest//rest/releases/releases/#get-a-release) object. @@ -227312,7 +227898,7 @@ webhooks: - string - 'null' format: uri - repository: *766 + repository: *768 sender: *4 required: - action @@ -227388,11 +227974,11 @@ webhooks: type: string enum: - released - enterprise: *763 - installation: *764 - organization: *765 - release: *823 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + release: *825 + repository: *768 sender: *4 required: - action @@ -227468,11 +228054,11 @@ webhooks: type: string enum: - unpublished - enterprise: *763 - installation: *764 - organization: *765 - release: *824 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + release: *826 + repository: *768 sender: *4 required: - action @@ -227548,11 +228134,11 @@ webhooks: type: string enum: - published - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - repository_advisory: *672 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + repository_advisory: *674 sender: *4 required: - action @@ -227628,11 +228214,11 @@ webhooks: type: string enum: - reported - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - repository_advisory: *672 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + repository_advisory: *674 sender: *4 required: - action @@ -227708,10 +228294,10 @@ webhooks: type: string enum: - archived - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -227788,10 +228374,10 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -227869,10 +228455,10 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -227957,10 +228543,10 @@ webhooks: additionalProperties: true description: The `client_payload` that was specified in the `POST /repos/{owner}/{repo}/dispatches` request body. - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -228075,10 +228661,10 @@ webhooks: - 'null' items: type: string - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -228150,10 +228736,10 @@ webhooks: title: repository_import event type: object properties: - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 status: type: string @@ -228234,10 +228820,10 @@ webhooks: type: string enum: - privatized - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -228314,10 +228900,10 @@ webhooks: type: string enum: - publicized - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -228411,10 +228997,10 @@ webhooks: - name required: - repository - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -228494,11 +229080,11 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - repository_ruleset: *126 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + repository_ruleset: *129 sender: *4 required: - action @@ -228576,11 +229162,11 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - repository_ruleset: *126 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + repository_ruleset: *129 sender: *4 required: - action @@ -228658,11 +229244,11 @@ webhooks: type: string enum: - edited - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - repository_ruleset: *126 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + repository_ruleset: *129 changes: type: object properties: @@ -228681,16 +229267,16 @@ webhooks: properties: added: type: array - items: *119 + items: *122 deleted: type: array - items: *119 + items: *122 updated: type: array items: type: object properties: - condition: *119 + condition: *122 changes: type: object properties: @@ -228723,16 +229309,16 @@ webhooks: properties: added: type: array - items: *125 + items: *128 deleted: type: array - items: *125 + items: *128 updated: type: array items: type: object properties: - rule: *125 + rule: *128 changes: type: object properties: @@ -228969,10 +229555,10 @@ webhooks: - from required: - owner - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -229050,10 +229636,10 @@ webhooks: type: string enum: - unarchived - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -229131,7 +229717,7 @@ webhooks: type: string enum: - create - alert: &825 + alert: &827 title: Repository Vulnerability Alert Alert description: The security alert of the vulnerable dependency. type: object @@ -229255,10 +229841,10 @@ webhooks: type: string enum: - open - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -229468,10 +230054,10 @@ webhooks: type: string enum: - dismissed - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -229549,11 +230135,11 @@ webhooks: type: string enum: - reopen - alert: *825 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + alert: *827 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -229755,10 +230341,10 @@ webhooks: enum: - fixed - open - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -229836,17 +230422,17 @@ webhooks: type: string enum: - created - alert: &826 + alert: &828 type: object properties: - number: *96 - created_at: *103 + number: *99 + created_at: *106 updated_at: anyOf: - type: 'null' - - *104 - url: *101 - html_url: *102 + - *107 + url: *104 + html_url: *105 locations_url: type: string format: uri @@ -229946,10 +230532,10 @@ webhooks: - 'null' description: Whether the detected secret was found in multiple repositories in the same organization or business. - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -230030,11 +230616,11 @@ webhooks: type: string enum: - created - alert: *826 - installation: *764 - location: *827 - organization: *765 - repository: *766 + alert: *828 + installation: *766 + location: *829 + organization: *767 + repository: *768 sender: *4 required: - location @@ -230272,11 +230858,11 @@ webhooks: type: string enum: - publicly_leaked - alert: *826 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + alert: *828 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -230354,11 +230940,11 @@ webhooks: type: string enum: - reopened - alert: *826 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + alert: *828 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -230436,11 +231022,11 @@ webhooks: type: string enum: - resolved - alert: *826 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + alert: *828 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -230518,11 +231104,11 @@ webhooks: type: string enum: - validated - alert: *826 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + alert: *828 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -230652,10 +231238,10 @@ webhooks: - organization - enterprise - - repository: *766 - enterprise: *763 - installation: *764 - organization: *765 + repository: *768 + enterprise: *765 + installation: *766 + organization: *767 sender: *4 required: - action @@ -230733,11 +231319,11 @@ webhooks: type: string enum: - published - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - security_advisory: &828 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + security_advisory: &830 description: The details of the security advisory, including summary, description, and severity. type: object @@ -230754,7 +231340,7 @@ webhooks: required: - vector_string - score - cvss_severities: *98 + cvss_severities: *101 cwes: type: array items: @@ -230923,11 +231509,11 @@ webhooks: type: string enum: - updated - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - security_advisory: *828 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + security_advisory: *830 sender: *4 required: - action @@ -231000,10 +231586,10 @@ webhooks: type: string enum: - withdrawn - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 security_advisory: description: The details of the security advisory, including summary, description, and severity. @@ -231021,7 +231607,7 @@ webhooks: required: - vector_string - score - cvss_severities: *98 + cvss_severities: *101 cwes: type: array items: @@ -231189,11 +231775,11 @@ webhooks: from: type: object properties: - security_and_analysis: *318 - enterprise: *763 - installation: *764 - organization: *765 - repository: *381 + security_and_analysis: *320 + enterprise: *765 + installation: *766 + organization: *767 + repository: *383 sender: *4 required: - changes @@ -231271,12 +231857,12 @@ webhooks: type: string enum: - cancelled - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 - sponsorship: &829 + sponsorship: &831 type: object properties: created_at: @@ -231581,12 +232167,12 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 - sponsorship: *829 + sponsorship: *831 required: - action - sponsorship @@ -231674,12 +232260,12 @@ webhooks: type: string required: - from - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 - sponsorship: *829 + sponsorship: *831 required: - action - changes @@ -231756,17 +232342,17 @@ webhooks: type: string enum: - pending_cancellation - effective_date: &830 + effective_date: &832 description: The `pending_cancellation` and `pending_tier_change` event types will include the date the cancellation or tier change will take effect. type: string - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 - sponsorship: *829 + sponsorship: *831 required: - action - sponsorship @@ -231840,7 +232426,7 @@ webhooks: type: string enum: - pending_tier_change - changes: &831 + changes: &833 type: object properties: tier: @@ -231884,13 +232470,13 @@ webhooks: - from required: - tier - effective_date: *830 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + effective_date: *832 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 - sponsorship: *829 + sponsorship: *831 required: - action - changes @@ -231967,13 +232553,13 @@ webhooks: type: string enum: - tier_changed - changes: *831 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + changes: *833 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 - sponsorship: *829 + sponsorship: *831 required: - action - changes @@ -232047,10 +232633,10 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 starred_at: description: 'The time the star was created. This is a timestamp @@ -232134,10 +232720,10 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 starred_at: description: 'The time the star was created. This is a timestamp @@ -232571,15 +233157,15 @@ webhooks: type: - string - 'null' - enterprise: *763 + enterprise: *765 id: description: The unique identifier of the status. type: integer - installation: *764 + installation: *766 name: type: string - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 sha: description: The Commit SHA. @@ -232689,15 +233275,15 @@ webhooks: parent_issue_id: description: The ID of the parent issue. type: number - parent_issue: *151 + parent_issue: *154 parent_issue_repo: *62 sub_issue_id: description: The ID of the sub-issue. type: number - sub_issue: *151 - installation: *764 - organization: *765 - repository: *766 + sub_issue: *154 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -232781,15 +233367,15 @@ webhooks: parent_issue_id: description: The ID of the parent issue. type: number - parent_issue: *151 + parent_issue: *154 parent_issue_repo: *62 sub_issue_id: description: The ID of the sub-issue. type: number - sub_issue: *151 - installation: *764 - organization: *765 - repository: *766 + sub_issue: *154 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -232873,15 +233459,15 @@ webhooks: sub_issue_id: description: The ID of the sub-issue. type: number - sub_issue: *151 + sub_issue: *154 sub_issue_repo: *62 parent_issue_id: description: The ID of the parent issue. type: number - parent_issue: *151 - installation: *764 - organization: *765 - repository: *766 + parent_issue: *154 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -232965,15 +233551,15 @@ webhooks: sub_issue_id: description: The ID of the sub-issue. type: number - sub_issue: *151 + sub_issue: *154 sub_issue_repo: *62 parent_issue_id: description: The ID of the parent issue. type: number - parent_issue: *151 - installation: *764 - organization: *765 - repository: *766 + parent_issue: *154 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -233050,12 +233636,12 @@ webhooks: title: team_add event type: object properties: - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 - team: &832 + team: &834 title: Team description: Groups of organization members that gives permissions on specified repositories. @@ -233248,9 +233834,9 @@ webhooks: type: string enum: - added_to_repository - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 repository: title: Repository description: A git repository @@ -233720,7 +234306,7 @@ webhooks: - topics - visibility sender: *4 - team: *832 + team: *834 required: - action - team @@ -233796,9 +234382,9 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 repository: title: Repository description: A git repository @@ -234268,7 +234854,7 @@ webhooks: - topics - visibility sender: *4 - team: *832 + team: *834 required: - action - team @@ -234345,9 +234931,9 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 repository: title: Repository description: A git repository @@ -234817,7 +235403,7 @@ webhooks: - topics - visibility sender: *4 - team: *832 + team: *834 required: - action - team @@ -234961,9 +235547,9 @@ webhooks: - from required: - permissions - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 repository: title: Repository description: A git repository @@ -235433,7 +236019,7 @@ webhooks: - topics - visibility sender: *4 - team: *832 + team: *834 required: - action - changes @@ -235511,9 +236097,9 @@ webhooks: type: string enum: - removed_from_repository - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 repository: title: Repository description: A git repository @@ -235983,7 +236569,7 @@ webhooks: - topics - visibility sender: *4 - team: *832 + team: *834 required: - action - team @@ -236059,10 +236645,10 @@ webhooks: type: string enum: - started - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -236135,17 +236721,17 @@ webhooks: title: workflow_dispatch event type: object properties: - enterprise: *763 + enterprise: *765 inputs: type: - object - 'null' additionalProperties: true - installation: *764 - organization: *765 + installation: *766 + organization: *767 ref: type: string - repository: *766 + repository: *768 sender: *4 workflow: type: string @@ -236227,10 +236813,10 @@ webhooks: type: string enum: - completed - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 workflow_job: allOf: @@ -236486,7 +237072,7 @@ webhooks: type: string required: - conclusion - deployment: *510 + deployment: *512 required: - action - repository @@ -236565,10 +237151,10 @@ webhooks: type: string enum: - in_progress - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 workflow_job: allOf: @@ -236850,7 +237436,7 @@ webhooks: required: - status - steps - deployment: *510 + deployment: *512 required: - action - repository @@ -236929,10 +237515,10 @@ webhooks: type: string enum: - queued - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 workflow_job: type: object @@ -237078,7 +237664,7 @@ webhooks: - workflow_name - head_branch - created_at - deployment: *510 + deployment: *512 required: - action - repository @@ -237157,10 +237743,10 @@ webhooks: type: string enum: - waiting - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 workflow_job: type: object @@ -237307,7 +237893,7 @@ webhooks: - workflow_name - head_branch - created_at - deployment: *510 + deployment: *512 required: - action - repository @@ -237387,12 +237973,12 @@ webhooks: type: string enum: - completed - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 - workflow: *785 + workflow: *787 workflow_run: title: Workflow Run type: object @@ -238411,12 +238997,12 @@ webhooks: type: string enum: - in_progress - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 - workflow: *785 + workflow: *787 workflow_run: title: Workflow Run type: object @@ -239420,12 +240006,12 @@ webhooks: type: string enum: - requested - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 - workflow: *785 + workflow: *787 workflow_run: title: Workflow Run type: object diff --git a/descriptions-next/ghec/dereferenced/ghec.deref.json b/descriptions-next/ghec/dereferenced/ghec.deref.json index c8b79ef1bc..8c848c42f1 100644 --- a/descriptions-next/ghec/dereferenced/ghec.deref.json +++ b/descriptions-next/ghec/dereferenced/ghec.deref.json @@ -5376,7 +5376,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -5410,6 +5410,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -6461,7 +6467,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -6495,6 +6501,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -7250,7 +7262,7 @@ }, "delete": { "summary": "Delete an installation for the authenticated app", - "description": "Uninstalls a GitHub App on a user, organization, or business account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the \"[Suspend an app installation](https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#suspend-an-app-installation)\" endpoint.\n\nYou must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", + "description": "Uninstalls a GitHub App on a user, organization, or enterprise account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the \"[Suspend an app installation](https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#suspend-an-app-installation)\" endpoint.\n\nYou must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", "tags": [ "apps" ], @@ -7317,7 +7329,7 @@ "/app/installations/{installation_id}/access_tokens": { "post": { "summary": "Create an installation access token for an app", - "description": "Creates an installation access token that enables a GitHub App to make authenticated API requests for the app's installation on an organization or individual account. Installation tokens expire one hour from the time you create them. Using an expired token produces a status code of `401 - Unauthorized`, and requires creating a new installation token. By default the installation token has access to all repositories that the installation can access.\n\nOptionally, you can use the `repositories` or `repository_ids` body parameters to specify individual repositories that the installation access token can access. If you don't use `repositories` or `repository_ids` to grant access to specific repositories, the installation access token will have access to all repositories that the installation was granted access to. The installation access token cannot be granted access to repositories that the installation was not granted access to. Up to 500 repositories can be listed in this manner.\n\nOptionally, use the `permissions` body parameter to specify the permissions that the installation access token should have. If `permissions` is not specified, the installation access token will have all of the permissions that were granted to the app. The installation access token cannot be granted permissions that the app was not granted.\n\nYou must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", + "description": "Creates an installation access token that enables a GitHub App to make authenticated API requests for the app's installation on an enterprise, organization, or individual account. Installation tokens expire one hour from the time you create them. Using an expired token produces a status code of `401 - Unauthorized`, and requires creating a new installation token. By default the installation token has access to all repositories that the installation can access.\n\nOptionally, you can use the `repositories` or `repository_ids` body parameters to specify individual repositories that the installation access token can access. If you don't use `repositories` or `repository_ids` to grant access to specific repositories, the installation access token will have access to all repositories that the installation was granted access to. The installation access token cannot be granted access to repositories that the installation was not granted access to. Up to 500 repositories can be listed in this manner.\n\nOptionally, use the `permissions` body parameter to specify the permissions that the installation access token should have. If `permissions` is not specified, the installation access token will have all of the permissions that were granted to the app. The installation access token cannot be granted permissions that the app was not granted.\n\nEnterprise account installations do not have access to repositories and cannot be scoped down using the `permissions` parameter.\n\nYou must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", "tags": [ "apps" ], @@ -7789,7 +7801,7 @@ "application/json": { "schema": { "title": "Installation Token", - "description": "Authentication token for a GitHub App installed on a user or org.", + "description": "Authentication token for a GitHub App installed on a user, org, or enterprise.", "type": "object", "properties": { "token": { @@ -9486,7 +9498,7 @@ "/app/installations/{installation_id}/suspended": { "put": { "summary": "Suspend an app installation", - "description": "Suspends a GitHub App on a user, organization, or business account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub Enterprise Cloud API or webhook events is blocked for that account.\n\nYou must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", + "description": "Suspends a GitHub App on a user, organization, or enterprise account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub Enterprise Cloud API or webhook events is blocked for that account.\n\nYou must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", "tags": [ "apps" ], @@ -27081,18 +27093,3366 @@ } } }, - "422": { - "description": "Validation failed, or the endpoint has been spammed.", + "422": { + "description": "Validation failed, or the endpoint has been spammed.", + "content": { + "application/json": { + "schema": { + "title": "Validation Error Simple", + "description": "Validation Error Simple", + "type": "object", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "errors": { + "type": "array", + "items": { + "type": "string" + } + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": false, + "category": "actions", + "subcategory": "self-hosted-runners" + } + } + }, + "/enterprises/{enterprise}/announcement": { + "get": { + "summary": "Get announcement banner for enterprise", + "description": "Gets the announcement banner currently set for the enterprise.", + "tags": [ + "enterprise-admin" + ], + "operationId": "announcement-banners/get-announcement-banner-for-enterprise", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/announcement-banners/enterprises#get-announcement-banner-for-enterprise" + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "title": "Announcement Banner", + "description": "Announcement at either the repository, organization, or enterprise level", + "type": "object", + "properties": { + "announcement": { + "type": [ + "string", + "null" + ], + "description": "The announcement text in GitHub Flavored Markdown. For more information about GitHub Flavored Markdown, see \"[Basic writing and formatting syntax](https://docs.github.com/enterprise-cloud@latest//github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax).\"", + "examples": [ + "Very **important** announcement about _something_." + ] + }, + "expires_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "The time at which the announcement expires. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`. To set an announcement that never expires, omit this parameter, set it to `null`, or set it to an empty string.", + "examples": [ + "\"2021-01-01T00:00:00.000-07:00\"" + ] + }, + "user_dismissible": { + "type": [ + "boolean", + "null" + ], + "description": "Whether an announcement can be dismissed by the user.", + "default": false, + "examples": [ + false + ] + } + }, + "required": [ + "announcement", + "expires_at", + "user_dismissible" + ] + }, + "examples": { + "default": { + "summary": "Announcement banner", + "value": { + "announcement": "Very **important** announcement about _something_.", + "expires_at": "2021-01-01T00:00:00.000+00:00", + "user_dismissible": false + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": false, + "category": "announcement-banners", + "subcategory": "enterprises" + } + }, + "patch": { + "summary": "Set announcement banner for enterprise", + "description": "Sets the announcement banner to display for the enterprise.", + "tags": [ + "enterprise-admin" + ], + "operationId": "announcement-banners/set-announcement-banner-for-enterprise", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/announcement-banners/enterprises#set-announcement-banner-for-enterprise" + }, + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "title": "Enterprise Announcement", + "description": "Enterprise global announcement", + "type": "object", + "properties": { + "announcement": { + "type": [ + "string", + "null" + ], + "description": "The announcement text in GitHub Flavored Markdown. For more information about GitHub Flavored Markdown, see \"[Basic writing and formatting syntax](https://docs.github.com/enterprise-cloud@latest//github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax).\"", + "examples": [ + "Very **important** announcement about _something_." + ] + }, + "expires_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "The time at which the announcement expires. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`. To set an announcement that never expires, omit this parameter, set it to `null`, or set it to an empty string.", + "examples": [ + "\"2021-01-01T00:00:00.000-07:00\"" + ] + }, + "user_dismissible": { + "type": [ + "boolean", + "null" + ], + "description": "Whether an announcement can be dismissed by the user.", + "default": false, + "examples": [ + false + ] + } + }, + "required": [ + "announcement" + ] + }, + "examples": { + "default": { + "summary": "Announcement banner", + "value": { + "announcement": "Very **important** announcement about _something_.", + "expires_at": "2021-01-01T00:00:00.000+00:00", + "user_dismissible": false + } + } + } + } + } + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "title": "Announcement Banner", + "description": "Announcement at either the repository, organization, or enterprise level", + "type": "object", + "properties": { + "announcement": { + "type": [ + "string", + "null" + ], + "description": "The announcement text in GitHub Flavored Markdown. For more information about GitHub Flavored Markdown, see \"[Basic writing and formatting syntax](https://docs.github.com/enterprise-cloud@latest//github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax).\"", + "examples": [ + "Very **important** announcement about _something_." + ] + }, + "expires_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "The time at which the announcement expires. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`. To set an announcement that never expires, omit this parameter, set it to `null`, or set it to an empty string.", + "examples": [ + "\"2021-01-01T00:00:00.000-07:00\"" + ] + }, + "user_dismissible": { + "type": [ + "boolean", + "null" + ], + "description": "Whether an announcement can be dismissed by the user.", + "default": false, + "examples": [ + false + ] + } + }, + "required": [ + "announcement", + "expires_at", + "user_dismissible" + ] + }, + "examples": { + "default": { + "summary": "Announcement banner", + "value": { + "announcement": "Very **important** announcement about _something_.", + "expires_at": "2021-01-01T00:00:00.000+00:00", + "user_dismissible": false + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": false, + "category": "announcement-banners", + "subcategory": "enterprises" + } + }, + "delete": { + "summary": "Remove announcement banner from enterprise", + "description": "Removes the announcement banner currently set for the enterprise.", + "tags": [ + "enterprise-admin" + ], + "operationId": "announcement-banners/remove-announcement-banner-for-enterprise", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/announcement-banners/enterprises#remove-announcement-banner-from-enterprise" + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "204": { + "description": "Response" + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": false, + "category": "announcement-banners", + "subcategory": "enterprises" + } + } + }, + "/enterprises/{enterprise}/apps/installable_organizations": { + "get": { + "summary": "Get enterprise-owned organizations that can have GitHub Apps installed", + "description": "List the organizations owned by the enterprise, intended for use by GitHub Apps that are managing applications across the enterprise.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/installable-organizations", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#get-enterprise-owned-organizations-that-can-have-github-apps-installed" + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "per_page", + "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api).\"", + "in": "query", + "schema": { + "type": "integer", + "default": 30 + } + }, + { + "name": "page", + "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api).\"", + "in": "query", + "schema": { + "type": "integer", + "default": 1 + } + } + ], + "responses": { + "200": { + "description": "A list of organizations owned by the enterprise on which the authenticated GitHub App is installed.", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "title": "Installable Organization", + "description": "A GitHub organization on which a GitHub App can be installed.", + "type": "object", + "properties": { + "id": { + "type": "integer", + "examples": [ + 1 + ] + }, + "login": { + "type": "string", + "examples": [ + "github" + ] + }, + "accessible_repositories_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/enterprises/biz-name/apps/organizations/org-login/accessible_repositories" + ] + } + }, + "required": [ + "id", + "login" + ] + } + }, + "examples": { + "default": { + "value": [ + { + "id": 1, + "login": "github" + }, + { + "id": 2, + "login": "microsoft" + } + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + } + }, + "/enterprises/{enterprise}/apps/installable_organizations/{org}/accessible_repositories": { + "get": { + "summary": "Get repositories belonging to an enterprise-owned organization", + "description": "List the repositories belonging to an enterprise-owned organization that can be made accessible to a GitHub App installed on that organization. This API provides a shallow list of repositories in the organization, allowing the caller to then add or remove those repositories to an installation in that organization.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/installable-organization-accessible-repositories", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#get-repositories-belonging-to-an-enterprise-owned-organization" + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "per_page", + "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api).\"", + "in": "query", + "schema": { + "type": "integer", + "default": 30 + } + }, + { + "name": "page", + "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api).\"", + "in": "query", + "schema": { + "type": "integer", + "default": 1 + } + } + ], + "responses": { + "200": { + "description": "A list of repositories owned by the enterprise organization on which the authenticated GitHub App is installed.", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "title": "Accessible Repository", + "description": "A repository that may be made accessible to a GitHub App.", + "type": "object", + "properties": { + "id": { + "description": "Unique identifier of the repository", + "type": "integer", + "format": "int64", + "examples": [ + 1 + ] + }, + "name": { + "description": "The name of the repository.", + "type": "string", + "examples": [ + "Team Environment" + ] + }, + "full_name": { + "type": "string", + "examples": [ + "octocat/Hello-World" + ] + } + }, + "required": [ + "full_name", + "id", + "name" + ] + } + }, + "examples": { + "default": { + "value": [ + { + "id": 1, + "name": "Hello World", + "full_name": "octocat/Hello-World" + }, + { + "id": 2, + "login": "Goodbye World", + "full_name": "octocat/Goodbye-World" + } + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + } + }, + "/enterprises/{enterprise}/apps/organizations/{org}/installations": { + "get": { + "summary": "List GitHub Apps installed on an enterprise-owned organization", + "description": "Lists the GitHub App installations associated with the given enterprise-owned organization. This lists all GitHub Apps that have been installed on the organization, regardless of who owns the application.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/organization-installations", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#list-github-apps-installed-on-an-enterprise-owned-organization" + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "per_page", + "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api).\"", + "in": "query", + "schema": { + "type": "integer", + "default": 30 + } + }, + { + "name": "page", + "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api).\"", + "in": "query", + "schema": { + "type": "integer", + "default": 1 + } + } + ], + "responses": { + "200": { + "description": "A list of GitHub App installations that have been granted access to the organization", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "title": "Enterprise Organization Installation", + "description": "A GitHub App Installation on an enterprise-owned organization", + "type": "object", + "properties": { + "id": { + "description": "The ID of the installation.", + "type": "integer", + "examples": [ + 1 + ] + }, + "app_slug": { + "type": "string", + "examples": [ + "github/github-actions" + ] + }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, + "repository_selection": { + "description": "Describe whether all repositories have been selected or there's a selection involved", + "type": "string", + "enum": [ + "all", + "selected" + ] + }, + "repositories_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/enterprises/acme-corp/apps/organizations/some-org/installations/1/repositories" + ] + }, + "permissions": { + "title": "App Permissions", + "type": "object", + "description": "The permissions granted to the user access token.", + "properties": { + "actions": { + "type": "string", + "description": "The level of permission to grant the access token for GitHub Actions workflows, workflow runs, and artifacts.", + "enum": [ + "read", + "write" + ] + }, + "administration": { + "type": "string", + "description": "The level of permission to grant the access token for repository creation, deletion, settings, teams, and collaborators creation.", + "enum": [ + "read", + "write" + ] + }, + "checks": { + "type": "string", + "description": "The level of permission to grant the access token for checks on code.", + "enum": [ + "read", + "write" + ] + }, + "codespaces": { + "type": "string", + "description": "The level of permission to grant the access token to create, edit, delete, and list Codespaces.", + "enum": [ + "read", + "write" + ] + }, + "contents": { + "type": "string", + "description": "The level of permission to grant the access token for repository contents, commits, branches, downloads, releases, and merges.", + "enum": [ + "read", + "write" + ] + }, + "dependabot_secrets": { + "type": "string", + "description": "The level of permission to grant the access token to manage Dependabot secrets.", + "enum": [ + "read", + "write" + ] + }, + "deployments": { + "type": "string", + "description": "The level of permission to grant the access token for deployments and deployment statuses.", + "enum": [ + "read", + "write" + ] + }, + "environments": { + "type": "string", + "description": "The level of permission to grant the access token for managing repository environments.", + "enum": [ + "read", + "write" + ] + }, + "issues": { + "type": "string", + "description": "The level of permission to grant the access token for issues and related comments, assignees, labels, and milestones.", + "enum": [ + "read", + "write" + ] + }, + "metadata": { + "type": "string", + "description": "The level of permission to grant the access token to search repositories, list collaborators, and access repository metadata.", + "enum": [ + "read", + "write" + ] + }, + "packages": { + "type": "string", + "description": "The level of permission to grant the access token for packages published to GitHub Packages.", + "enum": [ + "read", + "write" + ] + }, + "pages": { + "type": "string", + "description": "The level of permission to grant the access token to retrieve Pages statuses, configuration, and builds, as well as create new builds.", + "enum": [ + "read", + "write" + ] + }, + "pull_requests": { + "type": "string", + "description": "The level of permission to grant the access token for pull requests and related comments, assignees, labels, milestones, and merges.", + "enum": [ + "read", + "write" + ] + }, + "repository_custom_properties": { + "type": "string", + "description": "The level of permission to grant the access token to view and edit custom properties for a repository, when allowed by the property.", + "enum": [ + "read", + "write" + ] + }, + "repository_hooks": { + "type": "string", + "description": "The level of permission to grant the access token to manage the post-receive hooks for a repository.", + "enum": [ + "read", + "write" + ] + }, + "repository_projects": { + "type": "string", + "description": "The level of permission to grant the access token to manage repository projects, columns, and cards.", + "enum": [ + "read", + "write", + "admin" + ] + }, + "secret_scanning_alerts": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage secret scanning alerts.", + "enum": [ + "read", + "write" + ] + }, + "secrets": { + "type": "string", + "description": "The level of permission to grant the access token to manage repository secrets.", + "enum": [ + "read", + "write" + ] + }, + "security_events": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage security events like code scanning alerts.", + "enum": [ + "read", + "write" + ] + }, + "single_file": { + "type": "string", + "description": "The level of permission to grant the access token to manage just a single file.", + "enum": [ + "read", + "write" + ] + }, + "statuses": { + "type": "string", + "description": "The level of permission to grant the access token for commit statuses.", + "enum": [ + "read", + "write" + ] + }, + "vulnerability_alerts": { + "type": "string", + "description": "The level of permission to grant the access token to manage Dependabot alerts.", + "enum": [ + "read", + "write" + ] + }, + "workflows": { + "type": "string", + "description": "The level of permission to grant the access token to update GitHub Actions workflow files.", + "enum": [ + "write" + ] + }, + "members": { + "type": "string", + "description": "The level of permission to grant the access token for organization teams and members.", + "enum": [ + "read", + "write" + ] + }, + "organization_administration": { + "type": "string", + "description": "The level of permission to grant the access token to manage access to an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_custom_roles": { + "type": "string", + "description": "The level of permission to grant the access token for custom repository roles management.", + "enum": [ + "read", + "write" + ] + }, + "organization_custom_org_roles": { + "type": "string", + "description": "The level of permission to grant the access token for custom organization roles management.", + "enum": [ + "read", + "write" + ] + }, + "organization_custom_properties": { + "type": "string", + "description": "The level of permission to grant the access token for custom property management.", + "enum": [ + "read", + "write", + "admin" + ] + }, + "organization_copilot_seat_management": { + "type": "string", + "description": "The level of permission to grant the access token for managing access to GitHub Copilot for members of an organization with a Copilot Business subscription. This property is in public preview and is subject to change.", + "enum": [ + "write" + ] + }, + "organization_announcement_banners": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage announcement banners for an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_events": { + "type": "string", + "description": "The level of permission to grant the access token to view events triggered by an activity in an organization.", + "enum": [ + "read" + ] + }, + "organization_hooks": { + "type": "string", + "description": "The level of permission to grant the access token to manage the post-receive hooks for an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_personal_access_tokens": { + "type": "string", + "description": "The level of permission to grant the access token for viewing and managing fine-grained personal access token requests to an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_personal_access_token_requests": { + "type": "string", + "description": "The level of permission to grant the access token for viewing and managing fine-grained personal access tokens that have been approved by an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_plan": { + "type": "string", + "description": "The level of permission to grant the access token for viewing an organization's plan.", + "enum": [ + "read" + ] + }, + "organization_projects": { + "type": "string", + "description": "The level of permission to grant the access token to manage organization projects and projects public preview (where available).", + "enum": [ + "read", + "write", + "admin" + ] + }, + "organization_packages": { + "type": "string", + "description": "The level of permission to grant the access token for organization packages published to GitHub Packages.", + "enum": [ + "read", + "write" + ] + }, + "organization_secrets": { + "type": "string", + "description": "The level of permission to grant the access token to manage organization secrets.", + "enum": [ + "read", + "write" + ] + }, + "organization_self_hosted_runners": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage GitHub Actions self-hosted runners available to an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_user_blocking": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage users blocked by the organization.", + "enum": [ + "read", + "write" + ] + }, + "team_discussions": { + "type": "string", + "description": "The level of permission to grant the access token to manage team discussions and related comments.", + "enum": [ + "read", + "write" + ] + }, + "email_addresses": { + "type": "string", + "description": "The level of permission to grant the access token to manage the email addresses belonging to a user.", + "enum": [ + "read", + "write" + ] + }, + "followers": { + "type": "string", + "description": "The level of permission to grant the access token to manage the followers belonging to a user.", + "enum": [ + "read", + "write" + ] + }, + "git_ssh_keys": { + "type": "string", + "description": "The level of permission to grant the access token to manage git SSH keys.", + "enum": [ + "read", + "write" + ] + }, + "gpg_keys": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage GPG keys belonging to a user.", + "enum": [ + "read", + "write" + ] + }, + "interaction_limits": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage interaction limits on a repository.", + "enum": [ + "read", + "write" + ] + }, + "profile": { + "type": "string", + "description": "The level of permission to grant the access token to manage the profile settings belonging to a user.", + "enum": [ + "write" + ] + }, + "starring": { + "type": "string", + "description": "The level of permission to grant the access token to list and manage repositories a user is starring.", + "enum": [ + "read", + "write" + ] + } + }, + "example": { + "contents": "read", + "issues": "read", + "deployments": "write", + "single_file": "read" + } + }, + "events": { + "type": "array", + "items": { + "type": "string" + } + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" + } + }, + "required": [ + "id", + "client_id", + "repository_selection", + "repositories_url", + "permissions", + "created_at", + "updated_at" + ] + } + }, + "examples": { + "default": { + "value": [ + { + "value": { + "id": 1, + "app_slug": "monalisa/orbit", + "repository_selection": "selected", + "repositories_url": "https://api.github.com/enterprises/acme-corp/apps/organizations/some-org/installations/1/repositories", + "permissions": { + "checks": "write", + "metadata": "read", + "contents": "read" + }, + "events": [ + "push", + "pull_request" + ], + "created_at": "2017-07-08T16:18:44-04:00", + "updated_at": "2017-07-08T16:18:44-04:00" + } + } + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + }, + "post": { + "summary": "Install a GitHub App on an enterprise-owned organization", + "description": "Installs any valid GitHub App on the specified organization owned by the enterprise. If the app is already installed on the organization, and is suspended, it will be unsuspended.\nIf the app has a pending installation request, they will all be approved.\n\nIf the app is already installed and has a pending update request, it will be updated to the latest version. If the app is now requesting repository permissions, it will be given access to the repositories listed in the request or fail if no `repository_selection` is provided.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/create-installation", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#install-a-github-app-on-an-enterprise-owned-organization" + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "A GitHub App installation that was installed previously.", + "content": { + "application/json": { + "schema": { + "title": "Installation", + "description": "Installation", + "type": "object", + "properties": { + "id": { + "description": "The ID of the installation.", + "type": "integer", + "examples": [ + 1 + ] + }, + "account": { + "anyOf": [ + { + "title": "Simple User", + "description": "A GitHub user.", + "type": "object", + "properties": { + "name": { + "type": [ + "string", + "null" + ] + }, + "email": { + "type": [ + "string", + "null" + ] + }, + "login": { + "type": "string", + "examples": [ + "octocat" + ] + }, + "id": { + "type": "integer", + "format": "int64", + "examples": [ + 1 + ] + }, + "node_id": { + "type": "string", + "examples": [ + "MDQ6VXNlcjE=" + ] + }, + "avatar_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/images/error/octocat_happy.gif" + ] + }, + "gravatar_id": { + "type": [ + "string", + "null" + ], + "examples": [ + "41d064eb2195891e12d0413f63227ea7" + ] + }, + "url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat" + ] + }, + "html_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/octocat" + ] + }, + "followers_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/followers" + ] + }, + "following_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/following{/other_user}" + ] + }, + "gists_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/gists{/gist_id}" + ] + }, + "starred_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/starred{/owner}{/repo}" + ] + }, + "subscriptions_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/subscriptions" + ] + }, + "organizations_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/orgs" + ] + }, + "repos_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/repos" + ] + }, + "events_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/events{/privacy}" + ] + }, + "received_events_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/received_events" + ] + }, + "type": { + "type": "string", + "examples": [ + "User" + ] + }, + "site_admin": { + "type": "boolean" + }, + "starred_at": { + "type": "string", + "examples": [ + "\"2020-07-09T00:17:55Z\"" + ] + }, + "user_view_type": { + "type": "string", + "examples": [ + "public" + ] + } + }, + "required": [ + "avatar_url", + "events_url", + "followers_url", + "following_url", + "gists_url", + "gravatar_id", + "html_url", + "id", + "node_id", + "login", + "organizations_url", + "received_events_url", + "repos_url", + "site_admin", + "starred_url", + "subscriptions_url", + "type", + "url" + ] + }, + { + "title": "Enterprise", + "description": "An enterprise on GitHub.", + "type": "object", + "properties": { + "description": { + "description": "A short description of the enterprise.", + "type": [ + "string", + "null" + ] + }, + "html_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/enterprises/octo-business" + ] + }, + "website_url": { + "description": "The enterprise's website URL.", + "type": [ + "string", + "null" + ], + "format": "uri" + }, + "id": { + "description": "Unique identifier of the enterprise", + "type": "integer", + "examples": [ + 42 + ] + }, + "node_id": { + "type": "string", + "examples": [ + "MDEwOlJlcG9zaXRvcnkxMjk2MjY5" + ] + }, + "name": { + "description": "The name of the enterprise.", + "type": "string", + "examples": [ + "Octo Business" + ] + }, + "slug": { + "description": "The slug url identifier for the enterprise.", + "type": "string", + "examples": [ + "octo-business" + ] + }, + "created_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "examples": [ + "2019-01-26T19:01:12Z" + ] + }, + "updated_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "examples": [ + "2019-01-26T19:14:43Z" + ] + }, + "avatar_url": { + "type": "string", + "format": "uri" + } + }, + "required": [ + "id", + "node_id", + "name", + "slug", + "html_url", + "created_at", + "updated_at", + "avatar_url" + ] + } + ], + "type": [ + "null", + "object" + ] + }, + "repository_selection": { + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", + "type": "string", + "enum": [ + "all", + "selected" + ] + }, + "access_tokens_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/app/installations/1/access_tokens" + ] + }, + "repositories_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/installation/repositories" + ] + }, + "html_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/organizations/github/settings/installations/1" + ] + }, + "app_id": { + "type": "integer", + "examples": [ + 1 + ] + }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, + "target_id": { + "description": "The ID of the user or organization this token is being scoped to.", + "type": "integer" + }, + "target_type": { + "type": "string", + "examples": [ + "Organization" + ] + }, + "permissions": { + "title": "App Permissions", + "type": "object", + "description": "The permissions granted to the user access token.", + "properties": { + "actions": { + "type": "string", + "description": "The level of permission to grant the access token for GitHub Actions workflows, workflow runs, and artifacts.", + "enum": [ + "read", + "write" + ] + }, + "administration": { + "type": "string", + "description": "The level of permission to grant the access token for repository creation, deletion, settings, teams, and collaborators creation.", + "enum": [ + "read", + "write" + ] + }, + "checks": { + "type": "string", + "description": "The level of permission to grant the access token for checks on code.", + "enum": [ + "read", + "write" + ] + }, + "codespaces": { + "type": "string", + "description": "The level of permission to grant the access token to create, edit, delete, and list Codespaces.", + "enum": [ + "read", + "write" + ] + }, + "contents": { + "type": "string", + "description": "The level of permission to grant the access token for repository contents, commits, branches, downloads, releases, and merges.", + "enum": [ + "read", + "write" + ] + }, + "dependabot_secrets": { + "type": "string", + "description": "The level of permission to grant the access token to manage Dependabot secrets.", + "enum": [ + "read", + "write" + ] + }, + "deployments": { + "type": "string", + "description": "The level of permission to grant the access token for deployments and deployment statuses.", + "enum": [ + "read", + "write" + ] + }, + "environments": { + "type": "string", + "description": "The level of permission to grant the access token for managing repository environments.", + "enum": [ + "read", + "write" + ] + }, + "issues": { + "type": "string", + "description": "The level of permission to grant the access token for issues and related comments, assignees, labels, and milestones.", + "enum": [ + "read", + "write" + ] + }, + "metadata": { + "type": "string", + "description": "The level of permission to grant the access token to search repositories, list collaborators, and access repository metadata.", + "enum": [ + "read", + "write" + ] + }, + "packages": { + "type": "string", + "description": "The level of permission to grant the access token for packages published to GitHub Packages.", + "enum": [ + "read", + "write" + ] + }, + "pages": { + "type": "string", + "description": "The level of permission to grant the access token to retrieve Pages statuses, configuration, and builds, as well as create new builds.", + "enum": [ + "read", + "write" + ] + }, + "pull_requests": { + "type": "string", + "description": "The level of permission to grant the access token for pull requests and related comments, assignees, labels, milestones, and merges.", + "enum": [ + "read", + "write" + ] + }, + "repository_custom_properties": { + "type": "string", + "description": "The level of permission to grant the access token to view and edit custom properties for a repository, when allowed by the property.", + "enum": [ + "read", + "write" + ] + }, + "repository_hooks": { + "type": "string", + "description": "The level of permission to grant the access token to manage the post-receive hooks for a repository.", + "enum": [ + "read", + "write" + ] + }, + "repository_projects": { + "type": "string", + "description": "The level of permission to grant the access token to manage repository projects, columns, and cards.", + "enum": [ + "read", + "write", + "admin" + ] + }, + "secret_scanning_alerts": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage secret scanning alerts.", + "enum": [ + "read", + "write" + ] + }, + "secrets": { + "type": "string", + "description": "The level of permission to grant the access token to manage repository secrets.", + "enum": [ + "read", + "write" + ] + }, + "security_events": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage security events like code scanning alerts.", + "enum": [ + "read", + "write" + ] + }, + "single_file": { + "type": "string", + "description": "The level of permission to grant the access token to manage just a single file.", + "enum": [ + "read", + "write" + ] + }, + "statuses": { + "type": "string", + "description": "The level of permission to grant the access token for commit statuses.", + "enum": [ + "read", + "write" + ] + }, + "vulnerability_alerts": { + "type": "string", + "description": "The level of permission to grant the access token to manage Dependabot alerts.", + "enum": [ + "read", + "write" + ] + }, + "workflows": { + "type": "string", + "description": "The level of permission to grant the access token to update GitHub Actions workflow files.", + "enum": [ + "write" + ] + }, + "members": { + "type": "string", + "description": "The level of permission to grant the access token for organization teams and members.", + "enum": [ + "read", + "write" + ] + }, + "organization_administration": { + "type": "string", + "description": "The level of permission to grant the access token to manage access to an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_custom_roles": { + "type": "string", + "description": "The level of permission to grant the access token for custom repository roles management.", + "enum": [ + "read", + "write" + ] + }, + "organization_custom_org_roles": { + "type": "string", + "description": "The level of permission to grant the access token for custom organization roles management.", + "enum": [ + "read", + "write" + ] + }, + "organization_custom_properties": { + "type": "string", + "description": "The level of permission to grant the access token for custom property management.", + "enum": [ + "read", + "write", + "admin" + ] + }, + "organization_copilot_seat_management": { + "type": "string", + "description": "The level of permission to grant the access token for managing access to GitHub Copilot for members of an organization with a Copilot Business subscription. This property is in public preview and is subject to change.", + "enum": [ + "write" + ] + }, + "organization_announcement_banners": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage announcement banners for an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_events": { + "type": "string", + "description": "The level of permission to grant the access token to view events triggered by an activity in an organization.", + "enum": [ + "read" + ] + }, + "organization_hooks": { + "type": "string", + "description": "The level of permission to grant the access token to manage the post-receive hooks for an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_personal_access_tokens": { + "type": "string", + "description": "The level of permission to grant the access token for viewing and managing fine-grained personal access token requests to an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_personal_access_token_requests": { + "type": "string", + "description": "The level of permission to grant the access token for viewing and managing fine-grained personal access tokens that have been approved by an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_plan": { + "type": "string", + "description": "The level of permission to grant the access token for viewing an organization's plan.", + "enum": [ + "read" + ] + }, + "organization_projects": { + "type": "string", + "description": "The level of permission to grant the access token to manage organization projects and projects public preview (where available).", + "enum": [ + "read", + "write", + "admin" + ] + }, + "organization_packages": { + "type": "string", + "description": "The level of permission to grant the access token for organization packages published to GitHub Packages.", + "enum": [ + "read", + "write" + ] + }, + "organization_secrets": { + "type": "string", + "description": "The level of permission to grant the access token to manage organization secrets.", + "enum": [ + "read", + "write" + ] + }, + "organization_self_hosted_runners": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage GitHub Actions self-hosted runners available to an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_user_blocking": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage users blocked by the organization.", + "enum": [ + "read", + "write" + ] + }, + "team_discussions": { + "type": "string", + "description": "The level of permission to grant the access token to manage team discussions and related comments.", + "enum": [ + "read", + "write" + ] + }, + "email_addresses": { + "type": "string", + "description": "The level of permission to grant the access token to manage the email addresses belonging to a user.", + "enum": [ + "read", + "write" + ] + }, + "followers": { + "type": "string", + "description": "The level of permission to grant the access token to manage the followers belonging to a user.", + "enum": [ + "read", + "write" + ] + }, + "git_ssh_keys": { + "type": "string", + "description": "The level of permission to grant the access token to manage git SSH keys.", + "enum": [ + "read", + "write" + ] + }, + "gpg_keys": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage GPG keys belonging to a user.", + "enum": [ + "read", + "write" + ] + }, + "interaction_limits": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage interaction limits on a repository.", + "enum": [ + "read", + "write" + ] + }, + "profile": { + "type": "string", + "description": "The level of permission to grant the access token to manage the profile settings belonging to a user.", + "enum": [ + "write" + ] + }, + "starring": { + "type": "string", + "description": "The level of permission to grant the access token to list and manage repositories a user is starring.", + "enum": [ + "read", + "write" + ] + } + }, + "example": { + "contents": "read", + "issues": "read", + "deployments": "write", + "single_file": "read" + } + }, + "events": { + "type": "array", + "items": { + "type": "string" + } + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" + }, + "single_file_name": { + "type": [ + "string", + "null" + ], + "examples": [ + "config.yaml" + ] + }, + "has_multiple_single_files": { + "type": "boolean", + "examples": [ + true + ] + }, + "single_file_paths": { + "type": "array", + "items": { + "type": "string" + }, + "examples": [ + "config.yml", + ".github/issue_TEMPLATE.md" + ] + }, + "app_slug": { + "type": "string", + "examples": [ + "github-actions" + ] + }, + "suspended_by": { + "anyOf": [ + { + "type": "null" + }, + { + "title": "Simple User", + "description": "A GitHub user.", + "type": "object", + "properties": { + "name": { + "type": [ + "string", + "null" + ] + }, + "email": { + "type": [ + "string", + "null" + ] + }, + "login": { + "type": "string", + "examples": [ + "octocat" + ] + }, + "id": { + "type": "integer", + "format": "int64", + "examples": [ + 1 + ] + }, + "node_id": { + "type": "string", + "examples": [ + "MDQ6VXNlcjE=" + ] + }, + "avatar_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/images/error/octocat_happy.gif" + ] + }, + "gravatar_id": { + "type": [ + "string", + "null" + ], + "examples": [ + "41d064eb2195891e12d0413f63227ea7" + ] + }, + "url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat" + ] + }, + "html_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/octocat" + ] + }, + "followers_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/followers" + ] + }, + "following_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/following{/other_user}" + ] + }, + "gists_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/gists{/gist_id}" + ] + }, + "starred_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/starred{/owner}{/repo}" + ] + }, + "subscriptions_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/subscriptions" + ] + }, + "organizations_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/orgs" + ] + }, + "repos_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/repos" + ] + }, + "events_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/events{/privacy}" + ] + }, + "received_events_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/received_events" + ] + }, + "type": { + "type": "string", + "examples": [ + "User" + ] + }, + "site_admin": { + "type": "boolean" + }, + "starred_at": { + "type": "string", + "examples": [ + "\"2020-07-09T00:17:55Z\"" + ] + }, + "user_view_type": { + "type": "string", + "examples": [ + "public" + ] + } + }, + "required": [ + "avatar_url", + "events_url", + "followers_url", + "following_url", + "gists_url", + "gravatar_id", + "html_url", + "id", + "node_id", + "login", + "organizations_url", + "received_events_url", + "repos_url", + "site_admin", + "starred_url", + "subscriptions_url", + "type", + "url" + ] + } + ] + }, + "suspended_at": { + "type": [ + "string", + "null" + ], + "format": "date-time" + }, + "contact_email": { + "type": [ + "string", + "null" + ], + "examples": [ + "\"test_13f1e99741e3e004@d7e1eb0bc0a1ba12.com\"" + ] + } + }, + "required": [ + "id", + "app_id", + "app_slug", + "target_id", + "target_type", + "single_file_name", + "repository_selection", + "access_tokens_url", + "html_url", + "repositories_url", + "events", + "account", + "permissions", + "created_at", + "updated_at", + "suspended_by", + "suspended_at" + ] + }, + "examples": { + "default": { + "value": { + "id": 1, + "account": { + "login": "octocat", + "id": 1, + "node_id": "MDQ6VXNlcjE=", + "avatar_url": "https://github.com/images/error/octocat_happy.gif", + "gravatar_id": "", + "url": "https://api.github.com/users/octocat", + "html_url": "https://github.com/octocat", + "followers_url": "https://api.github.com/users/octocat/followers", + "following_url": "https://api.github.com/users/octocat/following{/other_user}", + "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", + "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", + "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", + "organizations_url": "https://api.github.com/users/octocat/orgs", + "repos_url": "https://api.github.com/users/octocat/repos", + "events_url": "https://api.github.com/users/octocat/events{/privacy}", + "received_events_url": "https://api.github.com/users/octocat/received_events", + "type": "User", + "site_admin": false + }, + "access_tokens_url": "https://api.github.com/app/installations/1/access_tokens", + "repositories_url": "https://api.github.com/installation/repositories", + "html_url": "https://github.com/organizations/github/settings/installations/1", + "app_id": 1, + "target_id": 1, + "target_type": "Organization", + "permissions": { + "checks": "write", + "metadata": "read", + "contents": "read" + }, + "events": [ + "push", + "pull_request" + ], + "single_file_name": "config.yaml", + "has_multiple_single_files": true, + "single_file_paths": [ + "config.yml", + ".github/issue_TEMPLATE.md" + ], + "repository_selection": "selected", + "created_at": "2017-07-08T16:18:44-04:00", + "updated_at": "2017-07-08T16:18:44-04:00", + "app_slug": "github-actions", + "suspended_at": null, + "suspended_by": null + } + } + } + } + } + }, + "201": { + "description": "A GitHub App installation.", + "content": { + "application/json": { + "schema": { + "title": "Installation", + "description": "Installation", + "type": "object", + "properties": { + "id": { + "description": "The ID of the installation.", + "type": "integer", + "examples": [ + 1 + ] + }, + "account": { + "anyOf": [ + { + "title": "Simple User", + "description": "A GitHub user.", + "type": "object", + "properties": { + "name": { + "type": [ + "string", + "null" + ] + }, + "email": { + "type": [ + "string", + "null" + ] + }, + "login": { + "type": "string", + "examples": [ + "octocat" + ] + }, + "id": { + "type": "integer", + "format": "int64", + "examples": [ + 1 + ] + }, + "node_id": { + "type": "string", + "examples": [ + "MDQ6VXNlcjE=" + ] + }, + "avatar_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/images/error/octocat_happy.gif" + ] + }, + "gravatar_id": { + "type": [ + "string", + "null" + ], + "examples": [ + "41d064eb2195891e12d0413f63227ea7" + ] + }, + "url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat" + ] + }, + "html_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/octocat" + ] + }, + "followers_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/followers" + ] + }, + "following_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/following{/other_user}" + ] + }, + "gists_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/gists{/gist_id}" + ] + }, + "starred_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/starred{/owner}{/repo}" + ] + }, + "subscriptions_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/subscriptions" + ] + }, + "organizations_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/orgs" + ] + }, + "repos_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/repos" + ] + }, + "events_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/events{/privacy}" + ] + }, + "received_events_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/received_events" + ] + }, + "type": { + "type": "string", + "examples": [ + "User" + ] + }, + "site_admin": { + "type": "boolean" + }, + "starred_at": { + "type": "string", + "examples": [ + "\"2020-07-09T00:17:55Z\"" + ] + }, + "user_view_type": { + "type": "string", + "examples": [ + "public" + ] + } + }, + "required": [ + "avatar_url", + "events_url", + "followers_url", + "following_url", + "gists_url", + "gravatar_id", + "html_url", + "id", + "node_id", + "login", + "organizations_url", + "received_events_url", + "repos_url", + "site_admin", + "starred_url", + "subscriptions_url", + "type", + "url" + ] + }, + { + "title": "Enterprise", + "description": "An enterprise on GitHub.", + "type": "object", + "properties": { + "description": { + "description": "A short description of the enterprise.", + "type": [ + "string", + "null" + ] + }, + "html_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/enterprises/octo-business" + ] + }, + "website_url": { + "description": "The enterprise's website URL.", + "type": [ + "string", + "null" + ], + "format": "uri" + }, + "id": { + "description": "Unique identifier of the enterprise", + "type": "integer", + "examples": [ + 42 + ] + }, + "node_id": { + "type": "string", + "examples": [ + "MDEwOlJlcG9zaXRvcnkxMjk2MjY5" + ] + }, + "name": { + "description": "The name of the enterprise.", + "type": "string", + "examples": [ + "Octo Business" + ] + }, + "slug": { + "description": "The slug url identifier for the enterprise.", + "type": "string", + "examples": [ + "octo-business" + ] + }, + "created_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "examples": [ + "2019-01-26T19:01:12Z" + ] + }, + "updated_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "examples": [ + "2019-01-26T19:14:43Z" + ] + }, + "avatar_url": { + "type": "string", + "format": "uri" + } + }, + "required": [ + "id", + "node_id", + "name", + "slug", + "html_url", + "created_at", + "updated_at", + "avatar_url" + ] + } + ], + "type": [ + "null", + "object" + ] + }, + "repository_selection": { + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", + "type": "string", + "enum": [ + "all", + "selected" + ] + }, + "access_tokens_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/app/installations/1/access_tokens" + ] + }, + "repositories_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/installation/repositories" + ] + }, + "html_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/organizations/github/settings/installations/1" + ] + }, + "app_id": { + "type": "integer", + "examples": [ + 1 + ] + }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, + "target_id": { + "description": "The ID of the user or organization this token is being scoped to.", + "type": "integer" + }, + "target_type": { + "type": "string", + "examples": [ + "Organization" + ] + }, + "permissions": { + "title": "App Permissions", + "type": "object", + "description": "The permissions granted to the user access token.", + "properties": { + "actions": { + "type": "string", + "description": "The level of permission to grant the access token for GitHub Actions workflows, workflow runs, and artifacts.", + "enum": [ + "read", + "write" + ] + }, + "administration": { + "type": "string", + "description": "The level of permission to grant the access token for repository creation, deletion, settings, teams, and collaborators creation.", + "enum": [ + "read", + "write" + ] + }, + "checks": { + "type": "string", + "description": "The level of permission to grant the access token for checks on code.", + "enum": [ + "read", + "write" + ] + }, + "codespaces": { + "type": "string", + "description": "The level of permission to grant the access token to create, edit, delete, and list Codespaces.", + "enum": [ + "read", + "write" + ] + }, + "contents": { + "type": "string", + "description": "The level of permission to grant the access token for repository contents, commits, branches, downloads, releases, and merges.", + "enum": [ + "read", + "write" + ] + }, + "dependabot_secrets": { + "type": "string", + "description": "The level of permission to grant the access token to manage Dependabot secrets.", + "enum": [ + "read", + "write" + ] + }, + "deployments": { + "type": "string", + "description": "The level of permission to grant the access token for deployments and deployment statuses.", + "enum": [ + "read", + "write" + ] + }, + "environments": { + "type": "string", + "description": "The level of permission to grant the access token for managing repository environments.", + "enum": [ + "read", + "write" + ] + }, + "issues": { + "type": "string", + "description": "The level of permission to grant the access token for issues and related comments, assignees, labels, and milestones.", + "enum": [ + "read", + "write" + ] + }, + "metadata": { + "type": "string", + "description": "The level of permission to grant the access token to search repositories, list collaborators, and access repository metadata.", + "enum": [ + "read", + "write" + ] + }, + "packages": { + "type": "string", + "description": "The level of permission to grant the access token for packages published to GitHub Packages.", + "enum": [ + "read", + "write" + ] + }, + "pages": { + "type": "string", + "description": "The level of permission to grant the access token to retrieve Pages statuses, configuration, and builds, as well as create new builds.", + "enum": [ + "read", + "write" + ] + }, + "pull_requests": { + "type": "string", + "description": "The level of permission to grant the access token for pull requests and related comments, assignees, labels, milestones, and merges.", + "enum": [ + "read", + "write" + ] + }, + "repository_custom_properties": { + "type": "string", + "description": "The level of permission to grant the access token to view and edit custom properties for a repository, when allowed by the property.", + "enum": [ + "read", + "write" + ] + }, + "repository_hooks": { + "type": "string", + "description": "The level of permission to grant the access token to manage the post-receive hooks for a repository.", + "enum": [ + "read", + "write" + ] + }, + "repository_projects": { + "type": "string", + "description": "The level of permission to grant the access token to manage repository projects, columns, and cards.", + "enum": [ + "read", + "write", + "admin" + ] + }, + "secret_scanning_alerts": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage secret scanning alerts.", + "enum": [ + "read", + "write" + ] + }, + "secrets": { + "type": "string", + "description": "The level of permission to grant the access token to manage repository secrets.", + "enum": [ + "read", + "write" + ] + }, + "security_events": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage security events like code scanning alerts.", + "enum": [ + "read", + "write" + ] + }, + "single_file": { + "type": "string", + "description": "The level of permission to grant the access token to manage just a single file.", + "enum": [ + "read", + "write" + ] + }, + "statuses": { + "type": "string", + "description": "The level of permission to grant the access token for commit statuses.", + "enum": [ + "read", + "write" + ] + }, + "vulnerability_alerts": { + "type": "string", + "description": "The level of permission to grant the access token to manage Dependabot alerts.", + "enum": [ + "read", + "write" + ] + }, + "workflows": { + "type": "string", + "description": "The level of permission to grant the access token to update GitHub Actions workflow files.", + "enum": [ + "write" + ] + }, + "members": { + "type": "string", + "description": "The level of permission to grant the access token for organization teams and members.", + "enum": [ + "read", + "write" + ] + }, + "organization_administration": { + "type": "string", + "description": "The level of permission to grant the access token to manage access to an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_custom_roles": { + "type": "string", + "description": "The level of permission to grant the access token for custom repository roles management.", + "enum": [ + "read", + "write" + ] + }, + "organization_custom_org_roles": { + "type": "string", + "description": "The level of permission to grant the access token for custom organization roles management.", + "enum": [ + "read", + "write" + ] + }, + "organization_custom_properties": { + "type": "string", + "description": "The level of permission to grant the access token for custom property management.", + "enum": [ + "read", + "write", + "admin" + ] + }, + "organization_copilot_seat_management": { + "type": "string", + "description": "The level of permission to grant the access token for managing access to GitHub Copilot for members of an organization with a Copilot Business subscription. This property is in public preview and is subject to change.", + "enum": [ + "write" + ] + }, + "organization_announcement_banners": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage announcement banners for an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_events": { + "type": "string", + "description": "The level of permission to grant the access token to view events triggered by an activity in an organization.", + "enum": [ + "read" + ] + }, + "organization_hooks": { + "type": "string", + "description": "The level of permission to grant the access token to manage the post-receive hooks for an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_personal_access_tokens": { + "type": "string", + "description": "The level of permission to grant the access token for viewing and managing fine-grained personal access token requests to an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_personal_access_token_requests": { + "type": "string", + "description": "The level of permission to grant the access token for viewing and managing fine-grained personal access tokens that have been approved by an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_plan": { + "type": "string", + "description": "The level of permission to grant the access token for viewing an organization's plan.", + "enum": [ + "read" + ] + }, + "organization_projects": { + "type": "string", + "description": "The level of permission to grant the access token to manage organization projects and projects public preview (where available).", + "enum": [ + "read", + "write", + "admin" + ] + }, + "organization_packages": { + "type": "string", + "description": "The level of permission to grant the access token for organization packages published to GitHub Packages.", + "enum": [ + "read", + "write" + ] + }, + "organization_secrets": { + "type": "string", + "description": "The level of permission to grant the access token to manage organization secrets.", + "enum": [ + "read", + "write" + ] + }, + "organization_self_hosted_runners": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage GitHub Actions self-hosted runners available to an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_user_blocking": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage users blocked by the organization.", + "enum": [ + "read", + "write" + ] + }, + "team_discussions": { + "type": "string", + "description": "The level of permission to grant the access token to manage team discussions and related comments.", + "enum": [ + "read", + "write" + ] + }, + "email_addresses": { + "type": "string", + "description": "The level of permission to grant the access token to manage the email addresses belonging to a user.", + "enum": [ + "read", + "write" + ] + }, + "followers": { + "type": "string", + "description": "The level of permission to grant the access token to manage the followers belonging to a user.", + "enum": [ + "read", + "write" + ] + }, + "git_ssh_keys": { + "type": "string", + "description": "The level of permission to grant the access token to manage git SSH keys.", + "enum": [ + "read", + "write" + ] + }, + "gpg_keys": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage GPG keys belonging to a user.", + "enum": [ + "read", + "write" + ] + }, + "interaction_limits": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage interaction limits on a repository.", + "enum": [ + "read", + "write" + ] + }, + "profile": { + "type": "string", + "description": "The level of permission to grant the access token to manage the profile settings belonging to a user.", + "enum": [ + "write" + ] + }, + "starring": { + "type": "string", + "description": "The level of permission to grant the access token to list and manage repositories a user is starring.", + "enum": [ + "read", + "write" + ] + } + }, + "example": { + "contents": "read", + "issues": "read", + "deployments": "write", + "single_file": "read" + } + }, + "events": { + "type": "array", + "items": { + "type": "string" + } + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" + }, + "single_file_name": { + "type": [ + "string", + "null" + ], + "examples": [ + "config.yaml" + ] + }, + "has_multiple_single_files": { + "type": "boolean", + "examples": [ + true + ] + }, + "single_file_paths": { + "type": "array", + "items": { + "type": "string" + }, + "examples": [ + "config.yml", + ".github/issue_TEMPLATE.md" + ] + }, + "app_slug": { + "type": "string", + "examples": [ + "github-actions" + ] + }, + "suspended_by": { + "anyOf": [ + { + "type": "null" + }, + { + "title": "Simple User", + "description": "A GitHub user.", + "type": "object", + "properties": { + "name": { + "type": [ + "string", + "null" + ] + }, + "email": { + "type": [ + "string", + "null" + ] + }, + "login": { + "type": "string", + "examples": [ + "octocat" + ] + }, + "id": { + "type": "integer", + "format": "int64", + "examples": [ + 1 + ] + }, + "node_id": { + "type": "string", + "examples": [ + "MDQ6VXNlcjE=" + ] + }, + "avatar_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/images/error/octocat_happy.gif" + ] + }, + "gravatar_id": { + "type": [ + "string", + "null" + ], + "examples": [ + "41d064eb2195891e12d0413f63227ea7" + ] + }, + "url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat" + ] + }, + "html_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/octocat" + ] + }, + "followers_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/followers" + ] + }, + "following_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/following{/other_user}" + ] + }, + "gists_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/gists{/gist_id}" + ] + }, + "starred_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/starred{/owner}{/repo}" + ] + }, + "subscriptions_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/subscriptions" + ] + }, + "organizations_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/orgs" + ] + }, + "repos_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/repos" + ] + }, + "events_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/events{/privacy}" + ] + }, + "received_events_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/received_events" + ] + }, + "type": { + "type": "string", + "examples": [ + "User" + ] + }, + "site_admin": { + "type": "boolean" + }, + "starred_at": { + "type": "string", + "examples": [ + "\"2020-07-09T00:17:55Z\"" + ] + }, + "user_view_type": { + "type": "string", + "examples": [ + "public" + ] + } + }, + "required": [ + "avatar_url", + "events_url", + "followers_url", + "following_url", + "gists_url", + "gravatar_id", + "html_url", + "id", + "node_id", + "login", + "organizations_url", + "received_events_url", + "repos_url", + "site_admin", + "starred_url", + "subscriptions_url", + "type", + "url" + ] + } + ] + }, + "suspended_at": { + "type": [ + "string", + "null" + ], + "format": "date-time" + }, + "contact_email": { + "type": [ + "string", + "null" + ], + "examples": [ + "\"test_13f1e99741e3e004@d7e1eb0bc0a1ba12.com\"" + ] + } + }, + "required": [ + "id", + "app_id", + "app_slug", + "target_id", + "target_type", + "single_file_name", + "repository_selection", + "access_tokens_url", + "html_url", + "repositories_url", + "events", + "account", + "permissions", + "created_at", + "updated_at", + "suspended_by", + "suspended_at" + ] + }, + "examples": { + "default": { + "value": { + "id": 1, + "account": { + "login": "octocat", + "id": 1, + "node_id": "MDQ6VXNlcjE=", + "avatar_url": "https://github.com/images/error/octocat_happy.gif", + "gravatar_id": "", + "url": "https://api.github.com/users/octocat", + "html_url": "https://github.com/octocat", + "followers_url": "https://api.github.com/users/octocat/followers", + "following_url": "https://api.github.com/users/octocat/following{/other_user}", + "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", + "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", + "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", + "organizations_url": "https://api.github.com/users/octocat/orgs", + "repos_url": "https://api.github.com/users/octocat/repos", + "events_url": "https://api.github.com/users/octocat/events{/privacy}", + "received_events_url": "https://api.github.com/users/octocat/received_events", + "type": "User", + "site_admin": false + }, + "access_tokens_url": "https://api.github.com/app/installations/1/access_tokens", + "repositories_url": "https://api.github.com/installation/repositories", + "html_url": "https://github.com/organizations/github/settings/installations/1", + "app_id": 1, + "target_id": 1, + "target_type": "Organization", + "permissions": { + "checks": "write", + "metadata": "read", + "contents": "read" + }, + "events": [ + "push", + "pull_request" + ], + "single_file_name": "config.yaml", + "has_multiple_single_files": true, + "single_file_paths": [ + "config.yml", + ".github/issue_TEMPLATE.md" + ], + "repository_selection": "selected", + "created_at": "2017-07-08T16:18:44-04:00", + "updated_at": "2017-07-08T16:18:44-04:00", + "app_slug": "github-actions", + "suspended_at": null, + "suspended_by": null + } + } + } + } + } + } + }, + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "client_id": { + "type": "string", + "description": "The Client ID of the GitHub App to install." + }, + "repository_selection": { + "type": "string", + "description": "The repository selection for the GitHub App. Must be one of:\n* `all` - the installation can access all repositories in the organization.\n* `selected` - the installation can access only the listed repositories.\n* `none` - no repository permissions are requested. Only use when the app does not request repository permissions.", + "enum": [ + "all", + "selected", + "none" + ] + }, + "repositories": { + "type": "array", + "description": "The names of the repositories to which the installation will be granted access. This is the simple name of the repository, not the full name (e.g., `hello-world` not `octocat/hello-world`). This is only required when `repository_selection` is `selected`.", + "items": { + "type": "string" + }, + "maxItems": 50 + } + }, + "required": [ + "client_id", + "repository_selection" + ] + }, + "examples": { + "default": { + "summary": "Example of installing a GitHub App on an organization and granting access to all of its repositories.", + "value": { + "client_id": "Iv2abc123aabbcc", + "repository_selection": "all" + } + }, + "repository_selection_selected": { + "value": { + "client_id": "Iv2abc123aabbcc", + "repository_selection": "selected", + "repositories": [ + "hello-world", + "hello-world-2" + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + } + }, + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}": { + "delete": { + "summary": "Uninstall a GitHub App from an enterprise-owned organization", + "description": "Uninstall a GitHub App from an organization. Any app installed on the organization can be removed.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/delete-installation", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#uninstall-a-github-app-from-an-enterprise-owned-organization" + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "installation_id", + "description": "The unique identifier of the installation.", + "in": "path", + "required": true, + "schema": { + "type": "integer" + }, + "examples": { + "default": { + "value": 1 + } + } + } + ], + "responses": { + "204": { + "description": "An empty response indicates that the installation was successfully removed." + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + }, + "403": { + "description": "Forbidden", "content": { "application/json": { "schema": { - "title": "Validation Error Simple", - "description": "Validation Error Simple", + "title": "Basic Error", + "description": "Basic Error", "type": "object", - "required": [ - "message", - "documentation_url" - ], "properties": { "message": { "type": "string" @@ -27100,11 +30460,11 @@ "documentation_url": { "type": "string" }, - "errors": { - "type": "array", - "items": { - "type": "string" - } + "url": { + "type": "string" + }, + "status": { + "type": "string" } } } @@ -27114,23 +30474,23 @@ }, "x-github": { "githubCloudOnly": true, - "enabledForGitHubApps": false, - "category": "actions", - "subcategory": "self-hosted-runners" + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" } } }, - "/enterprises/{enterprise}/announcement": { + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}/repositories": { "get": { - "summary": "Get announcement banner for enterprise", - "description": "Gets the announcement banner currently set for the enterprise.", + "summary": "Get the repositories accessible to a given GitHub App installation", + "description": "Lists the repositories accessible to a given GitHub App installation on an enterprise-owned organization.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", "tags": [ - "enterprise-admin" + "apps" ], - "operationId": "announcement-banners/get-announcement-banner-for-enterprise", + "operationId": "enterprise-apps/organization-installation-repositories", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/enterprise-cloud@latest//rest/announcement-banners/enterprises#get-announcement-banner-for-enterprise" + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#get-the-repositories-accessible-to-a-given-github-app-installation" }, "parameters": [ { @@ -27141,65 +30501,104 @@ "schema": { "type": "string" } + }, + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "installation_id", + "description": "The unique identifier of the installation.", + "in": "path", + "required": true, + "schema": { + "type": "integer" + }, + "examples": { + "default": { + "value": 1 + } + } + }, + { + "name": "per_page", + "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api).\"", + "in": "query", + "schema": { + "type": "integer", + "default": 30 + } + }, + { + "name": "page", + "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api).\"", + "in": "query", + "schema": { + "type": "integer", + "default": 1 + } } ], "responses": { "200": { - "description": "Response", + "description": "A list of repositories owned by the enterprise organization to which the installation has access.", "content": { "application/json": { "schema": { - "title": "Announcement Banner", - "description": "Announcement at either the repository, organization, or enterprise level", - "type": "object", - "properties": { - "announcement": { - "type": [ - "string", - "null" - ], - "description": "The announcement text in GitHub Flavored Markdown. For more information about GitHub Flavored Markdown, see \"[Basic writing and formatting syntax](https://docs.github.com/enterprise-cloud@latest//github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax).\"", - "examples": [ - "Very **important** announcement about _something_." - ] - }, - "expires_at": { - "type": [ - "string", - "null" - ], - "format": "date-time", - "description": "The time at which the announcement expires. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`. To set an announcement that never expires, omit this parameter, set it to `null`, or set it to an empty string.", - "examples": [ - "\"2021-01-01T00:00:00.000-07:00\"" - ] + "type": "array", + "items": { + "title": "Accessible Repository", + "description": "A repository that may be made accessible to a GitHub App.", + "type": "object", + "properties": { + "id": { + "description": "Unique identifier of the repository", + "type": "integer", + "format": "int64", + "examples": [ + 1 + ] + }, + "name": { + "description": "The name of the repository.", + "type": "string", + "examples": [ + "Team Environment" + ] + }, + "full_name": { + "type": "string", + "examples": [ + "octocat/Hello-World" + ] + } }, - "user_dismissible": { - "type": [ - "boolean", - "null" - ], - "description": "Whether an announcement can be dismissed by the user.", - "default": false, - "examples": [ - false - ] - } - }, - "required": [ - "announcement", - "expires_at", - "user_dismissible" - ] + "required": [ + "full_name", + "id", + "name" + ] + } }, "examples": { "default": { - "summary": "Announcement banner", - "value": { - "announcement": "Very **important** announcement about _something_.", - "expires_at": "2021-01-01T00:00:00.000+00:00", - "user_dismissible": false - } + "value": [ + { + "id": 1, + "name": "Hello World", + "full_name": "octocat/Hello-World" + }, + { + "id": 2, + "login": "Goodbye World", + "full_name": "octocat/Goodbye-World" + } + ] } } } @@ -27208,148 +30607,1136 @@ }, "x-github": { "githubCloudOnly": true, - "enabledForGitHubApps": false, - "category": "announcement-banners", - "subcategory": "enterprises" + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" } }, "patch": { - "summary": "Set announcement banner for enterprise", - "description": "Sets the announcement banner to display for the enterprise.", + "summary": "Toggle installation repository access between selected and all repositories", + "description": "Toggle repository access for a GitHub App installation between all repositories and selected repositories. You must provide at least one repository when changing the access to 'selected'. If you change the access to 'all', the repositories list must not be provided.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", "tags": [ - "enterprise-admin" + "apps" ], - "operationId": "announcement-banners/set-announcement-banner-for-enterprise", + "operationId": "enterprise-apps/change-installation-repository-access-selection", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/enterprise-cloud@latest//rest/announcement-banners/enterprises#set-announcement-banner-for-enterprise" + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#toggle-installation-repository-access-between-selected-and-all-repositories" }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "installation_id", + "description": "The unique identifier of the installation.", + "in": "path", + "required": true, + "schema": { + "type": "integer" + }, + "examples": { + "default": { + "value": 1 + } + } + } + ], "requestBody": { "required": true, "content": { "application/json": { "schema": { - "title": "Enterprise Announcement", - "description": "Enterprise global announcement", "type": "object", "properties": { - "announcement": { - "type": [ - "string", - "null" - ], - "description": "The announcement text in GitHub Flavored Markdown. For more information about GitHub Flavored Markdown, see \"[Basic writing and formatting syntax](https://docs.github.com/enterprise-cloud@latest//github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax).\"", - "examples": [ - "Very **important** announcement about _something_." - ] - }, - "expires_at": { - "type": [ - "string", - "null" - ], - "format": "date-time", - "description": "The time at which the announcement expires. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`. To set an announcement that never expires, omit this parameter, set it to `null`, or set it to an empty string.", - "examples": [ - "\"2021-01-01T00:00:00.000-07:00\"" + "repository_selection": { + "type": "string", + "description": "One of either 'all' or 'selected'", + "enum": [ + "all", + "selected" ] }, - "user_dismissible": { - "type": [ - "boolean", - "null" - ], - "description": "Whether an announcement can be dismissed by the user.", - "default": false, - "examples": [ - false - ] + "repositories": { + "type": "array", + "description": "The repository names to add to the installation. Only required when repository_selection is 'selected'", + "items": { + "type": "string" + }, + "maxItems": 50 } }, "required": [ - "announcement" + "repository_selection" ] }, "examples": { "default": { - "summary": "Announcement banner", + "summary": "Change the repositories accessible to a GitHub App from 'all repositories' to a specified subset.", "value": { - "announcement": "Very **important** announcement about _something_.", - "expires_at": "2021-01-01T00:00:00.000+00:00", - "user_dismissible": false + "repository_selection": "selected", + "repositories": [ + "hello-world", + "hello-world-2" + ] } } } } } }, - "parameters": [ - { - "name": "enterprise", - "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - } - ], "responses": { "200": { - "description": "Response", + "description": "The GitHub App installation that was updated.", "content": { "application/json": { "schema": { - "title": "Announcement Banner", - "description": "Announcement at either the repository, organization, or enterprise level", + "title": "Installation", + "description": "Installation", "type": "object", "properties": { - "announcement": { + "id": { + "description": "The ID of the installation.", + "type": "integer", + "examples": [ + 1 + ] + }, + "account": { + "anyOf": [ + { + "title": "Simple User", + "description": "A GitHub user.", + "type": "object", + "properties": { + "name": { + "type": [ + "string", + "null" + ] + }, + "email": { + "type": [ + "string", + "null" + ] + }, + "login": { + "type": "string", + "examples": [ + "octocat" + ] + }, + "id": { + "type": "integer", + "format": "int64", + "examples": [ + 1 + ] + }, + "node_id": { + "type": "string", + "examples": [ + "MDQ6VXNlcjE=" + ] + }, + "avatar_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/images/error/octocat_happy.gif" + ] + }, + "gravatar_id": { + "type": [ + "string", + "null" + ], + "examples": [ + "41d064eb2195891e12d0413f63227ea7" + ] + }, + "url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat" + ] + }, + "html_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/octocat" + ] + }, + "followers_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/followers" + ] + }, + "following_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/following{/other_user}" + ] + }, + "gists_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/gists{/gist_id}" + ] + }, + "starred_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/starred{/owner}{/repo}" + ] + }, + "subscriptions_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/subscriptions" + ] + }, + "organizations_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/orgs" + ] + }, + "repos_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/repos" + ] + }, + "events_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/events{/privacy}" + ] + }, + "received_events_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/received_events" + ] + }, + "type": { + "type": "string", + "examples": [ + "User" + ] + }, + "site_admin": { + "type": "boolean" + }, + "starred_at": { + "type": "string", + "examples": [ + "\"2020-07-09T00:17:55Z\"" + ] + }, + "user_view_type": { + "type": "string", + "examples": [ + "public" + ] + } + }, + "required": [ + "avatar_url", + "events_url", + "followers_url", + "following_url", + "gists_url", + "gravatar_id", + "html_url", + "id", + "node_id", + "login", + "organizations_url", + "received_events_url", + "repos_url", + "site_admin", + "starred_url", + "subscriptions_url", + "type", + "url" + ] + }, + { + "title": "Enterprise", + "description": "An enterprise on GitHub.", + "type": "object", + "properties": { + "description": { + "description": "A short description of the enterprise.", + "type": [ + "string", + "null" + ] + }, + "html_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/enterprises/octo-business" + ] + }, + "website_url": { + "description": "The enterprise's website URL.", + "type": [ + "string", + "null" + ], + "format": "uri" + }, + "id": { + "description": "Unique identifier of the enterprise", + "type": "integer", + "examples": [ + 42 + ] + }, + "node_id": { + "type": "string", + "examples": [ + "MDEwOlJlcG9zaXRvcnkxMjk2MjY5" + ] + }, + "name": { + "description": "The name of the enterprise.", + "type": "string", + "examples": [ + "Octo Business" + ] + }, + "slug": { + "description": "The slug url identifier for the enterprise.", + "type": "string", + "examples": [ + "octo-business" + ] + }, + "created_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "examples": [ + "2019-01-26T19:01:12Z" + ] + }, + "updated_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "examples": [ + "2019-01-26T19:14:43Z" + ] + }, + "avatar_url": { + "type": "string", + "format": "uri" + } + }, + "required": [ + "id", + "node_id", + "name", + "slug", + "html_url", + "created_at", + "updated_at", + "avatar_url" + ] + } + ], + "type": [ + "null", + "object" + ] + }, + "repository_selection": { + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", + "type": "string", + "enum": [ + "all", + "selected" + ] + }, + "access_tokens_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/app/installations/1/access_tokens" + ] + }, + "repositories_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/installation/repositories" + ] + }, + "html_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/organizations/github/settings/installations/1" + ] + }, + "app_id": { + "type": "integer", + "examples": [ + 1 + ] + }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, + "target_id": { + "description": "The ID of the user or organization this token is being scoped to.", + "type": "integer" + }, + "target_type": { + "type": "string", + "examples": [ + "Organization" + ] + }, + "permissions": { + "title": "App Permissions", + "type": "object", + "description": "The permissions granted to the user access token.", + "properties": { + "actions": { + "type": "string", + "description": "The level of permission to grant the access token for GitHub Actions workflows, workflow runs, and artifacts.", + "enum": [ + "read", + "write" + ] + }, + "administration": { + "type": "string", + "description": "The level of permission to grant the access token for repository creation, deletion, settings, teams, and collaborators creation.", + "enum": [ + "read", + "write" + ] + }, + "checks": { + "type": "string", + "description": "The level of permission to grant the access token for checks on code.", + "enum": [ + "read", + "write" + ] + }, + "codespaces": { + "type": "string", + "description": "The level of permission to grant the access token to create, edit, delete, and list Codespaces.", + "enum": [ + "read", + "write" + ] + }, + "contents": { + "type": "string", + "description": "The level of permission to grant the access token for repository contents, commits, branches, downloads, releases, and merges.", + "enum": [ + "read", + "write" + ] + }, + "dependabot_secrets": { + "type": "string", + "description": "The level of permission to grant the access token to manage Dependabot secrets.", + "enum": [ + "read", + "write" + ] + }, + "deployments": { + "type": "string", + "description": "The level of permission to grant the access token for deployments and deployment statuses.", + "enum": [ + "read", + "write" + ] + }, + "environments": { + "type": "string", + "description": "The level of permission to grant the access token for managing repository environments.", + "enum": [ + "read", + "write" + ] + }, + "issues": { + "type": "string", + "description": "The level of permission to grant the access token for issues and related comments, assignees, labels, and milestones.", + "enum": [ + "read", + "write" + ] + }, + "metadata": { + "type": "string", + "description": "The level of permission to grant the access token to search repositories, list collaborators, and access repository metadata.", + "enum": [ + "read", + "write" + ] + }, + "packages": { + "type": "string", + "description": "The level of permission to grant the access token for packages published to GitHub Packages.", + "enum": [ + "read", + "write" + ] + }, + "pages": { + "type": "string", + "description": "The level of permission to grant the access token to retrieve Pages statuses, configuration, and builds, as well as create new builds.", + "enum": [ + "read", + "write" + ] + }, + "pull_requests": { + "type": "string", + "description": "The level of permission to grant the access token for pull requests and related comments, assignees, labels, milestones, and merges.", + "enum": [ + "read", + "write" + ] + }, + "repository_custom_properties": { + "type": "string", + "description": "The level of permission to grant the access token to view and edit custom properties for a repository, when allowed by the property.", + "enum": [ + "read", + "write" + ] + }, + "repository_hooks": { + "type": "string", + "description": "The level of permission to grant the access token to manage the post-receive hooks for a repository.", + "enum": [ + "read", + "write" + ] + }, + "repository_projects": { + "type": "string", + "description": "The level of permission to grant the access token to manage repository projects, columns, and cards.", + "enum": [ + "read", + "write", + "admin" + ] + }, + "secret_scanning_alerts": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage secret scanning alerts.", + "enum": [ + "read", + "write" + ] + }, + "secrets": { + "type": "string", + "description": "The level of permission to grant the access token to manage repository secrets.", + "enum": [ + "read", + "write" + ] + }, + "security_events": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage security events like code scanning alerts.", + "enum": [ + "read", + "write" + ] + }, + "single_file": { + "type": "string", + "description": "The level of permission to grant the access token to manage just a single file.", + "enum": [ + "read", + "write" + ] + }, + "statuses": { + "type": "string", + "description": "The level of permission to grant the access token for commit statuses.", + "enum": [ + "read", + "write" + ] + }, + "vulnerability_alerts": { + "type": "string", + "description": "The level of permission to grant the access token to manage Dependabot alerts.", + "enum": [ + "read", + "write" + ] + }, + "workflows": { + "type": "string", + "description": "The level of permission to grant the access token to update GitHub Actions workflow files.", + "enum": [ + "write" + ] + }, + "members": { + "type": "string", + "description": "The level of permission to grant the access token for organization teams and members.", + "enum": [ + "read", + "write" + ] + }, + "organization_administration": { + "type": "string", + "description": "The level of permission to grant the access token to manage access to an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_custom_roles": { + "type": "string", + "description": "The level of permission to grant the access token for custom repository roles management.", + "enum": [ + "read", + "write" + ] + }, + "organization_custom_org_roles": { + "type": "string", + "description": "The level of permission to grant the access token for custom organization roles management.", + "enum": [ + "read", + "write" + ] + }, + "organization_custom_properties": { + "type": "string", + "description": "The level of permission to grant the access token for custom property management.", + "enum": [ + "read", + "write", + "admin" + ] + }, + "organization_copilot_seat_management": { + "type": "string", + "description": "The level of permission to grant the access token for managing access to GitHub Copilot for members of an organization with a Copilot Business subscription. This property is in public preview and is subject to change.", + "enum": [ + "write" + ] + }, + "organization_announcement_banners": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage announcement banners for an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_events": { + "type": "string", + "description": "The level of permission to grant the access token to view events triggered by an activity in an organization.", + "enum": [ + "read" + ] + }, + "organization_hooks": { + "type": "string", + "description": "The level of permission to grant the access token to manage the post-receive hooks for an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_personal_access_tokens": { + "type": "string", + "description": "The level of permission to grant the access token for viewing and managing fine-grained personal access token requests to an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_personal_access_token_requests": { + "type": "string", + "description": "The level of permission to grant the access token for viewing and managing fine-grained personal access tokens that have been approved by an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_plan": { + "type": "string", + "description": "The level of permission to grant the access token for viewing an organization's plan.", + "enum": [ + "read" + ] + }, + "organization_projects": { + "type": "string", + "description": "The level of permission to grant the access token to manage organization projects and projects public preview (where available).", + "enum": [ + "read", + "write", + "admin" + ] + }, + "organization_packages": { + "type": "string", + "description": "The level of permission to grant the access token for organization packages published to GitHub Packages.", + "enum": [ + "read", + "write" + ] + }, + "organization_secrets": { + "type": "string", + "description": "The level of permission to grant the access token to manage organization secrets.", + "enum": [ + "read", + "write" + ] + }, + "organization_self_hosted_runners": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage GitHub Actions self-hosted runners available to an organization.", + "enum": [ + "read", + "write" + ] + }, + "organization_user_blocking": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage users blocked by the organization.", + "enum": [ + "read", + "write" + ] + }, + "team_discussions": { + "type": "string", + "description": "The level of permission to grant the access token to manage team discussions and related comments.", + "enum": [ + "read", + "write" + ] + }, + "email_addresses": { + "type": "string", + "description": "The level of permission to grant the access token to manage the email addresses belonging to a user.", + "enum": [ + "read", + "write" + ] + }, + "followers": { + "type": "string", + "description": "The level of permission to grant the access token to manage the followers belonging to a user.", + "enum": [ + "read", + "write" + ] + }, + "git_ssh_keys": { + "type": "string", + "description": "The level of permission to grant the access token to manage git SSH keys.", + "enum": [ + "read", + "write" + ] + }, + "gpg_keys": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage GPG keys belonging to a user.", + "enum": [ + "read", + "write" + ] + }, + "interaction_limits": { + "type": "string", + "description": "The level of permission to grant the access token to view and manage interaction limits on a repository.", + "enum": [ + "read", + "write" + ] + }, + "profile": { + "type": "string", + "description": "The level of permission to grant the access token to manage the profile settings belonging to a user.", + "enum": [ + "write" + ] + }, + "starring": { + "type": "string", + "description": "The level of permission to grant the access token to list and manage repositories a user is starring.", + "enum": [ + "read", + "write" + ] + } + }, + "example": { + "contents": "read", + "issues": "read", + "deployments": "write", + "single_file": "read" + } + }, + "events": { + "type": "array", + "items": { + "type": "string" + } + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" + }, + "single_file_name": { "type": [ "string", "null" ], - "description": "The announcement text in GitHub Flavored Markdown. For more information about GitHub Flavored Markdown, see \"[Basic writing and formatting syntax](https://docs.github.com/enterprise-cloud@latest//github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax).\"", "examples": [ - "Very **important** announcement about _something_." + "config.yaml" ] }, - "expires_at": { + "has_multiple_single_files": { + "type": "boolean", + "examples": [ + true + ] + }, + "single_file_paths": { + "type": "array", + "items": { + "type": "string" + }, + "examples": [ + "config.yml", + ".github/issue_TEMPLATE.md" + ] + }, + "app_slug": { + "type": "string", + "examples": [ + "github-actions" + ] + }, + "suspended_by": { + "anyOf": [ + { + "type": "null" + }, + { + "title": "Simple User", + "description": "A GitHub user.", + "type": "object", + "properties": { + "name": { + "type": [ + "string", + "null" + ] + }, + "email": { + "type": [ + "string", + "null" + ] + }, + "login": { + "type": "string", + "examples": [ + "octocat" + ] + }, + "id": { + "type": "integer", + "format": "int64", + "examples": [ + 1 + ] + }, + "node_id": { + "type": "string", + "examples": [ + "MDQ6VXNlcjE=" + ] + }, + "avatar_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/images/error/octocat_happy.gif" + ] + }, + "gravatar_id": { + "type": [ + "string", + "null" + ], + "examples": [ + "41d064eb2195891e12d0413f63227ea7" + ] + }, + "url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat" + ] + }, + "html_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://github.com/octocat" + ] + }, + "followers_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/followers" + ] + }, + "following_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/following{/other_user}" + ] + }, + "gists_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/gists{/gist_id}" + ] + }, + "starred_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/starred{/owner}{/repo}" + ] + }, + "subscriptions_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/subscriptions" + ] + }, + "organizations_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/orgs" + ] + }, + "repos_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/repos" + ] + }, + "events_url": { + "type": "string", + "examples": [ + "https://api.github.com/users/octocat/events{/privacy}" + ] + }, + "received_events_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/users/octocat/received_events" + ] + }, + "type": { + "type": "string", + "examples": [ + "User" + ] + }, + "site_admin": { + "type": "boolean" + }, + "starred_at": { + "type": "string", + "examples": [ + "\"2020-07-09T00:17:55Z\"" + ] + }, + "user_view_type": { + "type": "string", + "examples": [ + "public" + ] + } + }, + "required": [ + "avatar_url", + "events_url", + "followers_url", + "following_url", + "gists_url", + "gravatar_id", + "html_url", + "id", + "node_id", + "login", + "organizations_url", + "received_events_url", + "repos_url", + "site_admin", + "starred_url", + "subscriptions_url", + "type", + "url" + ] + } + ] + }, + "suspended_at": { "type": [ "string", "null" ], - "format": "date-time", - "description": "The time at which the announcement expires. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`. To set an announcement that never expires, omit this parameter, set it to `null`, or set it to an empty string.", - "examples": [ - "\"2021-01-01T00:00:00.000-07:00\"" - ] + "format": "date-time" }, - "user_dismissible": { + "contact_email": { "type": [ - "boolean", + "string", "null" ], - "description": "Whether an announcement can be dismissed by the user.", - "default": false, "examples": [ - false + "\"test_13f1e99741e3e004@d7e1eb0bc0a1ba12.com\"" ] } }, "required": [ - "announcement", - "expires_at", - "user_dismissible" + "id", + "app_id", + "app_slug", + "target_id", + "target_type", + "single_file_name", + "repository_selection", + "access_tokens_url", + "html_url", + "repositories_url", + "events", + "account", + "permissions", + "created_at", + "updated_at", + "suspended_by", + "suspended_at" ] }, "examples": { "default": { - "summary": "Announcement banner", "value": { - "announcement": "Very **important** announcement about _something_.", - "expires_at": "2021-01-01T00:00:00.000+00:00", - "user_dismissible": false + "id": 1, + "account": { + "login": "octocat", + "id": 1, + "node_id": "MDQ6VXNlcjE=", + "avatar_url": "https://github.com/images/error/octocat_happy.gif", + "gravatar_id": "", + "url": "https://api.github.com/users/octocat", + "html_url": "https://github.com/octocat", + "followers_url": "https://api.github.com/users/octocat/followers", + "following_url": "https://api.github.com/users/octocat/following{/other_user}", + "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", + "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", + "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", + "organizations_url": "https://api.github.com/users/octocat/orgs", + "repos_url": "https://api.github.com/users/octocat/repos", + "events_url": "https://api.github.com/users/octocat/events{/privacy}", + "received_events_url": "https://api.github.com/users/octocat/received_events", + "type": "User", + "site_admin": false + }, + "access_tokens_url": "https://api.github.com/app/installations/1/access_tokens", + "repositories_url": "https://api.github.com/installation/repositories", + "html_url": "https://github.com/organizations/github/settings/installations/1", + "app_id": 1, + "target_id": 1, + "target_type": "Organization", + "permissions": { + "checks": "write", + "metadata": "read", + "contents": "read" + }, + "events": [ + "push", + "pull_request" + ], + "single_file_name": "config.yaml", + "has_multiple_single_files": true, + "single_file_paths": [ + "config.yml", + ".github/issue_TEMPLATE.md" + ], + "repository_selection": "selected", + "created_at": "2017-07-08T16:18:44-04:00", + "updated_at": "2017-07-08T16:18:44-04:00", + "app_slug": "github-actions", + "suspended_at": null, + "suspended_by": null } } } @@ -27359,21 +31746,23 @@ }, "x-github": { "githubCloudOnly": true, - "enabledForGitHubApps": false, - "category": "announcement-banners", - "subcategory": "enterprises" + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" } - }, - "delete": { - "summary": "Remove announcement banner from enterprise", - "description": "Removes the announcement banner currently set for the enterprise.", + } + }, + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}/repositories/add": { + "patch": { + "summary": "Grant repository access to an organization installation", + "description": "Grant repository access to an organization installation. You can add up to 50 repositories at a time. If the installation already has access to the repository, it will not be added again.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", "tags": [ - "enterprise-admin" + "apps" ], - "operationId": "announcement-banners/remove-announcement-banner-for-enterprise", + "operationId": "enterprise-apps/grant-repository-access-to-installation", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/enterprise-cloud@latest//rest/announcement-banners/enterprises#remove-announcement-banner-from-enterprise" + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#grant-repository-access-to-an-organization-installation" }, "parameters": [ { @@ -27384,18 +31773,319 @@ "schema": { "type": "string" } + }, + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "installation_id", + "description": "The unique identifier of the installation.", + "in": "path", + "required": true, + "schema": { + "type": "integer" + }, + "examples": { + "default": { + "value": 1 + } + } } ], "responses": { - "204": { - "description": "Response" + "200": { + "description": "A list of repositories which the authenticated GitHub App should be granted access to.", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "title": "Accessible Repository", + "description": "A repository that may be made accessible to a GitHub App.", + "type": "object", + "properties": { + "id": { + "description": "Unique identifier of the repository", + "type": "integer", + "format": "int64", + "examples": [ + 1 + ] + }, + "name": { + "description": "The name of the repository.", + "type": "string", + "examples": [ + "Team Environment" + ] + }, + "full_name": { + "type": "string", + "examples": [ + "octocat/Hello-World" + ] + } + }, + "required": [ + "full_name", + "id", + "name" + ] + } + }, + "examples": { + "default": { + "value": [ + { + "id": 1, + "name": "Hello World", + "full_name": "octocat/Hello-World" + }, + { + "id": 2, + "login": "Goodbye World", + "full_name": "octocat/Goodbye-World" + } + ] + } + } + } + } + } + }, + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "repositories": { + "type": "array", + "description": "The repository names to add to the installation.", + "items": { + "type": "string" + }, + "maxItems": 50 + } + }, + "required": [ + "repositories" + ] + }, + "examples": { + "repositories": { + "value": { + "repositories": [ + "hello-world", + "hello-world-2" + ] + } + } + } + } } }, "x-github": { "githubCloudOnly": true, - "enabledForGitHubApps": false, - "category": "announcement-banners", - "subcategory": "enterprises" + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + } + }, + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}/repositories/remove": { + "patch": { + "summary": "Remove repository access from an organization installation", + "description": "Remove repository access from a GitHub App installed on an organization. You can remove up to 50 repositories at a time. You cannot remove repositories from an app installed on `all` repositories, nor can you remove the last repository for an app. If you attempt to do so, the API will return a 422 Unprocessable Entity error.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/remove-repository-access-to-installation", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#remove-repository-access-from-an-organization-installation" + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "installation_id", + "description": "The unique identifier of the installation.", + "in": "path", + "required": true, + "schema": { + "type": "integer" + }, + "examples": { + "default": { + "value": 1 + } + } + } + ], + "responses": { + "200": { + "description": "A list of repositories which the authenticated GitHub App has lost access to.", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "title": "Accessible Repository", + "description": "A repository that may be made accessible to a GitHub App.", + "type": "object", + "properties": { + "id": { + "description": "Unique identifier of the repository", + "type": "integer", + "format": "int64", + "examples": [ + 1 + ] + }, + "name": { + "description": "The name of the repository.", + "type": "string", + "examples": [ + "Team Environment" + ] + }, + "full_name": { + "type": "string", + "examples": [ + "octocat/Hello-World" + ] + } + }, + "required": [ + "full_name", + "id", + "name" + ] + } + }, + "examples": { + "default": { + "value": [ + { + "id": 1, + "name": "Hello World", + "full_name": "octocat/Hello-World" + }, + { + "id": 2, + "login": "Goodbye World", + "full_name": "octocat/Goodbye-World" + } + ] + } + } + } + } + }, + "422": { + "description": "The request was well-formed but was unable to be followed due to semantic errors. This can happen if you attempt to remove a repository from an installation that has access to `all` repositories, or if you attempt to remove the last repository from an installation.", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + }, + "examples": { + "default": { + "value": [ + { + "message": "Cannot remove the last repository from this installation. Uninstall this application instead." + }, + { + "documentation_url": "https://docs.github.com/rest/enterprise-admin/organization-installations#remove-repository-access-to-an-organization-installation" + }, + { + "status": 422 + } + ] + } + } + } + } + } + }, + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "repositories": { + "type": "array", + "description": "The repository names to remove from the installation.", + "items": { + "type": "string" + }, + "maxItems": 50 + } + }, + "required": [ + "repositories" + ] + }, + "examples": { + "repositories": { + "value": { + "repositories": [ + "hello-world", + "hello-world-2" + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" } } }, @@ -142524,7 +147214,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -142558,6 +147248,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -143624,7 +148320,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -143658,6 +148354,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -150485,7 +155187,7 @@ }, "delete": { "summary": "Remove an organization member", - "description": "Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories.", + "description": "Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories.\n\n> [!NOTE]\n> If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team.", "tags": [ "orgs" ], @@ -156725,7 +161427,7 @@ }, "delete": { "summary": "Remove organization membership for a user", - "description": "In order to remove a user's membership with an organization, the authenticated user must be an organization owner.\n\nIf the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases.", + "description": "In order to remove a user's membership with an organization, the authenticated user must be an organization owner.\n\nIf the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases.\n\n> [!NOTE]\n> If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team.", "tags": [ "orgs" ], @@ -380546,7 +385248,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -380580,6 +385282,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -635111,7 +639819,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -635145,6 +639853,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -686454,7 +691168,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -686488,6 +691202,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -908100,7 +912820,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -908134,6 +912854,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -911160,7 +915886,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -911194,6 +915920,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -914125,7 +918857,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -914159,6 +918891,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -917090,7 +921828,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -917124,6 +921862,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -920189,7 +924933,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -920223,6 +924967,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -923295,7 +928045,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -923329,6 +928079,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -928396,7 +933152,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -928430,6 +933186,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" diff --git a/descriptions-next/ghec/dereferenced/ghec.deref.yaml b/descriptions-next/ghec/dereferenced/ghec.deref.yaml index d0ef9b9ec2..b4cce4f297 100644 --- a/descriptions-next/ghec/dereferenced/ghec.deref.yaml +++ b/descriptions-next/ghec/dereferenced/ghec.deref.yaml @@ -442,7 +442,7 @@ paths: The EPSS percentile represents the relative rank of the CVE's likelihood of being exploited compared to other CVEs. schema: type: string - - &84 + - &87 name: before description: A cursor, as given in the [Link header](https://docs.github.com/enterprise-cloud@latest//rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for results before this cursor. For @@ -451,7 +451,7 @@ paths: required: false schema: type: string - - &85 + - &88 name: after description: A cursor, as given in the [Link header](https://docs.github.com/enterprise-cloud@latest//rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for results after this cursor. For @@ -460,7 +460,7 @@ paths: required: false schema: type: string - - &86 + - &89 name: direction description: The direction to sort the results by. in: query @@ -699,7 +699,7 @@ paths: required: - vector_string - score - cvss_severities: &98 + cvss_severities: &101 type: - object - 'null' @@ -746,7 +746,7 @@ paths: required: - vector_string - score - epss: &99 + epss: &102 type: - object - 'null' @@ -909,7 +909,7 @@ paths: - subscriptions_url - type - url - type: &335 + type: &337 type: string description: The type of credit the user is receiving. enum: @@ -1042,7 +1042,7 @@ paths: description: Validation failed, or the endpoint has been spammed. content: application/json: - schema: &177 + schema: &179 title: Validation Error Simple description: Validation Error Simple type: object @@ -1075,7 +1075,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/global-advisories#get-a-global-security-advisory parameters: - - &674 + - &676 name: ghsa_id description: The GHSA (GitHub Security Advisory) identifier of the advisory. in: path @@ -1660,7 +1660,7 @@ paths: schema: type: integer default: 30 - - &260 + - &262 name: cursor description: 'Used for pagination: the starting delivery from which the page of deliveries is fetched. Refer to the `link` header for the next and previous @@ -1676,7 +1676,7 @@ paths: application/json: schema: type: array - items: &261 + items: &263 title: Simple webhook delivery description: Delivery made by a webhook, without request and response information. @@ -1772,7 +1772,7 @@ paths: - installation_id - repository_id examples: - default: &262 + default: &264 value: - id: 12345678 guid: 0b989ba4-242f-11e5-81e1-c7b6966d2516 @@ -1804,7 +1804,7 @@ paths: application/json: schema: *3 application/scim+json: - schema: &684 + schema: &686 title: Scim Error description: Scim Error type: object @@ -1835,7 +1835,7 @@ paths: description: Validation failed, or the endpoint has been spammed. content: application/json: - schema: &176 + schema: &178 title: Validation Error description: Validation Error type: object @@ -1907,7 +1907,7 @@ paths: description: Response content: application/json: - schema: &263 + schema: &265 title: Webhook delivery description: Delivery made by a webhook. type: object @@ -2042,7 +2042,7 @@ paths: - request - response examples: - default: &264 + default: &266 value: id: 12345678 guid: 0b989ba4-242f-11e5-81e1-c7b6966d2516 @@ -2246,7 +2246,7 @@ paths: parameters: - *17 - *19 - - &141 + - &144 name: since description: 'Only show results that were last updated after the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) @@ -2288,7 +2288,8 @@ paths: - object repository_selection: description: Describe whether all repositories have been selected - or there's a selection involved + or there's a selection involved. For enterprise installations + this is `selected`. type: string enum: - all @@ -2312,6 +2313,10 @@ paths: type: integer examples: - 1 + client_id: + type: string + examples: + - Iv1.ab1112223334445c target_id: description: The ID of the user or organization this token is being scoped to. @@ -2832,7 +2837,7 @@ paths: application/json: schema: *20 examples: - default: + default: &72 value: id: 1 account: @@ -2887,7 +2892,7 @@ paths: delete: summary: Delete an installation for the authenticated app description: |- - Uninstalls a GitHub App on a user, organization, or business account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the "[Suspend an app installation](https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#suspend-an-app-installation)" endpoint. + Uninstalls a GitHub App on a user, organization, or enterprise account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the "[Suspend an app installation](https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#suspend-an-app-installation)" endpoint. You must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. tags: @@ -2911,12 +2916,14 @@ paths: post: summary: Create an installation access token for an app description: |- - Creates an installation access token that enables a GitHub App to make authenticated API requests for the app's installation on an organization or individual account. Installation tokens expire one hour from the time you create them. Using an expired token produces a status code of `401 - Unauthorized`, and requires creating a new installation token. By default the installation token has access to all repositories that the installation can access. + Creates an installation access token that enables a GitHub App to make authenticated API requests for the app's installation on an enterprise, organization, or individual account. Installation tokens expire one hour from the time you create them. Using an expired token produces a status code of `401 - Unauthorized`, and requires creating a new installation token. By default the installation token has access to all repositories that the installation can access. Optionally, you can use the `repositories` or `repository_ids` body parameters to specify individual repositories that the installation access token can access. If you don't use `repositories` or `repository_ids` to grant access to specific repositories, the installation access token will have access to all repositories that the installation was granted access to. The installation access token cannot be granted access to repositories that the installation was not granted access to. Up to 500 repositories can be listed in this manner. Optionally, use the `permissions` body parameter to specify the permissions that the installation access token should have. If `permissions` is not specified, the installation access token will have all of the permissions that were granted to the app. The installation access token cannot be granted permissions that the app was not granted. + Enterprise account installations do not have access to repositories and cannot be scoped down using the `permissions` parameter. + You must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. tags: - apps @@ -2966,7 +2973,7 @@ paths: schema: title: Installation Token description: Authentication token for a GitHub App installed on a - user or org. + user, org, or enterprise. type: object properties: token: @@ -3008,7 +3015,7 @@ paths: license: anyOf: - type: 'null' - - &152 + - &155 title: License Simple description: License Simple type: object @@ -3746,7 +3753,7 @@ paths: put: summary: Suspend an app installation description: |- - Suspends a GitHub App on a user, organization, or business account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub Enterprise Cloud API or webhook events is blocked for that account. + Suspends a GitHub App on a user, organization, or enterprise account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub Enterprise Cloud API or webhook events is blocked for that account. You must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. tags: @@ -5386,7 +5393,7 @@ paths: responses: '202': *37 '422': *7 - '500': &83 + '500': &86 description: Internal Error content: application/json: @@ -7672,7 +7679,7 @@ paths: description: Response content: application/json: - schema: &178 + schema: &180 type: object properties: total_active_caches_count: @@ -7687,7 +7694,7 @@ paths: - total_active_caches_count - total_active_caches_size_in_bytes examples: - default: &179 + default: &181 value: total_active_caches_size_in_bytes: 3344284 total_active_caches_count: 5 @@ -7892,7 +7899,7 @@ paths: - public_ip_enabled - platform examples: - default: &180 + default: &182 value: total_count: 2 runners: @@ -8182,7 +8189,7 @@ paths: description: Response content: application/json: - schema: &181 + schema: &183 type: object properties: public_ips: @@ -8209,7 +8216,7 @@ paths: required: - public_ips examples: - default: &182 + default: &184 value: public_ips: current_usage: 17 @@ -8249,7 +8256,7 @@ paths: type: array items: *43 examples: - default: &183 + default: &185 value: id: 4-core cpu_cores: 4 @@ -8507,7 +8514,7 @@ paths: - all - local_only - selected - selected_actions_url: &186 + selected_actions_url: &188 type: string description: The API URL to use to get or set the actions and reusable workflows that are allowed to run, when `allowed_actions` @@ -8888,7 +8895,7 @@ paths: description: Success response content: application/json: - schema: &189 + schema: &191 type: object properties: default_workflow_permissions: &51 @@ -8936,7 +8943,7 @@ paths: required: true content: application/json: - schema: &190 + schema: &192 type: object properties: default_workflow_permissions: *51 @@ -9781,7 +9788,7 @@ paths: application/json: schema: type: array - items: &194 + items: &196 title: Runner Application description: Runner Application type: object @@ -9806,7 +9813,7 @@ paths: - download_url - filename examples: - default: &195 + default: &197 value: - os: osx architecture: x64 @@ -9890,7 +9897,7 @@ paths: - no-gpu work_folder: _work responses: - '201': &196 + '201': &198 description: Response content: application/json: @@ -9929,7 +9936,7 @@ paths: encoded_jit_config: abc123 '404': *6 '422': *7 - '409': &94 + '409': &97 description: Conflict content: application/json: @@ -10009,7 +10016,7 @@ paths: - token - expires_at examples: - default: &197 + default: &199 value: token: LLBF3JGZDX3P5PMEXLND6TS6FCWO6 expires_at: '2020-01-22T12:13:35.123-08:00' @@ -10049,7 +10056,7 @@ paths: application/json: schema: *63 examples: - default: &198 + default: &200 value: token: AABF3JGZDX3P5PMEXLND6TS6FCWO6 expires_at: '2020-01-29T12:13:35.123-08:00' @@ -10081,7 +10088,7 @@ paths: application/json: schema: *60 examples: - default: &199 + default: &201 value: id: 23 name: MBP @@ -10297,7 +10304,7 @@ paths: - *39 - *59 responses: - '200': &200 + '200': &202 description: Response content: application/json: @@ -10353,7 +10360,7 @@ paths: parameters: - *39 - *59 - - &201 + - &203 name: name description: The name of a self-hosted runner's custom label. in: path @@ -10450,7 +10457,7 @@ paths: required: true content: application/json: - schema: &208 + schema: &210 title: Enterprise Announcement description: Enterprise global announcement type: object @@ -10496,6 +10503,585 @@ paths: enabledForGitHubApps: false category: announcement-banners subcategory: enterprises + "/enterprises/{enterprise}/apps/installable_organizations": + get: + summary: Get enterprise-owned organizations that can have GitHub Apps installed + description: |- + List the organizations owned by the enterprise, intended for use by GitHub Apps that are managing applications across the enterprise. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/installable-organizations + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#get-enterprise-owned-organizations-that-can-have-github-apps-installed + parameters: + - *39 + - *17 + - *19 + responses: + '200': + description: A list of organizations owned by the enterprise on which the + authenticated GitHub App is installed. + content: + application/json: + schema: + type: array + items: + title: Installable Organization + description: A GitHub organization on which a GitHub App can be + installed. + type: object + properties: + id: + type: integer + examples: + - 1 + login: + type: string + examples: + - github + accessible_repositories_url: + type: string + format: uri + examples: + - https://api.github.com/enterprises/biz-name/apps/organizations/org-login/accessible_repositories + required: + - id + - login + examples: + default: + value: + - id: 1 + login: github + - id: 2 + login: microsoft + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + "/enterprises/{enterprise}/apps/installable_organizations/{org}/accessible_repositories": + get: + summary: Get repositories belonging to an enterprise-owned organization + description: |- + List the repositories belonging to an enterprise-owned organization that can be made accessible to a GitHub App installed on that organization. This API provides a shallow list of repositories in the organization, allowing the caller to then add or remove those repositories to an installation in that organization. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/installable-organization-accessible-repositories + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#get-repositories-belonging-to-an-enterprise-owned-organization + parameters: + - *39 + - &71 + name: org + description: The organization name. The name is not case sensitive. + in: path + required: true + schema: + type: string + - *17 + - *19 + responses: + '200': + description: A list of repositories owned by the enterprise organization + on which the authenticated GitHub App is installed. + content: + application/json: + schema: + type: array + items: &73 + title: Accessible Repository + description: A repository that may be made accessible to a GitHub + App. + type: object + properties: + id: + description: Unique identifier of the repository + type: integer + format: int64 + examples: + - 1 + name: + description: The name of the repository. + type: string + examples: + - Team Environment + full_name: + type: string + examples: + - octocat/Hello-World + required: + - full_name + - id + - name + examples: + default: + value: + - id: 1 + name: Hello World + full_name: octocat/Hello-World + - id: 2 + login: Goodbye World + full_name: octocat/Goodbye-World + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + "/enterprises/{enterprise}/apps/organizations/{org}/installations": + get: + summary: List GitHub Apps installed on an enterprise-owned organization + description: |- + Lists the GitHub App installations associated with the given enterprise-owned organization. This lists all GitHub Apps that have been installed on the organization, regardless of who owns the application. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/organization-installations + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#list-github-apps-installed-on-an-enterprise-owned-organization + parameters: + - *39 + - *71 + - *17 + - *19 + responses: + '200': + description: A list of GitHub App installations that have been granted access + to the organization + content: + application/json: + schema: + type: array + items: + title: Enterprise Organization Installation + description: A GitHub App Installation on an enterprise-owned organization + type: object + properties: + id: + description: The ID of the installation. + type: integer + examples: + - 1 + app_slug: + type: string + examples: + - github/github-actions + client_id: + type: string + examples: + - Iv1.ab1112223334445c + repository_selection: + description: Describe whether all repositories have been selected + or there's a selection involved + type: string + enum: + - all + - selected + repositories_url: + type: string + format: uri + examples: + - https://api.github.com/enterprises/acme-corp/apps/organizations/some-org/installations/1/repositories + permissions: *22 + events: + type: array + items: + type: string + created_at: + type: string + format: date-time + updated_at: + type: string + format: date-time + required: + - id + - client_id + - repository_selection + - repositories_url + - permissions + - created_at + - updated_at + examples: + default: + value: + - value: + id: 1 + app_slug: monalisa/orbit + repository_selection: selected + repositories_url: https://api.github.com/enterprises/acme-corp/apps/organizations/some-org/installations/1/repositories + permissions: + checks: write + metadata: read + contents: read + events: + - push + - pull_request + created_at: '2017-07-08T16:18:44-04:00' + updated_at: '2017-07-08T16:18:44-04:00' + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + post: + summary: Install a GitHub App on an enterprise-owned organization + description: |- + Installs any valid GitHub App on the specified organization owned by the enterprise. If the app is already installed on the organization, and is suspended, it will be unsuspended. + If the app has a pending installation request, they will all be approved. + + If the app is already installed and has a pending update request, it will be updated to the latest version. If the app is now requesting repository permissions, it will be given access to the repositories listed in the request or fail if no `repository_selection` is provided. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/create-installation + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#install-a-github-app-on-an-enterprise-owned-organization + parameters: + - *39 + - *71 + responses: + '200': + description: A GitHub App installation that was installed previously. + content: + application/json: + schema: *20 + examples: + default: *72 + '201': + description: A GitHub App installation. + content: + application/json: + schema: *20 + examples: + default: *72 + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + client_id: + type: string + description: The Client ID of the GitHub App to install. + repository_selection: + type: string + description: |- + The repository selection for the GitHub App. Must be one of: + * `all` - the installation can access all repositories in the organization. + * `selected` - the installation can access only the listed repositories. + * `none` - no repository permissions are requested. Only use when the app does not request repository permissions. + enum: + - all + - selected + - none + repositories: + type: array + description: The names of the repositories to which the installation + will be granted access. This is the simple name of the repository, + not the full name (e.g., `hello-world` not `octocat/hello-world`). + This is only required when `repository_selection` is `selected`. + items: + type: string + maxItems: 50 + required: + - client_id + - repository_selection + examples: + default: + summary: Example of installing a GitHub App on an organization and + granting access to all of its repositories. + value: + client_id: Iv2abc123aabbcc + repository_selection: all + repository_selection_selected: + value: + client_id: Iv2abc123aabbcc + repository_selection: selected + repositories: + - hello-world + - hello-world-2 + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}": + delete: + summary: Uninstall a GitHub App from an enterprise-owned organization + description: |- + Uninstall a GitHub App from an organization. Any app installed on the organization can be removed. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/delete-installation + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#uninstall-a-github-app-from-an-enterprise-owned-organization + parameters: + - *39 + - *71 + - *21 + responses: + '204': + description: An empty response indicates that the installation was successfully + removed. + '404': *6 + '403': *27 + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}/repositories": + get: + summary: Get the repositories accessible to a given GitHub App installation + description: |- + Lists the repositories accessible to a given GitHub App installation on an enterprise-owned organization. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/organization-installation-repositories + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#get-the-repositories-accessible-to-a-given-github-app-installation + parameters: + - *39 + - *71 + - *21 + - *17 + - *19 + responses: + '200': + description: A list of repositories owned by the enterprise organization + to which the installation has access. + content: + application/json: + schema: + type: array + items: *73 + examples: + default: + value: + - id: 1 + name: Hello World + full_name: octocat/Hello-World + - id: 2 + login: Goodbye World + full_name: octocat/Goodbye-World + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + patch: + summary: Toggle installation repository access between selected and all repositories + description: |- + Toggle repository access for a GitHub App installation between all repositories and selected repositories. You must provide at least one repository when changing the access to 'selected'. If you change the access to 'all', the repositories list must not be provided. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/change-installation-repository-access-selection + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#toggle-installation-repository-access-between-selected-and-all-repositories + parameters: + - *39 + - *71 + - *21 + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + repository_selection: + type: string + description: One of either 'all' or 'selected' + enum: + - all + - selected + repositories: + type: array + description: The repository names to add to the installation. Only + required when repository_selection is 'selected' + items: + type: string + maxItems: 50 + required: + - repository_selection + examples: + default: + summary: Change the repositories accessible to a GitHub App from 'all + repositories' to a specified subset. + value: + repository_selection: selected + repositories: + - hello-world + - hello-world-2 + responses: + '200': + description: The GitHub App installation that was updated. + content: + application/json: + schema: *20 + examples: + default: *72 + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}/repositories/add": + patch: + summary: Grant repository access to an organization installation + description: |- + Grant repository access to an organization installation. You can add up to 50 repositories at a time. If the installation already has access to the repository, it will not be added again. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/grant-repository-access-to-installation + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#grant-repository-access-to-an-organization-installation + parameters: + - *39 + - *71 + - *21 + responses: + '200': + description: A list of repositories which the authenticated GitHub App should + be granted access to. + content: + application/json: + schema: + type: array + items: *73 + examples: + default: + value: + - id: 1 + name: Hello World + full_name: octocat/Hello-World + - id: 2 + login: Goodbye World + full_name: octocat/Goodbye-World + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + repositories: + type: array + description: The repository names to add to the installation. + items: + type: string + maxItems: 50 + required: + - repositories + examples: + repositories: + value: + repositories: + - hello-world + - hello-world-2 + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}/repositories/remove": + patch: + summary: Remove repository access from an organization installation + description: |- + Remove repository access from a GitHub App installed on an organization. You can remove up to 50 repositories at a time. You cannot remove repositories from an app installed on `all` repositories, nor can you remove the last repository for an app. If you attempt to do so, the API will return a 422 Unprocessable Entity error. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/remove-repository-access-to-installation + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#remove-repository-access-from-an-organization-installation + parameters: + - *39 + - *71 + - *21 + responses: + '200': + description: A list of repositories which the authenticated GitHub App has + lost access to. + content: + application/json: + schema: + type: array + items: *73 + examples: + default: + value: + - id: 1 + name: Hello World + full_name: octocat/Hello-World + - id: 2 + login: Goodbye World + full_name: octocat/Goodbye-World + '422': + description: The request was well-formed but was unable to be followed due + to semantic errors. This can happen if you attempt to remove a repository + from an installation that has access to `all` repositories, or if you + attempt to remove the last repository from an installation. + content: + application/json: + schema: *3 + examples: + default: + value: + - message: Cannot remove the last repository from this installation. + Uninstall this application instead. + - documentation_url: https://docs.github.com/rest/enterprise-admin/organization-installations#remove-repository-access-to-an-organization-installation + - status: 422 + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + repositories: + type: array + description: The repository names to remove from the installation. + items: + type: string + maxItems: 50 + required: + - repositories + examples: + repositories: + value: + repositories: + - hello-world + - hello-world-2 + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations "/enterprises/{enterprise}/audit-log": get: summary: Get the audit log for an enterprise @@ -10522,7 +11108,7 @@ paths: required: false schema: type: string - - &209 + - &211 name: include description: |- The event types to include: @@ -10540,7 +11126,7 @@ paths: - web - git - all - - &210 + - &212 name: after description: A cursor, as given in the [Link header](https://docs.github.com/enterprise-cloud@latest//rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for events after this cursor. @@ -10548,7 +11134,7 @@ paths: required: false schema: type: string - - &211 + - &213 name: before description: A cursor, as given in the [Link header](https://docs.github.com/enterprise-cloud@latest//rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for events before this cursor. @@ -10556,7 +11142,7 @@ paths: required: false schema: type: string - - &212 + - &214 name: order description: |- The order of audit log events. To list newest events first, specify `desc`. To list oldest events first, specify `asc`. @@ -10578,7 +11164,7 @@ paths: application/json: schema: type: array - items: &213 + items: &215 type: object properties: "@timestamp": @@ -10700,7 +11286,7 @@ paths: description: The repository visibility, for example `public` or `private`. examples: - default: &214 + default: &216 value: - "@timestamp": 1606929874512 action: team.add_member @@ -10880,7 +11466,7 @@ paths: vendor_specific: type: object oneOf: - - &74 + - &77 title: AzureBlobConfig description: Azure Blob Config for audit log streaming configuration. type: object @@ -10894,7 +11480,7 @@ paths: required: - key_id - encrypted_sas_url - - &75 + - &78 title: AzureHubConfig description: Azure Event Hubs Config for audit log streaming configuration. type: object @@ -10913,7 +11499,7 @@ paths: - name - encrypted_connstring - key_id - - &76 + - &79 title: AmazonS3OIDCConfig description: Amazon S3 OIDC Config for audit log streaming configuration. type: object @@ -10941,7 +11527,7 @@ paths: - bucket - key_id - region - - &77 + - &80 title: AmazonS3AccessKeysConfig description: Amazon S3 Access Keys Config for audit log streaming configuration. @@ -10975,7 +11561,7 @@ paths: - encrypted_secret_key - key_id - region - - &78 + - &81 title: SplunkConfig description: Splunk Config for Audit Log Stream Configuration type: object @@ -11003,7 +11589,7 @@ paths: - key_id - port - ssl_verify - - &79 + - &82 title: HecConfig description: Hec Config for Audit Log Stream Configuration type: object @@ -11035,7 +11621,7 @@ paths: - key_id - port - ssl_verify - - &80 + - &83 title: GoogleCloudConfig description: Google Cloud Config for audit log streaming configuration. type: object @@ -11053,7 +11639,7 @@ paths: - bucket - key_id - encrypted_json_credentials - - &81 + - &84 title: DatadogConfig description: Datadog Config for audit log streaming configuration. type: object @@ -11084,7 +11670,7 @@ paths: - stream_type - vendor_specific examples: - default: &82 + default: &85 value: enabled: false stream_type: Azure Event Hubs @@ -11098,7 +11684,7 @@ paths: description: The audit log stream configuration was created successfully. content: application/json: - schema: &71 + schema: &74 title: Get an audit log streaming configuration description: Get an audit log streaming configuration for an enterprise. type: object @@ -11130,7 +11716,7 @@ paths: - created_at - updated_at examples: - default: &72 + default: &75 value: id: 1 stream_type: Splunk @@ -11159,7 +11745,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/audit-log#list-one-audit-log-streaming-configuration-via-a-stream-id parameters: - *39 - - &73 + - &76 name: stream_id description: The ID of the audit log stream configuration. in: path @@ -11171,9 +11757,9 @@ paths: description: Lists one audit log stream configuration via stream ID. content: application/json: - schema: *71 + schema: *74 examples: - default: *72 + default: *75 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -11193,7 +11779,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/audit-log#update-an-existing-audit-log-stream-configuration parameters: - *39 - - *73 + - *76 requestBody: required: true content: @@ -11219,28 +11805,28 @@ paths: vendor_specific: type: object oneOf: - - *74 - - *75 - - *76 - *77 - *78 - *79 - *80 - *81 + - *82 + - *83 + - *84 required: - enabled - stream_type - vendor_specific examples: - default: *82 + default: *85 responses: '200': description: Successful update content: application/json: - schema: *71 + schema: *74 examples: - default: *72 + default: *75 '422': description: Validation error content: @@ -11271,7 +11857,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/audit-log#delete-an-audit-log-streaming-configuration-for-an-enterprise parameters: - *39 - - *73 + - *76 responses: '204': description: The audit log stream configuration was deleted successfully. @@ -11303,7 +11889,7 @@ paths: in: query schema: type: string - - &216 + - &218 name: reviewer description: Filter bypass requests by the handle of the GitHub user who reviewed the bypass request. @@ -11311,7 +11897,7 @@ paths: required: false schema: type: string - - &217 + - &219 name: requester description: Filter bypass requests by the handle of the GitHub user who requested the bypass. @@ -11319,7 +11905,7 @@ paths: required: false schema: type: string - - &218 + - &220 name: time_period description: |- The time period to filter by. @@ -11335,7 +11921,7 @@ paths: - week - month default: day - - &219 + - &221 name: request_status description: The status of the bypass request to filter on. When specified, only requests with this status will be returned. @@ -11362,7 +11948,7 @@ paths: application/json: schema: type: array - items: &220 + items: &222 title: Push rule bypass request description: A bypass request made by a user asking to be exempted from a push rule in this repository. @@ -11488,7 +12074,7 @@ paths: - array - 'null' description: The responses to the bypass request. - items: &223 + items: &225 title: Bypass response description: A response made by a delegated bypasser to a bypass request. @@ -11534,7 +12120,7 @@ paths: examples: - https://github.com/octo-org/smile/exemptions/1 examples: - default: &221 + default: &223 value: - id: 21 number: 42 @@ -11603,7 +12189,7 @@ paths: url: https://api.github.com/repos/octo-org/smile/bypass-requests/push-rules/2 html_url: https://github.com/octo-org/smile/exemptions/2 '404': *6 - '500': *83 + '500': *86 "/enterprises/{enterprise}/code-scanning/alerts": get: summary: List code scanning alerts for an enterprise @@ -11621,17 +12207,17 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#list-code-scanning-alerts-for-an-enterprise parameters: - *39 - - &228 + - &230 name: tool_name description: The name of a code scanning tool. Only results by this tool will be listed. You can specify the tool by using either `tool_name` or `tool_guid`, but not both. in: query required: false - schema: &87 + schema: &90 type: string description: The name of the tool used to generate the code scanning analysis. - - &229 + - &231 name: tool_guid description: The GUID of a code scanning tool. Only results by this tool will be listed. Note that some code scanning tools may not include a GUID in @@ -11639,23 +12225,23 @@ paths: or `tool_name`, but not both. in: query required: false - schema: &88 + schema: &91 type: - string - 'null' description: The GUID of the tool used to generate the code scanning analysis, if provided in the uploaded SARIF data. - - *84 - - *85 + - *87 + - *88 - *19 - *17 - - *86 + - *89 - name: state description: If specified, only code scanning alerts with this state will be returned. in: query required: false - schema: &230 + schema: &232 type: string description: State of a code scanning alert. enum: @@ -11680,42 +12266,42 @@ paths: application/json: schema: type: array - items: &231 + items: &233 type: object properties: - number: &96 + number: &99 type: integer description: The security alert number. readOnly: true - created_at: &103 + created_at: &106 type: string description: 'The time that the alert was created in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.' format: date-time readOnly: true - updated_at: &104 + updated_at: &107 type: string description: 'The time that the alert was last updated in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.' format: date-time readOnly: true - url: &101 + url: &104 type: string description: The REST API URL of the alert resource. format: uri readOnly: true - html_url: &102 + html_url: &105 type: string description: The GitHub URL of the alert resource. format: uri readOnly: true - instances_url: &450 + instances_url: &452 type: string description: The REST API URL for fetching the list of instances for an alert. format: uri readOnly: true - state: &89 + state: &92 type: - string - 'null' @@ -11725,7 +12311,7 @@ paths: - dismissed - fixed - - fixed_at: &106 + fixed_at: &109 type: - string - 'null' @@ -11737,7 +12323,7 @@ paths: anyOf: - type: 'null' - *4 - dismissed_at: &105 + dismissed_at: &108 type: - string - 'null' @@ -11745,7 +12331,7 @@ paths: format: `YYYY-MM-DDTHH:MM:SSZ`.' format: date-time readOnly: true - dismissed_reason: &451 + dismissed_reason: &453 type: - string - 'null' @@ -11756,14 +12342,14 @@ paths: - won't fix - used in tests - - dismissed_comment: &452 + dismissed_comment: &454 type: - string - 'null' description: The dismissal comment associated with the dismissal of the alert. maxLength: 280 - rule: &453 + rule: &455 type: object properties: id: @@ -11824,26 +12410,26 @@ paths: - 'null' description: A link to the documentation for the rule used to detect the alert. - tool: &454 + tool: &456 type: object properties: - name: *87 + name: *90 version: type: - string - 'null' description: The version of the tool used to generate the code scanning analysis. - guid: *88 - most_recent_instance: &455 + guid: *91 + most_recent_instance: &457 type: object properties: - ref: &448 + ref: &450 type: string description: |- The Git reference, formatted as `refs/pull//merge`, `refs/pull//head`, `refs/heads/` or simply ``. - analysis_key: &465 + analysis_key: &467 type: string description: Identifies the configuration under which the analysis was executed. For example, in GitHub Actions @@ -11854,13 +12440,13 @@ paths: the environment in which the analysis that generated this alert instance was performed, such as the language that was analyzed. - category: &466 + category: &468 type: string description: Identifies the configuration under which the analysis was executed. Used to distinguish between multiple analyses for the same tool and commit, but performed on different languages or different parts of the code. - state: *89 + state: *92 commit_sha: type: string message: @@ -11901,7 +12487,7 @@ paths: - test - library - - repository: &95 + repository: &98 title: Simple Repository description: A GitHub repository. type: object @@ -12242,7 +12828,7 @@ paths: - most_recent_instance - repository examples: - default: &232 + default: &234 value: - number: 4 created_at: '2020-02-13T12:29:18Z' @@ -12473,7 +13059,7 @@ paths: headers: Link: *38 '404': *6 - '503': &130 + '503': &133 description: Service unavailable content: application/json: @@ -12517,8 +13103,8 @@ paths: schema: type: integer default: 30 - - *84 - - *85 + - *87 + - *88 responses: '200': description: Response @@ -12526,7 +13112,7 @@ paths: application/json: schema: type: array - items: &90 + items: &93 type: object description: A code security configuration properties: @@ -12894,7 +13480,7 @@ paths: - disabled - not_set default: disabled - code_scanning_default_setup_options: &93 + code_scanning_default_setup_options: &96 type: - object - 'null' @@ -13006,9 +13592,9 @@ paths: description: Successfully created code security configuration content: application/json: - schema: *90 + schema: *93 examples: - default: &91 + default: &94 value: id: 1325 target_type: enterprise @@ -13066,7 +13652,7 @@ paths: description: Response content: application/json: - schema: &234 + schema: &236 type: array description: A list of default code security configurations items: @@ -13080,9 +13666,9 @@ paths: description: The visibility of newly created repositories for which the code security configuration will be applied to by default - configuration: *90 + configuration: *93 examples: - default: &235 + default: &237 value: - default_for_new_repos: public configuration: @@ -13167,7 +13753,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#retrieve-a-code-security-configuration-of-an-enterprise parameters: - *39 - - &92 + - &95 name: configuration_id description: The unique identifier of the code security configuration. in: path @@ -13179,9 +13765,9 @@ paths: description: Response content: application/json: - schema: *90 + schema: *93 examples: - default: *91 + default: *94 '304': *35 '403': *27 '404': *6 @@ -13206,7 +13792,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#update-a-custom-code-security-configuration-for-an-enterprise parameters: - *39 - - *92 + - *95 requestBody: required: true content: @@ -13276,7 +13862,7 @@ paths: - enabled - disabled - not_set - code_scanning_default_setup_options: *93 + code_scanning_default_setup_options: *96 code_scanning_delegated_alert_dismissal: type: string description: The enablement status of code scanning delegated alert @@ -13357,13 +13943,13 @@ paths: description: Response content: application/json: - schema: *90 + schema: *93 examples: - default: *91 + default: *94 '304': *35 '403': *27 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -13387,14 +13973,14 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#delete-a-code-security-configuration-for-an-enterprise parameters: - *39 - - *92 + - *95 responses: - '204': &116 + '204': &119 description: A header with no content is returned. '400': *14 '403': *27 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -13419,7 +14005,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#attach-an-enterprise-configuration-to-repositories parameters: - *39 - - *92 + - *95 requestBody: required: true content: @@ -13446,7 +14032,7 @@ paths: '202': *37 '403': *27 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -13471,7 +14057,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#set-a-code-security-configuration-as-a-default-for-an-enterprise parameters: - *39 - - *92 + - *95 requestBody: required: true content: @@ -13511,12 +14097,12 @@ paths: - none - private_and_internal - public - configuration: *90 + configuration: *93 examples: default: value: default_for_new_repos: all - configuration: &233 + configuration: &235 value: id: 1325 target_type: organization @@ -13571,7 +14157,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#get-repositories-associated-with-an-enterprise-code-security-configuration parameters: - *39 - - *92 + - *95 - name: per_page description: The number of results per page (max 100). For more information, see "[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api)." @@ -13580,8 +14166,8 @@ paths: schema: type: integer default: 30 - - *84 - - *85 + - *87 + - *88 - name: status description: |- A comma-separated list of statuses. If specified, only repositories with these attachment statuses will be returned. @@ -13599,7 +14185,7 @@ paths: application/json: schema: type: array - items: &236 + items: &238 type: object description: Repositories associated with a code security configuration and attachment status @@ -13617,13 +14203,13 @@ paths: - failed - updating - removed_by_enterprise - repository: *95 + repository: *98 examples: default: summary: Example of code security configuration repositories value: - status: attached - repository: &237 + repository: &239 value: id: 1296269 node_id: MDEwOlJlcG9zaXRvcnkxMjk2MjY5 @@ -14106,7 +14692,7 @@ paths: or enterprise teams are only counted once. seats: type: array - items: &107 + items: &110 title: Copilot Business Seat Detail description: Information about a Copilot Business seat assignment for a user, team, or organization. @@ -14124,7 +14710,7 @@ paths: description: The team through which the assignee is granted access to GitHub Copilot, if applicable. oneOf: - - &224 + - &226 title: Team description: Groups of organization members that gives permissions on specified repositories. @@ -14183,7 +14769,7 @@ paths: parent: anyOf: - type: 'null' - - &297 + - &299 title: Team Simple description: Groups of organization members that gives permissions on specified repositories. @@ -14391,7 +14977,7 @@ paths: - created_at additionalProperties: false examples: - default: &108 + default: &111 value: total_seats: 2 seats: @@ -14460,7 +15046,7 @@ paths: site_admin: false headers: Link: *38 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -14522,7 +15108,7 @@ paths: application/json: schema: type: array - items: &134 + items: &137 title: Copilot Usage Metrics description: Copilot usage metrics for a given day. type: object @@ -14837,7 +15423,7 @@ paths: - date additionalProperties: true examples: - default: &135 + default: &138 value: - date: '2024-06-24' total_active_users: 24 @@ -14936,10 +15522,10 @@ paths: custom_model_training_date: '2024-02-01' total_pr_summaries_created: 10 total_engaged_users: 4 - '500': *83 + '500': *86 '403': *27 '404': *6 - '422': &136 + '422': &139 description: Copilot Usage Merics API setting is disabled at the organization or enterprise level. content: @@ -14969,7 +15555,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/alerts#list-dependabot-alerts-for-an-enterprise parameters: - *39 - - &244 + - &246 name: state in: query description: |- @@ -14978,7 +15564,7 @@ paths: Can be: `auto_dismissed`, `dismissed`, `fixed`, `open` schema: type: string - - &245 + - &247 name: severity in: query description: |- @@ -14987,7 +15573,7 @@ paths: Can be: `low`, `medium`, `high`, `critical` schema: type: string - - &246 + - &248 name: ecosystem in: query description: |- @@ -14996,14 +15582,14 @@ paths: Can be: `composer`, `go`, `maven`, `npm`, `nuget`, `pip`, `pub`, `rubygems`, `rust` schema: type: string - - &247 + - &249 name: package in: query description: A comma-separated list of package names. If specified, only alerts for these packages will be returned. schema: type: string - - &248 + - &250 name: epss_percentage in: query description: |- @@ -15015,7 +15601,7 @@ paths: Filters the list of alerts based on EPSS percentages. If specified, only alerts with the provided EPSS percentages will be returned. schema: type: string - - &249 + - &251 name: has in: query description: |- @@ -15029,7 +15615,7 @@ paths: type: string enum: - patch - - &250 + - &252 name: scope in: query description: The scope of the vulnerable dependency. If specified, only alerts @@ -15039,7 +15625,7 @@ paths: enum: - development - runtime - - &251 + - &253 name: sort in: query description: |- @@ -15054,10 +15640,10 @@ paths: - updated - epss_percentage default: created - - *86 - - *84 - - *85 - - &252 + - *89 + - *87 + - *88 + - &254 name: first description: |- **Deprecated**. The number of results per page (max 100), starting from the first matching result. @@ -15070,7 +15656,7 @@ paths: minimum: 1 maximum: 100 default: 30 - - &253 + - &255 name: last description: |- **Deprecated**. The number of results per page (max 100), starting from the last matching result. @@ -15090,11 +15676,11 @@ paths: application/json: schema: type: array - items: &254 + items: &256 type: object description: A Dependabot alert. properties: - number: *96 + number: *99 state: type: string description: The state of the Dependabot alert. @@ -15109,7 +15695,7 @@ paths: description: Details for the vulnerable dependency. readOnly: true properties: - package: &97 + package: &100 type: object description: Details for the vulnerable package. readOnly: true @@ -15157,7 +15743,7 @@ paths: - direct - transitive - - security_advisory: &502 + security_advisory: &504 type: object description: Details for the GitHub Security Advisory. readOnly: true @@ -15188,13 +15774,13 @@ paths: description: Vulnerable version range information for the advisory. readOnly: true - items: &100 + items: &103 type: object description: Details pertaining to one vulnerable version range for the advisory. readOnly: true properties: - package: *97 + package: *100 severity: type: string description: The severity of the vulnerability. @@ -15262,8 +15848,8 @@ paths: - score - vector_string additionalProperties: false - cvss_severities: *98 - epss: *99 + cvss_severities: *101 + epss: *102 cwes: type: array description: Details for the advisory pertaining to Common @@ -15363,12 +15949,12 @@ paths: - updated_at - withdrawn_at additionalProperties: false - security_vulnerability: *100 - url: *101 - html_url: *102 - created_at: *103 - updated_at: *104 - dismissed_at: *105 + security_vulnerability: *103 + url: *104 + html_url: *105 + created_at: *106 + updated_at: *107 + dismissed_at: *108 dismissed_by: anyOf: - type: 'null' @@ -15392,8 +15978,8 @@ paths: description: An optional comment associated with the alert's dismissal. maxLength: 280 - fixed_at: *106 - auto_dismissed_at: &503 + fixed_at: *109 + auto_dismissed_at: &505 type: - string - 'null' @@ -15401,7 +15987,7 @@ paths: ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.' format: date-time readOnly: true - repository: *95 + repository: *98 required: - number - state @@ -15420,7 +16006,7 @@ paths: - repository additionalProperties: false examples: - default: &255 + default: &257 value: - number: 2 state: dismissed @@ -15837,7 +16423,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/copilot/copilot-user-management#get-copilot-seat-assignment-details-for-an-enterprise-user parameters: - *39 - - &215 + - &217 name: username description: The handle for the GitHub user account. in: path @@ -15859,10 +16445,10 @@ paths: teams or multiple organizations are only counted once. seats: type: array - items: *107 + items: *110 examples: - default: *108 - '500': *83 + default: *111 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -15904,7 +16490,7 @@ paths: type: integer network_configurations: type: array - items: &109 + items: &112 title: Hosted compute network configuration description: A hosted compute network configuration. type: object @@ -15949,7 +16535,7 @@ paths: - name - created_on examples: - default: &345 + default: &347 value: total_count: 2 network_configurations: @@ -16027,9 +16613,9 @@ paths: description: Response content: application/json: - schema: *109 + schema: *112 examples: - default: &110 + default: &113 value: id: 123456789ABCDEF name: My network configuration @@ -16056,7 +16642,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/network-configurations#get-a-hosted-compute-network-configuration-for-an-enterprise parameters: - *39 - - &111 + - &114 name: network_configuration_id description: Unique identifier of the hosted compute network configuration. in: path @@ -16068,9 +16654,9 @@ paths: description: Response content: application/json: - schema: *109 + schema: *112 examples: - default: *110 + default: *113 headers: Link: *38 x-github: @@ -16090,7 +16676,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/network-configurations#update-a-hosted-compute-network-configuration-for-an-enterprise parameters: - *39 - - *111 + - *114 requestBody: required: true content: @@ -16129,9 +16715,9 @@ paths: description: Response content: application/json: - schema: *109 + schema: *112 examples: - default: *110 + default: *113 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -16149,7 +16735,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/network-configurations#delete-a-hosted-compute-network-configuration-from-an-enterprise parameters: - *39 - - *111 + - *114 responses: '204': description: Response @@ -16172,7 +16758,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/network-configurations#get-a-hosted-compute-network-settings-resource-for-an-enterprise parameters: - *39 - - &346 + - &348 name: network_settings_id description: Unique identifier of the hosted compute network settings. in: path @@ -16184,7 +16770,7 @@ paths: description: Response content: application/json: - schema: &347 + schema: &349 title: Hosted compute network settings resource description: A hosted compute network settings resource. type: object @@ -16223,7 +16809,7 @@ paths: - subnet_id - region examples: - default: &348 + default: &350 value: id: 220F78DACB92BBFBC5E6F22DE1CCF52309D network_configuration_id: 934E208B3EE0BD60CF5F752C426BFB53562 @@ -16258,7 +16844,7 @@ paths: application/json: schema: type: array - items: &112 + items: &115 title: Organization Custom Property description: Custom property defined on an organization type: object @@ -16334,7 +16920,7 @@ paths: - property_name - value_type examples: - default: &113 + default: &116 value: - property_name: environment url: https://api.github.com/orgs/github/properties/schema/environment @@ -16391,7 +16977,7 @@ paths: properties: type: array description: The array of custom properties to create or update. - items: *112 + items: *115 minItems: 1 maxItems: 100 required: @@ -16421,9 +17007,9 @@ paths: application/json: schema: type: array - items: *112 + items: *115 examples: - default: *113 + default: *116 '403': *27 '404': *6 x-github: @@ -16446,14 +17032,8 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/custom-properties#promote-a-custom-property-to-an-enterprise parameters: - *39 - - &167 - name: org - description: The organization name. The name is not case sensitive. - in: path - required: true - schema: - type: string - - &114 + - *71 + - &117 name: custom_property_name description: The custom property name in: path @@ -16465,9 +17045,9 @@ paths: description: Response content: application/json: - schema: *112 + schema: *115 examples: - default: &115 + default: &118 value: property_name: environment url: https://api.github.com/orgs/github/properties/schema/environment @@ -16500,15 +17080,15 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/custom-properties#get-a-custom-property-for-an-enterprise parameters: - *39 - - *114 + - *117 responses: '200': description: Response content: application/json: - schema: *112 + schema: *115 examples: - default: *115 + default: *118 '403': *27 '404': *6 x-github: @@ -16530,12 +17110,12 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/custom-properties#create-or-update-a-custom-property-for-an-enterprise parameters: - *39 - - *114 + - *117 requestBody: required: true content: application/json: - schema: &316 + schema: &318 title: Custom Property Set Payload description: Custom property set payload type: object @@ -16608,9 +17188,9 @@ paths: description: Response content: application/json: - schema: *112 + schema: *115 examples: - default: *115 + default: *118 '403': *27 '404': *6 x-github: @@ -16632,9 +17212,9 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/custom-properties#remove-a-custom-property-for-an-enterprise parameters: - *39 - - *114 + - *117 responses: - '204': *116 + '204': *119 '403': *27 '404': *6 x-github: @@ -16674,7 +17254,7 @@ paths: - push - repository default: branch - enforcement: &123 + enforcement: &126 type: string description: The enforcement level of the ruleset. `evaluate` allows admins to test rules before enforcing them. Admins can view insights @@ -16687,7 +17267,7 @@ paths: bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: &124 + items: &127 title: Repository Ruleset Bypass Actor type: object description: An actor that can bypass rules in a ruleset @@ -16725,7 +17305,7 @@ paths: - always - pull_request default: always - conditions: &128 + conditions: &131 title: Enterprise ruleset conditions type: object description: Conditions for an enterprise ruleset. The conditions @@ -16739,7 +17319,7 @@ paths: description: Conditions to target organizations by name and all repositories allOf: - - &117 + - &120 title: Repository ruleset conditions for organization names type: object description: Parameters for an organization name condition @@ -16765,7 +17345,7 @@ paths: type: string required: - organization_name - - &120 + - &123 title: Repository ruleset conditions for repository names type: object description: Parameters for a repository name condition @@ -16794,7 +17374,7 @@ paths: is prevented. required: - repository_name - - &119 + - &122 title: Repository ruleset conditions for ref names type: object description: Parameters for a repository ruleset ref name condition @@ -16822,8 +17402,8 @@ paths: description: Conditions to target organizations by name and repositories by property allOf: - - *117 - - &122 + - *120 + - &125 title: Repository ruleset conditions for repository properties type: object description: Parameters for a repository property condition @@ -16836,7 +17416,7 @@ paths: description: The repository properties and values to include. All of these properties must match for the condition to pass. - items: &118 + items: &121 title: Repository ruleset property targeting definition type: object description: Parameters for a targeting a repository @@ -16867,16 +17447,16 @@ paths: description: The repository properties and values to exclude. The condition will not pass if any of these properties match. - items: *118 + items: *121 required: - repository_property - - *119 + - *122 - type: object title: organization_id_and_repository_name description: Conditions to target organizations by id and all repositories allOf: - - &121 + - &124 title: Repository ruleset conditions for organization IDs type: object description: Parameters for an organization ID condition @@ -16893,25 +17473,25 @@ paths: type: integer required: - organization_id - - *120 - - *119 + - *123 + - *122 - type: object title: organization_id_and_repository_property description: Conditions to target organization by id and repositories by property allOf: - - *121 + - *124 + - *125 - *122 - - *119 rules: type: array description: An array of rules within the ruleset. - items: &125 + items: &128 title: Repository Rule type: object description: A repository rule. oneOf: - - &618 + - &620 title: creation description: Only allow users with bypass permission to create matching refs. @@ -16923,7 +17503,7 @@ paths: type: string enum: - creation - - &619 + - &621 title: update description: Only allow users with bypass permission to update matching refs. @@ -16944,7 +17524,7 @@ paths: repository required: - update_allows_fetch_and_merge - - &621 + - &623 title: deletion description: Only allow users with bypass permissions to delete matching refs. @@ -16956,7 +17536,7 @@ paths: type: string enum: - deletion - - &622 + - &624 title: required_linear_history description: Prevent merge commits from being pushed to matching refs. @@ -16968,7 +17548,7 @@ paths: type: string enum: - required_linear_history - - &623 + - &625 title: merge_queue description: Merges must be performed via a merge queue. type: object @@ -17044,7 +17624,7 @@ paths: - merge_method - min_entries_to_merge - min_entries_to_merge_wait_minutes - - &624 + - &626 title: required_deployments description: Choose which environments must be successfully deployed to before refs can be pushed into a ref that matches @@ -17068,7 +17648,7 @@ paths: type: string required: - required_deployment_environments - - &625 + - &627 title: required_signatures description: Commits pushed to matching refs must have verified signatures. @@ -17080,7 +17660,7 @@ paths: type: string enum: - required_signatures - - &626 + - &628 title: pull_request description: Require all commits be made to a non-target branch and submitted via a pull request before they can be merged. @@ -17140,7 +17720,7 @@ paths: - require_last_push_approval - required_approving_review_count - required_review_thread_resolution - - &627 + - &629 title: required_status_checks description: Choose which status checks must pass before the ref is updated. When enabled, commits must first be pushed @@ -17187,7 +17767,7 @@ paths: required: - required_status_checks - strict_required_status_checks_policy - - &628 + - &630 title: non_fast_forward description: Prevent users with push access from force pushing to refs. @@ -17199,7 +17779,7 @@ paths: type: string enum: - non_fast_forward - - &629 + - &631 title: commit_message_pattern description: Parameters to be used for the commit_message_pattern rule @@ -17235,7 +17815,7 @@ paths: required: - operator - pattern - - &630 + - &632 title: commit_author_email_pattern description: Parameters to be used for the commit_author_email_pattern rule @@ -17271,7 +17851,7 @@ paths: required: - operator - pattern - - &631 + - &633 title: committer_email_pattern description: Parameters to be used for the committer_email_pattern rule @@ -17307,7 +17887,7 @@ paths: required: - operator - pattern - - &632 + - &634 title: branch_name_pattern description: Parameters to be used for the branch_name_pattern rule @@ -17343,7 +17923,7 @@ paths: required: - operator - pattern - - &633 + - &635 title: tag_name_pattern description: Parameters to be used for the tag_name_pattern rule @@ -17379,7 +17959,7 @@ paths: required: - operator - pattern - - &634 + - &636 title: file_path_restriction description: Prevent commits that include changes in specified file and folder paths from being pushed to the commit graph. @@ -17403,7 +17983,7 @@ paths: type: string required: - restricted_file_paths - - &635 + - &637 title: max_file_path_length description: Prevent commits that include file paths that exceed the specified character limit from being pushed to the commit @@ -17427,7 +18007,7 @@ paths: maximum: 32767 required: - max_file_path_length - - &636 + - &638 title: file_extension_restriction description: Prevent commits that include files with specified file extensions from being pushed to the commit graph. @@ -17450,7 +18030,7 @@ paths: type: string required: - restricted_file_extensions - - &637 + - &639 title: max_file_size description: Prevent commits with individual files that exceed the specified limit from being pushed to the commit graph. @@ -17474,7 +18054,7 @@ paths: maximum: 100 required: - max_file_size - - &638 + - &640 title: workflows description: Require all changes made to a targeted branch to pass the specified workflows before they can be merged. @@ -17523,7 +18103,7 @@ paths: - repository_id required: - workflows - - &639 + - &641 title: code_scanning description: Choose which tools must provide code scanning results before the reference is updated. When configured, code scanning @@ -17609,7 +18189,7 @@ paths: description: Response content: application/json: - schema: &126 + schema: &129 title: Repository ruleset type: object description: A set of rules to apply when specified conditions are @@ -17644,11 +18224,11 @@ paths: source: type: string description: The name of the source - enforcement: *123 + enforcement: *126 bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: *124 + items: *127 current_user_can_bypass: type: string description: |- @@ -17679,8 +18259,8 @@ paths: description: The html URL of the ruleset conditions: anyOf: - - *119 - - &321 + - *122 + - &323 title: Organization ruleset conditions type: object description: |- @@ -17694,14 +18274,14 @@ paths: description: Conditions to target repositories by name and refs by name allOf: - - *119 - - *120 + - *122 + - *123 - type: object title: repository_id_and_ref_name description: Conditions to target repositories by id and refs by name allOf: - - *119 + - *122 - title: Repository ruleset conditions for repository IDs type: object description: Parameters for a repository ID condition @@ -17723,14 +18303,14 @@ paths: description: Conditions to target repositories by property and refs by name allOf: - - *119 - *122 + - *125 type: - 'null' - object rules: type: array - items: *125 + items: *128 created_at: type: string format: date-time @@ -17738,7 +18318,7 @@ paths: type: string format: date-time examples: - default: &127 + default: &130 value: id: 21 name: super cool ruleset @@ -17764,7 +18344,7 @@ paths: created_at: '2024-08-15T08:43:03Z' updated_at: '2024-09-23T16:29:47Z' '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -17797,11 +18377,11 @@ paths: description: Response content: application/json: - schema: *126 + schema: *129 examples: - default: *127 + default: *130 '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -17843,16 +18423,16 @@ paths: - tag - push - repository - enforcement: *123 + enforcement: *126 bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: *124 - conditions: *128 + items: *127 + conditions: *131 rules: description: An array of rules within the ruleset. type: array - items: *125 + items: *128 examples: default: value: @@ -17876,11 +18456,11 @@ paths: description: Response content: application/json: - schema: *126 + schema: *129 examples: - default: *127 + default: *130 '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -17907,7 +18487,7 @@ paths: '204': description: Response '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -17940,7 +18520,7 @@ paths: application/json: schema: type: array - items: &129 + items: &132 title: Ruleset version type: object description: The historical version of a ruleset @@ -17964,7 +18544,7 @@ paths: type: string format: date-time examples: - default: &323 + default: &325 value: - version_id: 3 actor: @@ -17982,7 +18562,7 @@ paths: type: User updated_at: '2024-08-23T16:29:47Z' '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -18017,9 +18597,9 @@ paths: description: Response content: application/json: - schema: &324 + schema: &326 allOf: - - *129 + - *132 - type: object required: - state @@ -18052,7 +18632,7 @@ paths: rules: - type: repository_delete '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -18072,7 +18652,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/secret-scanning/secret-scanning#list-secret-scanning-alerts-for-an-enterprise parameters: - *39 - - &325 + - &327 name: state in: query description: Set to `open` or `resolved` to only list secret scanning alerts @@ -18083,7 +18663,7 @@ paths: enum: - open - resolved - - &326 + - &328 name: secret_type in: query description: A comma-separated list of secret types to return. All default @@ -18093,7 +18673,7 @@ paths: required: false schema: type: string - - &327 + - &329 name: resolution in: query description: A comma-separated list of resolutions. Only secret scanning alerts @@ -18102,7 +18682,7 @@ paths: required: false schema: type: string - - &328 + - &330 name: sort description: The property to sort the results by. `created` means when the alert was created. `updated` means when the alert was updated or resolved. @@ -18114,11 +18694,11 @@ paths: - created - updated default: created - - *86 + - *89 - *17 - - *84 - - *85 - - &329 + - *87 + - *88 + - &331 name: validity in: query description: A comma-separated list of validities that, when present, will @@ -18127,7 +18707,7 @@ paths: required: false schema: type: string - - &330 + - &332 name: is_publicly_leaked in: query description: A boolean value representing whether or not to filter alerts @@ -18136,7 +18716,7 @@ paths: schema: type: boolean default: false - - &331 + - &333 name: is_multi_repo in: query description: A boolean value representing whether or not to filter alerts @@ -18145,7 +18725,7 @@ paths: schema: type: boolean default: false - - &332 + - &334 name: hide_secret in: query description: A boolean value representing whether or not to hide literal secrets @@ -18161,30 +18741,30 @@ paths: application/json: schema: type: array - items: &333 + items: &335 type: object properties: - number: *96 - created_at: *103 + number: *99 + created_at: *106 updated_at: anyOf: - type: 'null' - - *104 - url: *101 - html_url: *102 + - *107 + url: *104 + html_url: *105 locations_url: type: string format: uri description: The REST API URL of the code locations for this alert. - state: &652 + state: &654 description: Sets the state of the secret scanning alert. You must provide `resolution` when you set the state to `resolved`. type: string enum: - open - resolved - resolution: &653 + resolution: &655 type: - string - 'null' @@ -18218,7 +18798,7 @@ paths: secret: type: string description: The secret that was detected. - repository: *95 + repository: *98 push_protection_bypassed: type: - boolean @@ -18291,14 +18871,14 @@ paths: first_location_detected: anyOf: - type: 'null' - - &654 + - &656 description: 'Details on the location where the token was initially detected. This can be a commit, wiki commit, issue, discussion, pull request. ' oneOf: - - &656 + - &658 description: Represents a 'commit' secret scanning location type. This location type shows that a secret was detected inside a commit to a repository. @@ -18355,7 +18935,7 @@ paths: - blob_url - commit_sha - commit_url - - &657 + - &659 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. @@ -18416,7 +18996,7 @@ paths: - page_url - commit_sha - commit_url - - &658 + - &660 description: Represents an 'issue_title' secret scanning location type. This location type shows that a secret was detected in the title of an issue. @@ -18431,7 +19011,7 @@ paths: - https://api.github.com/repos/octocat/Hello-World/issues/1347 required: - issue_title_url - - &659 + - &661 description: Represents an 'issue_body' secret scanning location type. This location type shows that a secret was detected in the body of an issue. @@ -18446,7 +19026,7 @@ paths: - https://api.github.com/repos/octocat/Hello-World/issues/1347 required: - issue_body_url - - &660 + - &662 description: Represents an 'issue_comment' secret scanning location type. This location type shows that a secret was detected in a comment on an issue. @@ -18461,7 +19041,7 @@ paths: - https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451 required: - issue_comment_url - - &661 + - &663 description: Represents a 'discussion_title' secret scanning location type. This location type shows that a secret was detected in the title of a discussion. @@ -18476,7 +19056,7 @@ paths: - https://github.com/community/community/discussions/39082 required: - discussion_title_url - - &662 + - &664 description: Represents a 'discussion_body' secret scanning location type. This location type shows that a secret was detected in the body of a discussion. @@ -18491,7 +19071,7 @@ paths: - https://github.com/community/community/discussions/39082#discussion-4566270 required: - discussion_body_url - - &663 + - &665 description: Represents a 'discussion_comment' secret scanning location type. This location type shows that a secret was detected in a comment on a discussion. @@ -18506,7 +19086,7 @@ paths: - https://github.com/community/community/discussions/39082#discussioncomment-4158232 required: - discussion_comment_url - - &664 + - &666 description: Represents a 'pull_request_title' secret scanning location type. This location type shows that a secret was detected in the title of a pull request. @@ -18521,7 +19101,7 @@ paths: - https://api.github.com/repos/octocat/Hello-World/pulls/2846 required: - pull_request_title_url - - &665 + - &667 description: Represents a 'pull_request_body' secret scanning location type. This location type shows that a secret was detected in the body of a pull request. @@ -18536,7 +19116,7 @@ paths: - https://api.github.com/repos/octocat/Hello-World/pulls/2846 required: - pull_request_body_url - - &666 + - &668 description: Represents a 'pull_request_comment' secret scanning location type. This location type shows that a secret was detected in a comment on a pull request. @@ -18551,7 +19131,7 @@ paths: - https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451 required: - pull_request_comment_url - - &667 + - &669 description: Represents a 'pull_request_review' secret scanning location type. This location type shows that a secret was detected in a review on a pull request. @@ -18566,7 +19146,7 @@ paths: - https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80 required: - pull_request_review_url - - &668 + - &670 description: Represents a 'pull_request_review_comment' secret scanning location type. This location type shows that a secret was detected in a review comment on a pull @@ -18587,7 +19167,7 @@ paths: description: A boolean value representing whether or not the token in the alert was detected in more than one location. examples: - default: &334 + default: &336 value: - number: 2 created_at: '2020-11-06T18:48:51Z' @@ -18838,7 +19418,7 @@ paths: headers: Link: *38 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -18869,7 +19449,7 @@ paths: description: Response content: application/json: - schema: &336 + schema: &338 type: object properties: total_minutes_used: @@ -18939,7 +19519,7 @@ paths: - included_minutes - minutes_used_breakdown examples: - default: &337 + default: &339 value: total_minutes_used: 305 total_paid_minutes_used: 0 @@ -18970,7 +19550,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#get-github-advanced-security-active-committers-for-an-enterprise parameters: - *39 - - &338 + - &340 name: advanced_security_product in: query description: | @@ -18990,7 +19570,7 @@ paths: description: Success content: application/json: - schema: &339 + schema: &341 type: object properties: total_advanced_security_committers: @@ -19053,7 +19633,7 @@ paths: required: - repositories examples: - default: &340 + default: &342 value: total_advanced_security_committers: 2 total_count: 2 @@ -19149,8 +19729,8 @@ paths: name: octocat/hello-world '400': *14 '403': *27 - '500': *83 - '503': *130 + '500': *86 + '503': *133 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -19169,7 +19749,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#get-a-cost-center-by-id parameters: - *39 - - &133 + - &136 name: cost_center_id description: The ID corresponding to the cost center. in: path @@ -19181,7 +19761,7 @@ paths: description: Response when getting a cost center content: application/json: - schema: &131 + schema: &134 type: object properties: id: @@ -19209,7 +19789,7 @@ paths: - name - resources examples: - default: &132 + default: &135 value: - id: 2eeb8ffe-6903-11ee-8c99-0242ac120002 name: Cost Center Name @@ -19220,8 +19800,8 @@ paths: name: octocat/hello-world '400': *14 '403': *27 - '500': *83 - '503': *130 + '500': *86 + '503': *133 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -19271,15 +19851,15 @@ paths: description: Response when updating a cost center content: application/json: - schema: *131 + schema: *134 examples: - default: *132 + default: *135 '400': *14 '403': *27 '404': *6 - '409': *94 - '500': *83 - '503': *130 + '409': *97 + '500': *86 + '503': *133 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -19297,7 +19877,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#delete-a-cost-center parameters: - *39 - - *133 + - *136 responses: '200': description: Response when deleting a cost center @@ -19335,8 +19915,8 @@ paths: '400': *14 '404': *6 '403': *27 - '500': *83 - '503': *130 + '500': *86 + '503': *133 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -19357,7 +19937,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#add-users-to-a-cost-center parameters: - *39 - - *133 + - *136 requestBody: required: true content: @@ -19392,9 +19972,9 @@ paths: message: Resources successfully added to the cost center. '400': *14 '403': *27 - '409': *94 - '500': *83 - '503': *130 + '409': *97 + '500': *86 + '503': *133 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -19414,7 +19994,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#remove-users-from-a-cost-center parameters: - *39 - - *133 + - *136 requestBody: required: true content: @@ -19450,8 +20030,8 @@ paths: message: Resources successfully removed from the cost center. '400': *14 '403': *27 - '500': *83 - '503': *130 + '500': *86 + '503': *133 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -19482,7 +20062,7 @@ paths: description: Response content: application/json: - schema: &341 + schema: &343 type: object properties: total_gigabytes_bandwidth_used: @@ -19500,7 +20080,7 @@ paths: - total_paid_gigabytes_bandwidth_used - included_gigabytes_bandwidth examples: - default: &342 + default: &344 value: total_gigabytes_bandwidth_used: 50 total_paid_gigabytes_bandwidth_used: 40 @@ -19535,7 +20115,7 @@ paths: description: Response content: application/json: - schema: &343 + schema: &345 type: object properties: days_left_in_billing_cycle: @@ -19553,7 +20133,7 @@ paths: - estimated_paid_storage_for_month - estimated_storage_for_month examples: - default: &344 + default: &346 value: days_left_in_billing_cycle: 20 estimated_paid_storage_for_month: 15 @@ -19578,7 +20158,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#get-billing-usage-report-for-an-enterprise parameters: - *39 - - &168 + - &170 name: year description: If specified, only return results for a single year. The value of `year` is an integer with four digits representing a year. For example, @@ -19587,7 +20167,7 @@ paths: required: false schema: type: integer - - &169 + - &171 name: month description: If specified, only return results for a single month. The value of `month` is an integer between `1` and `12`. If no year is specified the @@ -19596,7 +20176,7 @@ paths: required: false schema: type: integer - - &170 + - &172 name: day description: If specified, only return results for a single day. The value of `day` is an integer between `1` and `31`. If no `year` or `month` is @@ -19605,7 +20185,7 @@ paths: required: false schema: type: integer - - &171 + - &173 name: hour description: If specified, only return results for a single hour. The value of `hour` is an integer between `0` and `23`. If no `year`, `month`, or @@ -19626,7 +20206,7 @@ paths: description: Response when getting a billing usage report content: application/json: - schema: &172 + schema: &174 type: object properties: usageItems: @@ -19679,7 +20259,7 @@ paths: - netAmount - organizationName examples: - default: &173 + default: &175 value: usageItems: - date: '2023-08-01' @@ -19695,8 +20275,8 @@ paths: repositoryName: github/example '400': *14 '403': *27 - '500': *83 - '503': *130 + '500': *86 + '503': *133 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -19767,13 +20347,13 @@ paths: application/json: schema: type: array - items: *134 + items: *137 examples: - default: *135 - '500': *83 + default: *138 + '500': *86 '403': *27 '404': *6 - '422': *136 + '422': *139 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -19862,7 +20442,7 @@ paths: application/json: schema: type: array - items: &162 + items: &165 title: Event description: Event type: object @@ -19873,7 +20453,7 @@ paths: type: - string - 'null' - actor: &137 + actor: &140 title: Actor description: Actor type: object @@ -19914,13 +20494,13 @@ paths: - id - name - url - org: *137 + org: *140 payload: type: object properties: action: type: string - issue: &151 + issue: &154 title: Issue description: Issues are a great way to keep track of tasks, enhancements, and bugs for your projects. @@ -20040,7 +20620,7 @@ paths: milestone: anyOf: - type: 'null' - - &490 + - &492 title: Milestone description: A collection of related issues and pull requests. @@ -20212,7 +20792,7 @@ paths: timeline_url: type: string format: uri - type: &282 + type: &284 title: Issue Type description: The type of issue. type: @@ -20270,7 +20850,7 @@ paths: anyOf: - type: 'null' - *5 - author_association: &138 + author_association: &141 title: author_association type: string description: How the author is associated with the repository. @@ -20285,7 +20865,7 @@ paths: - OWNER examples: - OWNER - reactions: &139 + reactions: &142 title: Reaction Rollup type: object properties: @@ -20357,7 +20937,7 @@ paths: - author_association - created_at - updated_at - comment: &558 + comment: &560 title: Issue Comment description: Comments provide a way for people to collaborate on an issue. @@ -20407,12 +20987,12 @@ paths: issue_url: type: string format: uri - author_association: *138 + author_association: *141 performed_via_github_app: anyOf: - type: 'null' - *5 - reactions: *139 + reactions: *142 required: - id - node_id @@ -20509,7 +21089,7 @@ paths: created_at: '2022-06-07T07:50:26Z' '304': *35 '403': *27 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -20599,7 +21179,7 @@ paths: _links: type: object properties: - timeline: &140 + timeline: &143 title: Link With Type description: Hypermedia Link with Type type: object @@ -20611,17 +21191,17 @@ paths: required: - href - type - user: *140 - security_advisories: *140 - current_user: *140 - current_user_public: *140 - current_user_actor: *140 - current_user_organization: *140 + user: *143 + security_advisories: *143 + current_user: *143 + current_user_public: *143 + current_user_actor: *143 + current_user_organization: *143 current_user_organizations: type: array - items: *140 - repository_discussions: *140 - repository_discussions_category: *140 + items: *143 + repository_discussions: *143 + repository_discussions_category: *143 required: - timeline - user @@ -20683,7 +21263,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#list-gists-for-the-authenticated-user parameters: - - *141 + - *144 - *17 - *19 responses: @@ -20693,7 +21273,7 @@ paths: application/json: schema: type: array - items: &142 + items: &145 title: Base Gist description: Base Gist type: object @@ -20790,7 +21370,7 @@ paths: - created_at - updated_at examples: - default: &143 + default: &146 value: - url: https://api.github.com/gists/aa5a315d61ae9438b18d forks_url: https://api.github.com/gists/aa5a315d61ae9438b18d/forks @@ -20914,7 +21494,7 @@ paths: description: Response content: application/json: - schema: &144 + schema: &147 title: Gist Simple description: Gist Simple type: object @@ -20932,7 +21512,7 @@ paths: url: type: string format: uri - user: &723 + user: &725 title: Public User description: Public User type: object @@ -21306,7 +21886,7 @@ paths: truncated: type: boolean examples: - default: &145 + default: &148 value: url: https://api.github.com/gists/2decf6c462d9b4418f2 forks_url: https://api.github.com/gists/2decf6c462d9b4418f2/forks @@ -21410,7 +21990,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#list-public-gists parameters: - - *141 + - *144 - *17 - *19 responses: @@ -21420,9 +22000,9 @@ paths: application/json: schema: type: array - items: *142 + items: *145 examples: - default: *143 + default: *146 headers: Link: *38 '422': *15 @@ -21444,7 +22024,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#list-starred-gists parameters: - - *141 + - *144 - *17 - *19 responses: @@ -21454,9 +22034,9 @@ paths: application/json: schema: type: array - items: *142 + items: *145 examples: - default: *143 + default: *146 headers: Link: *38 '401': *23 @@ -21484,7 +22064,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#get-a-gist parameters: - - &146 + - &149 name: gist_id description: The unique identifier of the gist. in: path @@ -21496,10 +22076,10 @@ paths: description: Response content: application/json: - schema: *144 + schema: *147 examples: - default: *145 - '403': &149 + default: *148 + '403': &152 description: Forbidden Gist content: application/json: @@ -21548,7 +22128,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#update-a-gist parameters: - - *146 + - *149 requestBody: required: true content: @@ -21612,9 +22192,9 @@ paths: description: Response content: application/json: - schema: *144 + schema: *147 examples: - updateGist: *145 + updateGist: *148 deleteFile: value: url: https://api.github.com/gists/2decf6c462d9b4418f2 @@ -21772,7 +22352,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#delete-a-gist parameters: - - *146 + - *149 responses: '204': description: Response @@ -21801,7 +22381,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/comments#list-gist-comments parameters: - - *146 + - *149 - *17 - *19 responses: @@ -21811,7 +22391,7 @@ paths: application/json: schema: type: array - items: &147 + items: &150 title: Gist Comment description: A comment made to a gist. type: object @@ -21849,7 +22429,7 @@ paths: format: date-time examples: - '2011-04-18T23:23:56Z' - author_association: *138 + author_association: *141 required: - url - id @@ -21914,7 +22494,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/comments#create-a-gist-comment parameters: - - *146 + - *149 requestBody: required: true content: @@ -21940,9 +22520,9 @@ paths: description: Response content: application/json: - schema: *147 + schema: *150 examples: - default: &148 + default: &151 value: id: 1 node_id: MDExOkdpc3RDb21tZW50MQ== @@ -22000,8 +22580,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/comments#get-a-gist-comment parameters: - - *146 - - &150 + - *149 + - &153 name: comment_id description: The unique identifier of the comment. in: path @@ -22014,12 +22594,12 @@ paths: description: Response content: application/json: - schema: *147 + schema: *150 examples: - default: *148 + default: *151 '304': *35 '404': *6 - '403': *149 + '403': *152 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -22041,8 +22621,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/comments#update-a-gist-comment parameters: - - *146 - - *150 + - *149 + - *153 requestBody: required: true content: @@ -22068,9 +22648,9 @@ paths: description: Response content: application/json: - schema: *147 + schema: *150 examples: - default: *148 + default: *151 '404': *6 x-github: githubCloudOnly: false @@ -22087,8 +22667,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/comments#delete-a-gist-comment parameters: - - *146 - - *150 + - *149 + - *153 responses: '204': description: Response @@ -22111,7 +22691,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#list-gist-commits parameters: - - *146 + - *149 - *17 - *19 responses: @@ -22212,7 +22792,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#list-gist-forks parameters: - - *146 + - *149 - *17 - *19 responses: @@ -22222,7 +22802,7 @@ paths: application/json: schema: type: array - items: *144 + items: *147 examples: default: value: @@ -22287,13 +22867,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#fork-a-gist parameters: - - *146 + - *149 responses: '201': description: Response content: application/json: - schema: *142 + schema: *145 examples: default: value: @@ -22364,7 +22944,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#check-if-a-gist-is-starred parameters: - - *146 + - *149 responses: '204': description: Response if gist is starred @@ -22394,7 +22974,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#star-a-gist parameters: - - *146 + - *149 responses: '204': description: Response @@ -22416,7 +22996,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#unstar-a-gist parameters: - - *146 + - *149 responses: '204': description: Response @@ -22445,7 +23025,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#get-a-gist-revision parameters: - - *146 + - *149 - name: sha in: path required: true @@ -22456,9 +23036,9 @@ paths: description: Response content: application/json: - schema: *144 + schema: *147 examples: - default: *145 + default: *148 '422': *15 '404': *6 '403': *27 @@ -22827,7 +23407,7 @@ paths: - closed - all default: open - - &285 + - &287 name: labels description: 'A list of comma separated label names. Example: `bug,ui,@high`' in: query @@ -22845,8 +23425,8 @@ paths: - updated - comments default: created - - *86 - - *141 + - *89 + - *144 - name: collab in: query required: false @@ -22876,9 +23456,9 @@ paths: application/json: schema: type: array - items: *151 + items: *154 examples: - default: &286 + default: &288 value: - id: 1 node_id: MDU6SXNzdWUx @@ -23158,7 +23738,7 @@ paths: application/json: schema: type: array - items: *152 + items: *155 examples: default: value: @@ -23456,7 +24036,7 @@ paths: example: '279' schema: type: string - X-CommonMarker-Version: &153 + X-CommonMarker-Version: &156 example: 0.17.4 schema: type: string @@ -23511,7 +24091,7 @@ paths: '200': description: Response headers: - X-CommonMarker-Version: *153 + X-CommonMarker-Version: *156 content: text/html: schema: @@ -23540,7 +24120,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/apps/marketplace#get-a-subscription-plan-for-an-account parameters: - - &156 + - &159 name: account_id description: account_id parameter in: path @@ -23552,7 +24132,7 @@ paths: description: Response content: application/json: - schema: &155 + schema: &158 title: Marketplace Purchase description: Marketplace Purchase type: object @@ -23586,7 +24166,7 @@ paths: - 'null' id: type: integer - plan: &154 + plan: &157 title: Marketplace Listing Plan description: Marketplace Listing Plan type: object @@ -23689,7 +24269,7 @@ paths: - 'null' updated_at: type: string - plan: *154 + plan: *157 required: - url - id @@ -23697,7 +24277,7 @@ paths: - login - marketplace_purchase examples: - default: &157 + default: &160 value: url: https://api.github.com/orgs/github type: Organization @@ -23782,9 +24362,9 @@ paths: application/json: schema: type: array - items: *154 + items: *157 examples: - default: &158 + default: &161 value: - url: https://api.github.com/marketplace_listing/plans/1313 accounts_url: https://api.github.com/marketplace_listing/plans/1313/accounts @@ -23824,14 +24404,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/apps/marketplace#list-accounts-for-a-plan parameters: - - &159 + - &162 name: plan_id description: The unique identifier of the plan. in: path required: true schema: type: integer - - &160 + - &163 name: sort description: The property to sort the results by. in: query @@ -23861,9 +24441,9 @@ paths: application/json: schema: type: array - items: *155 + items: *158 examples: - default: &161 + default: &164 value: - url: https://api.github.com/orgs/github type: Organization @@ -23937,15 +24517,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/apps/marketplace#get-a-subscription-plan-for-an-account-stubbed parameters: - - *156 + - *159 responses: '200': description: Response content: application/json: - schema: *155 + schema: *158 examples: - default: *157 + default: *160 '404': description: Not Found when the account has not purchased the listing '401': *23 @@ -23977,9 +24557,9 @@ paths: application/json: schema: type: array - items: *154 + items: *157 examples: - default: *158 + default: *161 headers: Link: *38 '401': *23 @@ -24002,8 +24582,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/apps/marketplace#list-accounts-for-a-plan-stubbed parameters: - - *159 - - *160 + - *162 + - *163 - name: direction description: To return the oldest accounts first, set to `asc`. Ignored without the `sort` parameter. @@ -24023,9 +24603,9 @@ paths: application/json: schema: type: array - items: *155 + items: *158 examples: - default: *161 + default: *164 headers: Link: *38 '401': *23 @@ -24290,14 +24870,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/events#list-public-events-for-a-network-of-repositories parameters: - - &368 + - &370 name: owner description: The account owner of the repository. The name is not case sensitive. in: path required: true schema: type: string - - &369 + - &371 name: repo description: The name of the repository without the `.git` extension. The name is not case sensitive. @@ -24314,7 +24894,7 @@ paths: application/json: schema: type: array - items: *162 + items: *165 examples: default: value: @@ -24368,7 +24948,7 @@ paths: '404': *6 '403': *27 '304': *35 - '301': &382 + '301': &384 description: Moved permanently content: application/json: @@ -24390,7 +24970,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/notifications#list-notifications-for-the-authenticated-user parameters: - - &587 + - &589 name: all description: If `true`, show notifications marked as read. in: query @@ -24398,7 +24978,7 @@ paths: schema: type: boolean default: false - - &588 + - &590 name: participating description: If `true`, only shows notifications in which the user is directly participating or mentioned. @@ -24407,8 +24987,8 @@ paths: schema: type: boolean default: false - - *141 - - &589 + - *144 + - &591 name: before description: 'Only show notifications updated before the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: @@ -24433,14 +25013,14 @@ paths: application/json: schema: type: array - items: &163 + items: &166 title: Thread description: Thread type: object properties: id: type: string - repository: &193 + repository: &195 title: Minimal Repository description: Minimal Repository type: object @@ -24779,7 +25359,7 @@ paths: type: boolean examples: - false - security_and_analysis: &318 + security_and_analysis: &320 type: - object - 'null' @@ -24948,7 +25528,7 @@ paths: - url - subscription_url examples: - default: &590 + default: &592 value: - id: '1' repository: @@ -25114,7 +25694,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/notifications#get-a-thread parameters: - - &164 + - &167 name: thread_id description: The unique identifier of the notification thread. This corresponds to the value returned in the `id` field when you retrieve notifications @@ -25128,7 +25708,7 @@ paths: description: Response content: application/json: - schema: *163 + schema: *166 examples: default: value: @@ -25231,7 +25811,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/notifications#mark-a-thread-as-read parameters: - - *164 + - *167 responses: '205': description: Reset Content @@ -25254,7 +25834,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/notifications#mark-a-thread-as-done parameters: - - *164 + - *167 responses: '204': description: No content @@ -25277,13 +25857,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/notifications#get-a-thread-subscription-for-the-authenticated-user parameters: - - *164 + - *167 responses: '200': description: Response content: application/json: - schema: &165 + schema: &168 title: Thread Subscription description: Thread Subscription type: object @@ -25327,7 +25907,7 @@ paths: - url - subscribed examples: - default: &166 + default: &169 value: subscribed: true ignored: false @@ -25358,7 +25938,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/notifications#set-a-thread-subscription parameters: - - *164 + - *167 requestBody: required: false content: @@ -25379,9 +25959,9 @@ paths: description: Response content: application/json: - schema: *165 + schema: *168 examples: - default: *166 + default: *169 '304': *35 '403': *27 '401': *23 @@ -25404,7 +25984,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/notifications#delete-a-thread-subscription parameters: - - *164 + - *167 responses: '204': description: Response @@ -25501,7 +26081,7 @@ paths: type: array items: *57 examples: - default: &740 + default: &742 value: - login: github id: 1 @@ -25566,7 +26146,7 @@ paths: - 3 custom_roles: type: array - items: &239 + items: &241 title: Organization Custom Repository Role description: Custom repository roles created by organization owners @@ -25615,7 +26195,7 @@ paths: - created_at - updated_at examples: - default: &240 + default: &242 value: id: 8030 name: Security Engineer @@ -25662,7 +26242,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/repository-access#lists-the-repositories-dependabot-can-access-in-an-organization parameters: - - *167 + - *71 - name: page in: query description: The page number of results to fetch. @@ -25708,7 +26288,7 @@ paths: items: anyOf: - type: 'null' - - *95 + - *98 additionalProperties: false examples: default: @@ -25813,7 +26393,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/repository-access#updates-dependabots-repository-access-list-for-an-organization parameters: - - *167 + - *71 requestBody: required: true content: @@ -25879,7 +26459,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/repository-access#set-the-default-repository-access-level-for-dependabot parameters: - - *167 + - *71 requestBody: required: true content: @@ -25927,23 +26507,23 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/billing/enhanced-billing#get-billing-usage-report-for-an-organization parameters: - - *167 - - *168 - - *169 + - *71 - *170 - *171 + - *172 + - *173 responses: '200': description: Billing usage report response for an organization content: application/json: - schema: *172 + schema: *174 examples: - default: *173 + default: *175 '400': *14 '403': *27 - '500': *83 - '503': *130 + '500': *86 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -25969,13 +26549,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/orgs#get-an-organization parameters: - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: &174 + schema: &176 title: Organization Full description: |- Prevents users in the organization from using insecure methods of two-factor authentication to fulfill a two-factor requirement. @@ -26385,7 +26965,7 @@ paths: - updated_at - archived_at examples: - default-response: &175 + default-response: &177 value: login: github id: 1 @@ -26487,7 +27067,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/orgs#update-an-organization parameters: - - *167 + - *71 requestBody: required: false content: @@ -26711,18 +27291,18 @@ paths: description: Response content: application/json: - schema: *174 + schema: *176 examples: - default: *175 + default: *177 '422': description: Validation failed content: application/json: schema: oneOf: - - *176 - - *177 - '409': *94 + - *178 + - *179 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -26745,7 +27325,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/orgs#delete-an-organization parameters: - - *167 + - *71 responses: '202': *37 '404': *6 @@ -26770,15 +27350,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/cache#get-github-actions-cache-usage-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: *178 + schema: *180 examples: - default: *179 + default: *181 headers: Link: *38 x-github: @@ -26801,7 +27381,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/cache#list-repositories-with-github-actions-cache-usage-for-an-organization parameters: - - *167 + - *71 - *17 - *19 responses: @@ -26819,7 +27399,7 @@ paths: type: integer repository_cache_usages: type: array - items: &387 + items: &389 title: Actions Cache Usage by repository description: GitHub Actions Cache Usage by repository. type: object @@ -26877,7 +27457,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/hosted-runners#list-github-hosted-runners-for-an-organization parameters: - - *167 + - *71 - *17 - *19 responses: @@ -26897,7 +27477,7 @@ paths: type: array items: *40 examples: - default: *180 + default: *182 headers: Link: *38 x-github: @@ -26917,7 +27497,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/hosted-runners#create-a-github-hosted-runner-for-an-organization parameters: - - *167 + - *71 requestBody: required: true content: @@ -27004,7 +27584,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/hosted-runners#get-github-owned-images-for-github-hosted-runners-in-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -27040,7 +27620,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/hosted-runners#get-partner-images-for-github-hosted-runners-in-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -27075,15 +27655,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/hosted-runners#get-limits-on-github-hosted-runners-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: *181 + schema: *183 examples: - default: *182 + default: *184 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -27101,7 +27681,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/hosted-runners#get-github-hosted-runners-machine-specs-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -27119,7 +27699,7 @@ paths: type: array items: *43 examples: - default: *183 + default: *185 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -27137,7 +27717,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/hosted-runners#get-platforms-for-github-hosted-runners-in-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -27181,7 +27761,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/hosted-runners#get-a-github-hosted-runner-for-an-organization parameters: - - *167 + - *71 - *45 responses: '200': @@ -27210,7 +27790,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/hosted-runners#update-a-github-hosted-runner-for-an-organization parameters: - - *167 + - *71 - *45 requestBody: required: true @@ -27267,7 +27847,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/hosted-runners#delete-a-github-hosted-runner-for-an-organization parameters: - - *167 + - *71 - *45 responses: '202': @@ -27296,13 +27876,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/oidc#get-the-customization-template-for-an-oidc-subject-claim-for-an-organization parameters: - - *167 + - *71 responses: '200': description: A JSON serialized template for OIDC subject claim customization content: application/json: - schema: &184 + schema: &186 title: Actions OIDC Subject customization description: Actions OIDC Subject customization type: object @@ -27316,7 +27896,7 @@ paths: required: - include_claim_keys examples: - default: &185 + default: &187 value: include_claim_keys: - repo @@ -27338,20 +27918,20 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/oidc#set-the-customization-template-for-an-oidc-subject-claim-for-an-organization parameters: - - *167 + - *71 requestBody: required: true content: application/json: - schema: *184 + schema: *186 examples: - default: *185 + default: *187 responses: '201': description: Empty response content: application/json: - schema: &204 + schema: &206 title: Empty Object description: An object without any properties. type: object @@ -27381,7 +27961,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#get-github-actions-permissions-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -27390,7 +27970,7 @@ paths: schema: type: object properties: - enabled_repositories: &187 + enabled_repositories: &189 type: string description: The policy that controls the repositories in the organization that are allowed to run GitHub Actions. @@ -27404,7 +27984,7 @@ paths: that are allowed to run GitHub Actions, when `enabled_repositories` is set to `selected`. allowed_actions: *47 - selected_actions_url: *186 + selected_actions_url: *188 required: - enabled_repositories examples: @@ -27433,7 +28013,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#set-github-actions-permissions-for-an-organization parameters: - - *167 + - *71 responses: '204': description: Response @@ -27444,7 +28024,7 @@ paths: schema: type: object properties: - enabled_repositories: *187 + enabled_repositories: *189 allowed_actions: *47 required: - enabled_repositories @@ -27472,7 +28052,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#list-selected-repositories-enabled-for-github-actions-in-an-organization parameters: - - *167 + - *71 - *17 - *19 responses: @@ -27492,7 +28072,7 @@ paths: type: array items: *62 examples: - default: &734 + default: &736 value: total_count: 1 repositories: @@ -27632,7 +28212,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#set-selected-repositories-enabled-for-github-actions-in-an-organization parameters: - - *167 + - *71 responses: '204': description: Response @@ -27676,8 +28256,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#enable-a-selected-repository-for-github-actions-in-an-organization parameters: - - *167 - - &188 + - *71 + - &190 name: repository_id description: The unique identifier of the repository. in: path @@ -27705,8 +28285,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#disable-a-selected-repository-for-github-actions-in-an-organization parameters: - - *167 - - *188 + - *71 + - *190 responses: '204': description: Response @@ -27729,7 +28309,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#get-allowed-actions-and-reusable-workflows-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -27760,7 +28340,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#set-allowed-actions-and-reusable-workflows-for-an-organization parameters: - - *167 + - *71 responses: '204': description: Response @@ -27792,13 +28372,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#get-default-workflow-permissions-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: *189 + schema: *191 examples: default: *53 x-github: @@ -27821,7 +28401,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#set-default-workflow-permissions-for-an-organization parameters: - - *167 + - *71 responses: '204': description: Success response @@ -27832,7 +28412,7 @@ paths: required: false content: application/json: - schema: *190 + schema: *192 examples: default: *53 x-github: @@ -27854,7 +28434,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#list-self-hosted-runner-groups-for-an-organization parameters: - - *167 + - *71 - *17 - *19 - name: visible_to_repository @@ -27879,7 +28459,7 @@ paths: type: number runner_groups: type: array - items: &191 + items: &193 type: object properties: id: @@ -27996,7 +28576,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#create-a-self-hosted-runner-group-for-an-organization parameters: - - *167 + - *71 requestBody: required: true content: @@ -28069,9 +28649,9 @@ paths: description: Response content: application/json: - schema: *191 + schema: *193 examples: - default: &192 + default: &194 value: id: 2 name: octo-runner-group @@ -28106,14 +28686,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#get-a-self-hosted-runner-group-for-an-organization parameters: - - *167 + - *71 - *56 responses: '200': description: Response content: application/json: - schema: *191 + schema: *193 examples: default: value: @@ -28149,7 +28729,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#update-a-self-hosted-runner-group-for-an-organization parameters: - - *167 + - *71 - *56 requestBody: required: true @@ -28206,9 +28786,9 @@ paths: description: Response content: application/json: - schema: *191 + schema: *193 examples: - default: *192 + default: *194 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -28227,7 +28807,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#delete-a-self-hosted-runner-group-from-an-organization parameters: - - *167 + - *71 - *56 responses: '204': @@ -28251,7 +28831,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#list-github-hosted-runners-in-a-group-for-an-organization parameters: - - *167 + - *71 - *56 - *17 - *19 @@ -28272,7 +28852,7 @@ paths: type: array items: *40 examples: - default: *180 + default: *182 headers: Link: *38 x-github: @@ -28294,7 +28874,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#list-repository-access-to-a-self-hosted-runner-group-in-an-organization parameters: - - *167 + - *71 - *56 - *19 - *17 @@ -28313,9 +28893,9 @@ paths: type: number repositories: type: array - items: *193 + items: *195 examples: - default: &726 + default: &728 value: total_count: 1 repositories: @@ -28567,7 +29147,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#set-repository-access-for-a-self-hosted-runner-group-in-an-organization parameters: - - *167 + - *71 - *56 requestBody: required: true @@ -28612,9 +29192,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#add-repository-access-to-a-self-hosted-runner-group-in-an-organization parameters: - - *167 + - *71 - *56 - - *188 + - *190 responses: '204': description: Response @@ -28636,9 +29216,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#remove-repository-access-to-a-self-hosted-runner-group-in-an-organization parameters: - - *167 + - *71 - *56 - - *188 + - *190 responses: '204': description: Response @@ -28661,7 +29241,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#list-self-hosted-runners-in-a-group-for-an-organization parameters: - - *167 + - *71 - *56 - *17 - *19 @@ -28703,7 +29283,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#set-self-hosted-runners-in-a-group-for-an-organization parameters: - - *167 + - *71 - *56 requestBody: required: true @@ -28748,7 +29328,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#add-a-self-hosted-runner-to-a-group-for-an-organization parameters: - - *167 + - *71 - *56 - *59 responses: @@ -28772,7 +29352,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runner-groups#remove-a-self-hosted-runner-from-a-group-for-an-organization parameters: - - *167 + - *71 - *56 - *59 responses: @@ -28804,7 +29384,7 @@ paths: in: query schema: type: string - - *167 + - *71 - *17 - *19 responses: @@ -28848,7 +29428,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#list-runner-applications-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -28856,9 +29436,9 @@ paths: application/json: schema: type: array - items: *194 + items: *196 examples: - default: *195 + default: *197 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -28880,7 +29460,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#create-configuration-for-a-just-in-time-runner-for-an-organization parameters: - - *167 + - *71 requestBody: required: true content: @@ -28923,10 +29503,10 @@ paths: - no-gpu work_folder: _work responses: - '201': *196 + '201': *198 '404': *6 '422': *7 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -28954,7 +29534,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#create-a-registration-token-for-an-organization parameters: - - *167 + - *71 responses: '201': description: Response @@ -28962,7 +29542,7 @@ paths: application/json: schema: *63 examples: - default: *197 + default: *199 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -28990,7 +29570,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#create-a-remove-token-for-an-organization parameters: - - *167 + - *71 responses: '201': description: Response @@ -28998,7 +29578,7 @@ paths: application/json: schema: *63 examples: - default: *198 + default: *200 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -29020,7 +29600,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#get-a-self-hosted-runner-for-an-organization parameters: - - *167 + - *71 - *59 responses: '200': @@ -29029,7 +29609,7 @@ paths: application/json: schema: *60 examples: - default: *199 + default: *201 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -29050,7 +29630,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#delete-a-self-hosted-runner-from-an-organization parameters: - - *167 + - *71 - *59 responses: '204': @@ -29077,7 +29657,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#list-labels-for-a-self-hosted-runner-for-an-organization parameters: - - *167 + - *71 - *59 responses: '200': *65 @@ -29102,7 +29682,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#add-custom-labels-to-a-self-hosted-runner-for-an-organization parameters: - - *167 + - *71 - *59 requestBody: required: true @@ -29151,7 +29731,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#set-custom-labels-for-a-self-hosted-runner-for-an-organization parameters: - - *167 + - *71 - *59 requestBody: required: true @@ -29201,10 +29781,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#remove-all-custom-labels-from-a-self-hosted-runner-for-an-organization parameters: - - *167 + - *71 - *59 responses: - '200': *200 + '200': *202 '404': *6 x-github: githubCloudOnly: false @@ -29231,9 +29811,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#remove-a-custom-label-from-a-self-hosted-runner-for-an-organization parameters: - - *167 + - *71 - *59 - - *201 + - *203 responses: '200': *65 '404': *6 @@ -29260,7 +29840,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#list-organization-secrets parameters: - - *167 + - *71 - *17 - *19 responses: @@ -29278,7 +29858,7 @@ paths: type: integer secrets: type: array - items: &202 + items: &204 title: Actions Secret for an Organization description: Secrets for GitHub Actions for an organization. type: object @@ -29353,13 +29933,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#get-an-organization-public-key parameters: - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: &407 + schema: &409 title: ActionsPublicKey description: The public key used for setting Actions Secrets. type: object @@ -29394,7 +29974,7 @@ paths: - key_id - key examples: - default: &408 + default: &410 value: key_id: '012345678912345678' key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -29419,8 +29999,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#get-an-organization-secret parameters: - - *167 - - &203 + - *71 + - &205 name: secret_name description: The name of the secret. in: path @@ -29432,7 +30012,7 @@ paths: description: Response content: application/json: - schema: *202 + schema: *204 examples: default: value: @@ -29462,8 +30042,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#create-or-update-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 requestBody: required: true content: @@ -29520,7 +30100,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -29546,8 +30126,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#delete-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 responses: '204': description: Response @@ -29573,8 +30153,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#list-selected-repositories-for-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 - *19 - *17 responses: @@ -29592,9 +30172,9 @@ paths: type: integer repositories: type: array - items: *193 + items: *195 examples: - default: &207 + default: &209 value: total_count: 1 repositories: @@ -29686,8 +30266,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#set-selected-repositories-for-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 requestBody: required: true content: @@ -29739,8 +30319,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#add-selected-repository-to-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 - name: repository_id in: path required: true @@ -29773,8 +30353,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#remove-selected-repository-from-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 - name: repository_id in: path required: true @@ -29806,8 +30386,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#list-organization-variables parameters: - - *167 - - &392 + - *71 + - &394 name: per_page description: The number of results per page (max 30). For more information, see "[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api)." @@ -29831,7 +30411,7 @@ paths: type: integer variables: type: array - items: &205 + items: &207 title: Actions Variable for an Organization description: Organization variable for GitHub Actions. type: object @@ -29921,7 +30501,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#create-an-organization-variable parameters: - - *167 + - *71 requestBody: required: true content: @@ -29969,7 +30549,7 @@ paths: description: Response when creating a variable content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -29994,8 +30574,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#get-an-organization-variable parameters: - - *167 - - &206 + - *71 + - &208 name: name description: The name of the variable. in: path @@ -30007,7 +30587,7 @@ paths: description: Response content: application/json: - schema: *205 + schema: *207 examples: default: value: @@ -30037,8 +30617,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#update-an-organization-variable parameters: - - *167 - - *206 + - *71 + - *208 requestBody: required: true content: @@ -30100,8 +30680,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#delete-an-organization-variable parameters: - - *167 - - *206 + - *71 + - *208 responses: '204': description: Response @@ -30127,8 +30707,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#list-selected-repositories-for-an-organization-variable parameters: - - *167 - - *206 + - *71 + - *208 - *19 - *17 responses: @@ -30146,9 +30726,9 @@ paths: type: integer repositories: type: array - items: *193 + items: *195 examples: - default: *207 + default: *209 '409': description: Response when the visibility of the variable is not set to `selected` @@ -30174,8 +30754,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#set-selected-repositories-for-an-organization-variable parameters: - - *167 - - *206 + - *71 + - *208 requestBody: required: true content: @@ -30224,8 +30804,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#add-selected-repository-to-an-organization-variable parameters: - - *167 - - *206 + - *71 + - *208 - name: repository_id in: path required: true @@ -30259,8 +30839,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#remove-selected-repository-from-an-organization-variable parameters: - - *167 - - *206 + - *71 + - *208 - name: repository_id in: path required: true @@ -30291,7 +30871,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/announcement-banners/organizations#get-announcement-banner-for-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -30318,11 +30898,11 @@ paths: required: true content: application/json: - schema: *208 + schema: *210 examples: default: *69 parameters: - - *167 + - *71 responses: '200': description: Response @@ -30346,7 +30926,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/announcement-banners/organizations#remove-announcement-banner-from-organization parameters: - - *167 + - *71 responses: '204': description: Response @@ -30372,9 +30952,9 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/orgs#list-attestations-by-bulk-subject-digests parameters: - *17 - - *84 - - *85 - - *167 + - *87 + - *88 + - *71 requestBody: required: true content: @@ -30397,12 +30977,12 @@ paths: required: - subject_digests examples: - default: &755 + default: &757 value: subject_digests: - sha256:abc123 - sha512:def456 - withPredicateType: &756 + withPredicateType: &758 value: subject_digests: - sha256:abc123 @@ -30461,7 +31041,7 @@ paths: description: The cursor to the previous page. description: Information about the current page. examples: - default: &757 + default: &759 value: attestations_subject_digests: - sha256:abc: @@ -30570,7 +31150,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/attestations#delete-attestations-in-bulk parameters: - - *167 + - *71 requestBody: required: true content: @@ -30635,7 +31215,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/attestations#delete-attestations-by-subject-digest parameters: - - *167 + - *71 - name: subject_digest description: Subject Digest in: path @@ -30666,7 +31246,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/attestations#delete-attestations-by-id parameters: - - *167 + - *71 - name: attestation_id description: Attestation ID in: path @@ -30702,9 +31282,9 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/orgs#list-attestations parameters: - *17 - - *84 - - *85 - - *167 + - *87 + - *88 + - *71 - name: subject_digest description: The parameter should be set to the attestation's subject's SHA256 digest, in the form `sha256:HEX_DIGEST`. @@ -30755,7 +31335,7 @@ paths: bundle_url: type: string examples: - default: &421 + default: &423 value: attestations: - bundle: @@ -30873,7 +31453,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/orgs#get-the-audit-log-for-an-organization parameters: - - *167 + - *71 - name: phrase description: A search phrase. For more information, see [Searching the audit log](https://docs.github.com/enterprise-cloud@latest//github/setting-up-and-managing-organizations-and-teams/reviewing-the-audit-log-for-your-organization#searching-the-audit-log). @@ -30881,10 +31461,10 @@ paths: required: false schema: type: string - - *209 - - *210 - *211 - *212 + - *213 + - *214 - *17 responses: '200': @@ -30893,9 +31473,9 @@ paths: application/json: schema: type: array - items: *213 + items: *215 examples: - default: *214 + default: *216 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -30912,7 +31492,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/blocking#list-users-blocked-by-an-organization parameters: - - *167 + - *71 - *17 - *19 responses: @@ -30924,7 +31504,7 @@ paths: type: array items: *4 examples: - default: &287 + default: &289 value: - login: octocat id: 1 @@ -30962,8 +31542,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/blocking#check-if-a-user-is-blocked-by-an-organization parameters: - - *167 - - *215 + - *71 + - *217 responses: '204': description: If the user is blocked @@ -30988,8 +31568,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/blocking#block-a-user-from-an-organization parameters: - - *167 - - *215 + - *71 + - *217 responses: '204': description: Response @@ -31009,8 +31589,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/blocking#unblock-a-user-from-an-organization parameters: - - *167 - - *215 + - *71 + - *217 responses: '204': description: Response @@ -31036,17 +31616,17 @@ paths: category: orgs subcategory: bypass-requests parameters: - - *167 - - &222 + - *71 + - &224 name: repository_name description: The name of the repository to filter on. in: query schema: type: string - - *216 - - *217 - *218 - *219 + - *220 + - *221 - *17 - *19 responses: @@ -31056,11 +31636,11 @@ paths: application/json: schema: type: array - items: *220 + items: *222 examples: - default: *221 + default: *223 '404': *6 - '500': *83 + '500': *86 "/orgs/{org}/bypass-requests/secret-scanning": get: summary: List bypass requests for secret scanning for an org @@ -31081,12 +31661,12 @@ paths: category: secret-scanning subcategory: delegated-bypass parameters: - - *167 - - *222 - - *216 - - *217 + - *71 + - *224 - *218 - *219 + - *220 + - *221 - *17 - *19 responses: @@ -31096,7 +31676,7 @@ paths: application/json: schema: type: array - items: &438 + items: &440 title: Secret scanning bypass request description: A bypass request made by a user asking to be exempted from push protection in this repository. @@ -31214,7 +31794,7 @@ paths: - array - 'null' description: The responses to the bypass request. - items: *223 + items: *225 url: type: string format: uri @@ -31227,7 +31807,7 @@ paths: examples: - https://github.com/octo-org/smile/exemptions/1 examples: - default: &439 + default: &441 value: - id: 21 number: 42 @@ -31294,7 +31874,7 @@ paths: url: https://api.github.com/repos/octo-org/smile/bypass-requests/secret-scanning/2 html_url: https://github.com/octo-org/smile/exemptions/2 '404': *6 - '500': *83 + '500': *86 "/orgs/{org}/campaigns": get: summary: List campaigns for an organization @@ -31311,15 +31891,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/campaigns/campaigns#list-campaigns-for-an-organization parameters: - - *167 + - *71 - *19 - *17 - - *86 + - *89 - name: state description: If specified, only campaigns with this state will be returned. in: query required: false - schema: &225 + schema: &227 title: Campaign state description: Indicates whether a campaign is open or closed type: string @@ -31345,7 +31925,7 @@ paths: application/json: schema: type: array - items: &226 + items: &228 title: Campaign summary description: The campaign metadata and alert stats. type: object @@ -31376,7 +31956,7 @@ paths: team_managers: description: The campaign team managers type: array - items: *224 + items: *226 published_at: description: The date and time the campaign was published, in ISO 8601 format':' YYYY-MM-DDTHH:MM:SSZ. @@ -31395,7 +31975,7 @@ paths: - string - 'null' format: date-time - state: *225 + state: *227 contact_link: description: The contact link of the campaign. type: @@ -31493,7 +32073,7 @@ paths: headers: Link: *38 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -31517,7 +32097,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/campaigns/campaigns#create-a-campaign-for-an-organization parameters: - - *167 + - *71 requestBody: required: true content: @@ -31612,9 +32192,9 @@ paths: description: Response content: application/json: - schema: *226 + schema: *228 examples: - default: &227 + default: &229 value: number: 3 created_at: '2024-02-14T12:29:18Z' @@ -31663,7 +32243,7 @@ paths: schema: *3 '429': description: Too Many Requests - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -31685,7 +32265,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/campaigns/campaigns#get-a-campaign-for-an-organization parameters: - - *167 + - *71 - name: campaign_number description: The campaign number. in: path @@ -31697,16 +32277,16 @@ paths: description: Response content: application/json: - schema: *226 + schema: *228 examples: - default: *227 + default: *229 '404': *6 '422': description: Unprocessable Entity content: application/json: schema: *3 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -31727,7 +32307,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/campaigns/campaigns#update-a-campaign parameters: - - *167 + - *71 - name: campaign_number description: The campaign number. in: path @@ -31777,7 +32357,7 @@ paths: - string - 'null' format: uri - state: *225 + state: *227 examples: default: value: @@ -31787,9 +32367,9 @@ paths: description: Response content: application/json: - schema: *226 + schema: *228 examples: - default: *227 + default: *229 '400': description: Bad Request content: @@ -31801,7 +32381,7 @@ paths: content: application/json: schema: *3 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -31822,7 +32402,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/campaigns/campaigns#delete-a-campaign-for-an-organization parameters: - - *167 + - *71 - name: campaign_number description: The campaign number. in: path @@ -31833,7 +32413,7 @@ paths: '204': description: Deletion successful '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -31855,20 +32435,20 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#list-code-scanning-alerts-for-an-organization parameters: - - *167 - - *228 - - *229 - - *84 - - *85 + - *71 + - *230 + - *231 + - *87 + - *88 - *19 - *17 - - *86 + - *89 - name: state description: If specified, only code scanning alerts with this state will be returned. in: query required: false - schema: *230 + schema: *232 - name: sort description: The property by which to sort the results. in: query @@ -31884,7 +32464,7 @@ paths: be returned. in: query required: false - schema: &449 + schema: &451 type: string description: Severity of a code scanning alert. enum: @@ -31902,13 +32482,13 @@ paths: application/json: schema: type: array - items: *231 + items: *233 examples: - default: *232 + default: *234 headers: Link: *38 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -31930,7 +32510,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#get-code-security-configurations-for-an-organization parameters: - - *167 + - *71 - name: target_type in: query description: The target type of the code security configuration @@ -31949,8 +32529,8 @@ paths: schema: type: integer default: 30 - - *84 - - *85 + - *87 + - *88 responses: '200': description: Response @@ -31958,7 +32538,7 @@ paths: application/json: schema: type: array - items: *90 + items: *93 examples: default: value: @@ -32041,7 +32621,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#create-a-code-security-configuration parameters: - - *167 + - *71 requestBody: required: true content: @@ -32118,7 +32698,7 @@ paths: - disabled - not_set default: disabled - code_scanning_default_setup_options: *93 + code_scanning_default_setup_options: *96 code_scanning_delegated_alert_dismissal: type: string description: The enablement status of code scanning delegated alert @@ -32243,9 +32823,9 @@ paths: description: Successfully created code security configuration content: application/json: - schema: *90 + schema: *93 examples: - default: *233 + default: *235 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -32267,15 +32847,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#get-default-code-security-configurations parameters: - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: *234 + schema: *236 examples: - default: *235 + default: *237 '304': *35 '403': *27 '404': *6 @@ -32301,7 +32881,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#detach-configurations-from-repositories parameters: - - *167 + - *71 requestBody: required: true content: @@ -32324,11 +32904,11 @@ paths: - 32 - 91 responses: - '204': *116 + '204': *119 '400': *14 '403': *27 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -32350,16 +32930,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#get-a-code-security-configuration parameters: - - *167 - - *92 + - *71 + - *95 responses: '200': description: Response content: application/json: - schema: *90 + schema: *93 examples: - default: *233 + default: *235 '304': *35 '403': *27 '404': *6 @@ -32383,8 +32963,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#update-a-code-security-configuration parameters: - - *167 - - *92 + - *71 + - *95 requestBody: required: true content: @@ -32454,7 +33034,7 @@ paths: - enabled - disabled - not_set - code_scanning_default_setup_options: *93 + code_scanning_default_setup_options: *96 code_scanning_delegated_alert_dismissal: type: string description: The enablement status of code scanning delegated alert @@ -32565,7 +33145,7 @@ paths: description: Response when a configuration is updated content: application/json: - schema: *90 + schema: *93 examples: default: value: @@ -32622,14 +33202,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#delete-a-code-security-configuration parameters: - - *167 - - *92 + - *71 + - *95 responses: - '204': *116 + '204': *119 '400': *14 '403': *27 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -32653,8 +33233,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#attach-a-configuration-to-repositories parameters: - - *167 - - *92 + - *71 + - *95 requestBody: required: true content: @@ -32717,8 +33297,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#set-a-code-security-configuration-as-a-default-for-an-organization parameters: - - *167 - - *92 + - *71 + - *95 requestBody: required: true content: @@ -32758,12 +33338,12 @@ paths: - none - private_and_internal - public - configuration: *90 + configuration: *93 examples: default: value: default_for_new_repos: all - configuration: *233 + configuration: *235 '403': *27 '404': *6 x-github: @@ -32787,8 +33367,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#get-repositories-associated-with-a-code-security-configuration parameters: - - *167 - - *92 + - *71 + - *95 - name: per_page description: The number of results per page (max 100). For more information, see "[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api)." @@ -32797,8 +33377,8 @@ paths: schema: type: integer default: 30 - - *84 - - *85 + - *87 + - *88 - name: status description: |- A comma-separated list of statuses. If specified, only repositories with these attachment statuses will be returned. @@ -32816,13 +33396,13 @@ paths: application/json: schema: type: array - items: *236 + items: *238 examples: default: summary: Example of code security configuration repositories value: - status: attached - repository: *237 + repository: *239 '403': *27 '404': *6 x-github: @@ -32846,7 +33426,7 @@ paths: parameters: - *17 - *19 - - *167 + - *71 responses: '200': description: Response @@ -32862,7 +33442,7 @@ paths: type: integer codespaces: type: array - items: &288 + items: &290 type: object title: Codespace description: A codespace. @@ -32893,11 +33473,11 @@ paths: - 26a7c758-7299-4a73-b978-5a92a7ae98a0 owner: *4 billable_owner: *4 - repository: *193 + repository: *195 machine: anyOf: - type: 'null' - - &478 + - &480 type: object title: Codespace machine description: A description of the machine powering a codespace. @@ -33184,7 +33764,7 @@ paths: - pulls_url - recent_folders examples: - default: &289 + default: &291 value: total_count: 3 codespaces: @@ -33594,7 +34174,7 @@ paths: stop_url: https://api.github.com/user/codespaces/monalisa-octocat-hello-world-f8adfad99a/stop recent_folders: [] '304': *35 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -33616,7 +34196,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organizations#manage-access-control-for-organization-codespaces parameters: - - *167 + - *71 deprecated: true requestBody: required: true @@ -33660,7 +34240,7 @@ paths: description: Users are neither members nor collaborators of this organization. '404': *6 '422': *15 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -33683,7 +34263,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organizations#add-users-to-codespaces-access-for-an-organization parameters: - - *167 + - *71 deprecated: true requestBody: required: true @@ -33715,7 +34295,7 @@ paths: description: Users are neither members nor collaborators of this organization. '404': *6 '422': *15 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -33738,7 +34318,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organizations#remove-users-from-codespaces-access-for-an-organization deprecated: true parameters: - - *167 + - *71 requestBody: required: true content: @@ -33769,7 +34349,7 @@ paths: description: Users are neither members nor collaborators of this organization. '404': *6 '422': *15 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -33790,7 +34370,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#list-organization-secrets parameters: - - *167 + - *71 - *17 - *19 responses: @@ -33808,7 +34388,7 @@ paths: type: integer secrets: type: array - items: &238 + items: &240 title: Codespaces Secret description: Secrets for a GitHub Codespace. type: object @@ -33849,7 +34429,7 @@ paths: - updated_at - visibility examples: - default: &479 + default: &481 value: total_count: 2 secrets: @@ -33881,13 +34461,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#get-an-organization-public-key parameters: - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: &480 + schema: &482 title: CodespacesPublicKey description: The public key used for setting Codespaces secrets. type: object @@ -33922,7 +34502,7 @@ paths: - key_id - key examples: - default: &481 + default: &483 value: key_id: '012345678912345678' key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -33945,16 +34525,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#get-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 responses: '200': description: Response content: application/json: - schema: *238 + schema: *240 examples: - default: &483 + default: &485 value: name: GH_TOKEN created_at: '2019-08-10T14:59:22Z' @@ -33981,8 +34561,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#create-or-update-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 requestBody: required: true content: @@ -34037,7 +34617,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -34063,8 +34643,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#delete-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 responses: '204': description: Response @@ -34089,8 +34669,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#list-selected-repositories-for-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 - *19 - *17 responses: @@ -34108,9 +34688,9 @@ paths: type: integer repositories: type: array - items: *193 + items: *195 examples: - default: *207 + default: *209 '404': *6 x-github: githubCloudOnly: false @@ -34132,8 +34712,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#set-selected-repositories-for-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 requestBody: required: true content: @@ -34183,8 +34763,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#add-selected-repository-to-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 - name: repository_id in: path required: true @@ -34217,8 +34797,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#remove-selected-repository-from-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 - name: repository_id in: path required: true @@ -34257,7 +34837,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/copilot/copilot-user-management#get-copilot-seat-information-and-settings-for-an-organization parameters: - - *167 + - *71 responses: '200': description: OK @@ -34366,7 +34946,7 @@ paths: cli: enabled public_code_suggestions: block plan_type: business - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -34398,7 +34978,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/copilot/copilot-user-management#list-all-copilot-seat-assignments-for-an-organization parameters: - - *167 + - *71 - *19 - name: per_page description: The number of results per page (max 100). For more information, @@ -34421,12 +35001,12 @@ paths: currently being billed. seats: type: array - items: *107 + items: *110 examples: - default: *108 + default: *111 headers: Link: *38 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -34459,7 +35039,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/copilot/copilot-user-management#add-teams-to-the-copilot-subscription-for-an-organization parameters: - - *167 + - *71 requestBody: content: application/json: @@ -34501,7 +35081,7 @@ paths: default: value: seats_created: 5 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -34537,7 +35117,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/copilot/copilot-user-management#remove-teams-from-the-copilot-subscription-for-an-organization parameters: - - *167 + - *71 requestBody: content: application/json: @@ -34579,7 +35159,7 @@ paths: default: value: seats_cancelled: 5 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -34617,7 +35197,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/copilot/copilot-user-management#add-users-to-the-copilot-subscription-for-an-organization parameters: - - *167 + - *71 requestBody: content: application/json: @@ -34658,7 +35238,7 @@ paths: default: value: seats_created: 5 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -34694,7 +35274,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/copilot/copilot-user-management#remove-users-from-the-copilot-subscription-for-an-organization parameters: - - *167 + - *71 requestBody: content: application/json: @@ -34736,7 +35316,7 @@ paths: default: value: seats_cancelled: 5 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -34775,7 +35355,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/copilot/copilot-metrics#get-copilot-metrics-for-an-organization parameters: - - *167 + - *71 - name: since description: Show usage metrics since this date. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format (`YYYY-MM-DDTHH:MM:SSZ`). @@ -34807,13 +35387,13 @@ paths: application/json: schema: type: array - items: *134 + items: *137 examples: - default: *135 - '500': *83 + default: *138 + '500': *86 '403': *27 '404': *6 - '422': *136 + '422': *139 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -34835,7 +35415,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/orgs#list-saml-sso-authorizations-for-an-organization parameters: - - *167 + - *71 - *17 - name: page description: Page token @@ -34994,7 +35574,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/orgs#remove-a-saml-sso-authorization-for-an-organization parameters: - - *167 + - *71 - name: credential_id in: path required: true @@ -35025,7 +35605,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-roles#list-custom-repository-roles-in-an-organization parameters: - - *167 + - *71 responses: '200': description: Response - list of custom role names @@ -35041,7 +35621,7 @@ paths: - 3 custom_roles: type: array - items: *239 + items: *241 examples: default: value: @@ -35128,12 +35708,12 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-roles#create-a-custom-repository-role parameters: - - *167 + - *71 requestBody: required: true content: application/json: - schema: &242 + schema: &244 type: object properties: name: @@ -35175,9 +35755,9 @@ paths: description: Response content: application/json: - schema: *239 + schema: *241 examples: - default: *240 + default: *242 '422': *15 '404': *6 x-github: @@ -35201,8 +35781,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-roles#get-a-custom-repository-role parameters: - - *167 - - &241 + - *71 + - &243 name: role_id description: The unique identifier of the role. in: path @@ -35214,9 +35794,9 @@ paths: description: Response content: application/json: - schema: *239 + schema: *241 examples: - default: *240 + default: *242 '404': *6 x-github: githubCloudOnly: true @@ -35238,13 +35818,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-roles#update-a-custom-repository-role parameters: - - *167 - - *241 + - *71 + - *243 requestBody: required: true content: application/json: - schema: &243 + schema: &245 type: object properties: name: @@ -35283,9 +35863,9 @@ paths: description: Response content: application/json: - schema: *239 + schema: *241 examples: - default: *240 + default: *242 '422': *15 '404': *6 x-github: @@ -35309,8 +35889,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-roles#delete-a-custom-repository-role parameters: - - *167 - - *241 + - *71 + - *243 responses: '204': description: Response @@ -35338,12 +35918,12 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-roles#closing-down---create-a-custom-role parameters: - - *167 + - *71 requestBody: required: true content: application/json: - schema: *242 + schema: *244 examples: default: value: @@ -35357,9 +35937,9 @@ paths: description: Response content: application/json: - schema: *239 + schema: *241 examples: - default: *240 + default: *242 '422': *15 '404': *6 x-github: @@ -35389,16 +35969,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-roles#closing-down---get-a-custom-role parameters: - - *167 - - *241 + - *71 + - *243 responses: '200': description: Response content: application/json: - schema: *239 + schema: *241 examples: - default: *240 + default: *242 '404': *6 x-github: githubCloudOnly: true @@ -35426,13 +36006,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-roles#closing-down---update-a-custom-role parameters: - - *167 - - *241 + - *71 + - *243 requestBody: required: true content: application/json: - schema: *243 + schema: *245 examples: default: value: @@ -35447,9 +36027,9 @@ paths: description: Response content: application/json: - schema: *239 + schema: *241 examples: - default: *240 + default: *242 '422': *15 '404': *6 x-github: @@ -35479,8 +36059,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-roles#closing-down---delete-a-custom-role parameters: - - *167 - - *241 + - *71 + - *243 responses: '204': description: Response @@ -35508,20 +36088,20 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/alerts#list-dependabot-alerts-for-an-organization parameters: - - *167 - - *244 - - *245 + - *71 - *246 - *247 - *248 - *249 - *250 - *251 - - *86 - - *84 - - *85 - *252 - *253 + - *89 + - *87 + - *88 + - *254 + - *255 - *17 responses: '200': @@ -35530,9 +36110,9 @@ paths: application/json: schema: type: array - items: *254 + items: *256 examples: - default: *255 + default: *257 '304': *35 '400': *14 '403': *27 @@ -35558,7 +36138,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#list-organization-secrets parameters: - - *167 + - *71 - *17 - *19 responses: @@ -35576,7 +36156,7 @@ paths: type: integer secrets: type: array - items: &256 + items: &258 title: Dependabot Secret for an Organization description: Secrets for GitHub Dependabot for an organization. type: object @@ -35649,13 +36229,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#get-an-organization-public-key parameters: - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: &506 + schema: &508 title: DependabotPublicKey description: The public key used for setting Dependabot Secrets. type: object @@ -35674,7 +36254,7 @@ paths: - key_id - key examples: - default: &507 + default: &509 value: key_id: '012345678912345678' key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -35697,14 +36277,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#get-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 responses: '200': description: Response content: application/json: - schema: *256 + schema: *258 examples: default: value: @@ -35732,8 +36312,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#create-or-update-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 requestBody: required: true content: @@ -35788,7 +36368,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -35812,8 +36392,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#delete-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 responses: '204': description: Response @@ -35837,8 +36417,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#list-selected-repositories-for-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 - *19 - *17 responses: @@ -35856,9 +36436,9 @@ paths: type: integer repositories: type: array - items: *193 + items: *195 examples: - default: *207 + default: *209 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -35879,8 +36459,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#set-selected-repositories-for-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 requestBody: required: true content: @@ -35930,8 +36510,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#add-selected-repository-to-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 - name: repository_id in: path required: true @@ -35962,8 +36542,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#remove-selected-repository-from-an-organization-secret parameters: - - *167 - - *203 + - *71 + - *205 - name: repository_id in: path required: true @@ -35999,8 +36579,8 @@ paths: category: code-scanning subcategory: alert-dismissal-requests parameters: - - *167 - - &515 + - *71 + - &517 name: reviewer description: Filter alert dismissal requests by the handle of the GitHub user who reviewed the dismissal request. @@ -36008,7 +36588,7 @@ paths: required: false schema: type: string - - &516 + - &518 name: requester description: Filter alert dismissal requests by the handle of the GitHub user who requested the dismissal. @@ -36016,7 +36596,7 @@ paths: required: false schema: type: string - - &517 + - &519 name: time_period description: |- The time period to filter by. @@ -36032,7 +36612,7 @@ paths: - week - month default: month - - &518 + - &520 name: request_status description: Filter alert dismissal requests by status. When specified, only requests with this status will be returned. @@ -36047,7 +36627,7 @@ paths: - denied - all default: all - - *222 + - *224 - *17 - *19 responses: @@ -36057,7 +36637,7 @@ paths: application/json: schema: type: array - items: &519 + items: &521 title: Code scanning alert dismissal request description: Alert dismisal request made by a user asking to dismiss a code scanning alert. @@ -36220,7 +36800,7 @@ paths: examples: - https://github.com/octo-org/smile/code-scanning/alerts/1 examples: - default: &520 + default: &522 value: - id: 21 number: 42 @@ -36285,7 +36865,7 @@ paths: '404': *6 '403': *27 '422': *15 - '500': *83 + '500': *86 "/orgs/{org}/dismissal-requests/secret-scanning": get: summary: List alert dismissal requests for secret scanning for an org @@ -36306,12 +36886,12 @@ paths: category: secret-scanning subcategory: alert-dismissal-requests parameters: - - *167 - - *222 - - *216 - - *217 + - *71 + - *224 - *218 - - &521 + - *219 + - *220 + - &523 name: request_status description: The status of the dismissal request to filter on. When specified, only requests with this status will be returned. @@ -36337,7 +36917,7 @@ paths: application/json: schema: type: array - items: &522 + items: &524 title: Secret scanning alert dismissal request description: A dismissal request made by a user asking to close a secret scanning alert in this repository. @@ -36451,7 +37031,7 @@ paths: - array - 'null' description: The responses to the dismissal request. - items: *223 + items: *225 url: type: string format: uri @@ -36464,7 +37044,7 @@ paths: examples: - https://github.com/octo-org/smile/security/secret-scanning/17 examples: - default: &523 + default: &525 value: - id: 21 number: 42 @@ -36529,7 +37109,7 @@ paths: html_url: https://github.com/octo-org/smile/security/secret-scanning/19 '404': *6 '403': *27 - '500': *83 + '500': *86 "/orgs/{org}/docker/conflicts": get: summary: Get list of conflicting packages during Docker migration for organization @@ -36544,7 +37124,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#get-list-of-conflicting-packages-during-docker-migration-for-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -36552,7 +37132,7 @@ paths: application/json: schema: type: array - items: &299 + items: &301 title: Package description: A software package type: object @@ -36605,7 +37185,7 @@ paths: repository: anyOf: - type: 'null' - - *193 + - *195 created_at: type: string format: date-time @@ -36623,7 +37203,7 @@ paths: - created_at - updated_at examples: - default: &300 + default: &302 value: - id: 197 name: hello_docker @@ -36701,7 +37281,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/events#list-public-organization-events parameters: - - *167 + - *71 - *17 - *19 responses: @@ -36711,7 +37291,7 @@ paths: application/json: schema: type: array - items: *162 + items: *165 examples: 200-response: value: @@ -36781,7 +37361,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/external-groups#get-an-external-group parameters: - - *167 + - *71 - name: group_id description: The unique identifier of the group. in: path @@ -36807,7 +37387,7 @@ paths: description: Response content: application/json: - schema: &363 + schema: &365 title: ExternalGroup description: Information about an external group's usage and its members type: object @@ -36897,7 +37477,7 @@ paths: member_name: Octo Lisa member_email: octo_lisa@github.com examples: - default: &364 + default: &366 value: group_id: '123' group_name: Octocat admins @@ -36935,7 +37515,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/external-groups#list-external-groups-in-an-organization parameters: - - *167 + - *71 - *17 - name: page description: Page token @@ -36952,7 +37532,7 @@ paths: description: Response content: application/json: - schema: &361 + schema: &363 title: ExternalGroups description: A list of external groups available to be connected to a team @@ -36992,7 +37572,7 @@ paths: group_name: group-azuread-test2 updated_at: 2021-06-03 22:27:15:000 -700 examples: - default: &362 + default: &364 value: groups: - group_id: '123' @@ -37026,7 +37606,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#list-failed-organization-invitations parameters: - - *167 + - *71 - *17 - *19 responses: @@ -37036,7 +37616,7 @@ paths: application/json: schema: type: array - items: &279 + items: &281 title: Organization Invitation description: Organization Invitation type: object @@ -37090,7 +37670,7 @@ paths: - invitation_teams_url - node_id examples: - default: &280 + default: &282 value: - id: 1 login: monalisa @@ -37149,7 +37729,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-roles#closing-down---list-fine-grained-permissions-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -37157,7 +37737,7 @@ paths: application/json: schema: type: array - items: &319 + items: &321 title: Repository Fine-Grained Permission description: A fine-grained permission that protects repository resources. @@ -37171,7 +37751,7 @@ paths: - name - description examples: - default: &320 + default: &322 value: - name: add_assignee description: Assign or remove a user @@ -37202,7 +37782,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#list-organization-webhooks parameters: - - *167 + - *71 - *17 - *19 responses: @@ -37212,7 +37792,7 @@ paths: application/json: schema: type: array - items: &257 + items: &259 title: Org Hook description: Org Hook type: object @@ -37333,7 +37913,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#create-an-organization-webhook parameters: - - *167 + - *71 requestBody: required: true content: @@ -37395,9 +37975,9 @@ paths: description: Response content: application/json: - schema: *257 + schema: *259 examples: - default: &258 + default: &260 value: id: 1 url: https://api.github.com/orgs/octocat/hooks/1 @@ -37441,8 +38021,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#get-an-organization-webhook parameters: - - *167 - - &259 + - *71 + - &261 name: hook_id description: The unique identifier of the hook. You can find this value in the `X-GitHub-Hook-ID` header of a webhook delivery. @@ -37455,9 +38035,9 @@ paths: description: Response content: application/json: - schema: *257 + schema: *259 examples: - default: *258 + default: *260 '404': *6 x-github: githubCloudOnly: false @@ -37478,8 +38058,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#update-an-organization-webhook parameters: - - *167 - - *259 + - *71 + - *261 requestBody: required: false content: @@ -37525,7 +38105,7 @@ paths: description: Response content: application/json: - schema: *257 + schema: *259 examples: default: value: @@ -37564,8 +38144,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#delete-an-organization-webhook parameters: - - *167 - - *259 + - *71 + - *261 responses: '204': description: Response @@ -37590,8 +38170,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#get-a-webhook-configuration-for-an-organization parameters: - - *167 - - *259 + - *71 + - *261 responses: '200': description: Response @@ -37619,8 +38199,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#update-a-webhook-configuration-for-an-organization parameters: - - *167 - - *259 + - *71 + - *261 requestBody: required: false content: @@ -37668,10 +38248,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#list-deliveries-for-an-organization-webhook parameters: - - *167 - - *259 + - *71 + - *261 - *17 - - *260 + - *262 responses: '200': description: Response @@ -37679,9 +38259,9 @@ paths: application/json: schema: type: array - items: *261 + items: *263 examples: - default: *262 + default: *264 '400': *14 '422': *15 x-github: @@ -37704,17 +38284,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#get-a-webhook-delivery-for-an-organization-webhook parameters: - - *167 - - *259 + - *71 + - *261 - *16 responses: '200': description: Response content: application/json: - schema: *263 + schema: *265 examples: - default: *264 + default: *266 '400': *14 '422': *15 x-github: @@ -37737,8 +38317,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#redeliver-a-delivery-for-an-organization-webhook parameters: - - *167 - - *259 + - *71 + - *261 - *16 responses: '202': *37 @@ -37764,8 +38344,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#ping-an-organization-webhook parameters: - - *167 - - *259 + - *71 + - *261 responses: '204': description: Response @@ -37787,8 +38367,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-route-stats-by-actor parameters: - - *167 - - &269 + - *71 + - &271 name: actor_type in: path description: The type of the actor @@ -37801,14 +38381,14 @@ paths: - fine_grained_pat - oauth_app - github_app_user_to_server - - &270 + - &272 name: actor_id in: path description: The ID of the actor required: true schema: type: integer - - &265 + - &267 name: min_timestamp description: 'The minimum timestamp to query for stats. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`.' @@ -37816,7 +38396,7 @@ paths: required: true schema: type: string - - &266 + - &268 name: max_timestamp description: 'The maximum timestamp to query for stats. Defaults to the time 30 days ago. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) @@ -37827,7 +38407,7 @@ paths: type: string - *19 - *17 - - *86 + - *89 - name: sort description: The property to sort the results by. in: query @@ -37910,13 +38490,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-subject-stats parameters: - - *167 - - *265 - - *266 + - *71 + - *267 + - *268 - *19 - *17 - - *86 - - &275 + - *89 + - &277 name: sort description: The property to sort the results by. in: query @@ -37995,15 +38575,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-summary-stats parameters: - - *167 - - *265 - - *266 + - *71 + - *267 + - *268 responses: '200': description: Response content: application/json: - schema: &267 + schema: &269 title: Summary Stats description: API Insights usage summary stats for an organization type: object @@ -38019,7 +38599,7 @@ paths: type: integer format: int64 examples: - default: &268 + default: &270 value: total_request_count: 34225 rate_limited_request_count: 23 @@ -38039,24 +38619,24 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-summary-stats-by-user parameters: - - *167 - - &271 + - *71 + - &273 name: user_id in: path description: The ID of the user to query for stats required: true schema: type: string - - *265 - - *266 + - *267 + - *268 responses: '200': description: Response content: application/json: - schema: *267 + schema: *269 examples: - default: *268 + default: *270 x-github: enabledForGitHubApps: true category: orgs @@ -38074,19 +38654,19 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-summary-stats-by-actor parameters: - - *167 - - *265 - - *266 - - *269 - - *270 + - *71 + - *267 + - *268 + - *271 + - *272 responses: '200': description: Response content: application/json: - schema: *267 + schema: *269 examples: - default: *268 + default: *270 x-github: enabledForGitHubApps: true category: orgs @@ -38103,10 +38683,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-time-stats parameters: - - *167 - - *265 - - *266 - - &272 + - *71 + - *267 + - *268 + - &274 name: timestamp_increment description: The increment of time used to breakdown the query results (5m, 10m, 1h, etc.) @@ -38119,7 +38699,7 @@ paths: description: Response content: application/json: - schema: &273 + schema: &275 title: Time Stats description: API Insights usage time stats for an organization type: array @@ -38135,7 +38715,7 @@ paths: type: integer format: int64 examples: - default: &274 + default: &276 value: - timestamp: '2024-09-11T15:00:00Z' total_request_count: 34225 @@ -38171,19 +38751,19 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-time-stats-by-user parameters: - - *167 - - *271 - - *265 - - *266 - - *272 + - *71 + - *273 + - *267 + - *268 + - *274 responses: '200': description: Response content: application/json: - schema: *273 + schema: *275 examples: - default: *274 + default: *276 x-github: enabledForGitHubApps: true category: orgs @@ -38200,20 +38780,20 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-time-stats-by-actor parameters: - - *167 - - *269 - - *270 - - *265 - - *266 + - *71 + - *271 - *272 + - *267 + - *268 + - *274 responses: '200': description: Response content: application/json: - schema: *273 + schema: *275 examples: - default: *274 + default: *276 x-github: enabledForGitHubApps: true category: orgs @@ -38230,14 +38810,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-user-stats parameters: - - *167 - - *271 - - *265 - - *266 + - *71 + - *273 + - *267 + - *268 - *19 - *17 - - *86 - - *275 + - *89 + - *277 - name: actor_name_substring in: query description: Providing a substring will filter results where the actor name @@ -38313,7 +38893,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#get-an-organization-installation-for-the-authenticated-app parameters: - - *167 + - *71 responses: '200': description: Response @@ -38321,7 +38901,7 @@ paths: application/json: schema: *20 examples: - default: &554 + default: &556 value: id: 1 account: @@ -38390,7 +38970,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/orgs#list-app-installations-for-an-organization parameters: - - *167 + - *71 - *17 - *19 responses: @@ -38479,7 +39059,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/interactions/orgs#get-interaction-restrictions-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -38487,12 +39067,12 @@ paths: application/json: schema: anyOf: - - &277 + - &279 title: Interaction Limits description: Interaction limit settings. type: object properties: - limit: &276 + limit: &278 type: string description: The type of GitHub user that can comment, open issues, or create pull requests while the interaction limit @@ -38520,7 +39100,7 @@ paths: properties: {} additionalProperties: false examples: - default: &278 + default: &280 value: limit: collaborators_only origin: organization @@ -38544,18 +39124,18 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/interactions/orgs#set-interaction-restrictions-for-an-organization parameters: - - *167 + - *71 requestBody: required: true content: application/json: - schema: &555 + schema: &557 title: Interaction Restrictions description: Limit interactions to a specific type of user for a specified duration type: object properties: - limit: *276 + limit: *278 expiry: type: string description: 'The duration of the interaction restriction. Default: @@ -38580,9 +39160,9 @@ paths: description: Response content: application/json: - schema: *277 + schema: *279 examples: - default: *278 + default: *280 '422': *15 x-github: githubCloudOnly: false @@ -38600,7 +39180,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/interactions/orgs#remove-interaction-restrictions-for-an-organization parameters: - - *167 + - *71 responses: '204': description: Response @@ -38626,7 +39206,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#list-pending-organization-invitations parameters: - - *167 + - *71 - *17 - *19 - name: role @@ -38660,9 +39240,9 @@ paths: application/json: schema: type: array - items: *279 + items: *281 examples: - default: *280 + default: *282 headers: Link: *38 '404': *6 @@ -38686,7 +39266,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#create-an-organization-invitation parameters: - - *167 + - *71 requestBody: required: false content: @@ -38740,7 +39320,7 @@ paths: description: Response content: application/json: - schema: *279 + schema: *281 examples: default: value: @@ -38796,8 +39376,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#cancel-an-organization-invitation parameters: - - *167 - - &281 + - *71 + - &283 name: invitation_id description: The unique identifier of the invitation. in: path @@ -38830,8 +39410,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#list-organization-invitation-teams parameters: - - *167 - - *281 + - *71 + - *283 - *17 - *19 responses: @@ -38841,9 +39421,9 @@ paths: application/json: schema: type: array - items: *224 + items: *226 examples: - default: &298 + default: &300 value: - id: 1 node_id: MDQ6VGVhbTE= @@ -38878,7 +39458,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/issue-types#list-issue-types-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -38886,7 +39466,7 @@ paths: application/json: schema: type: array - items: *282 + items: *284 examples: default: value: @@ -38924,7 +39504,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/issue-types#create-issue-type-for-an-organization parameters: - - *167 + - *71 requestBody: required: true content: @@ -38974,9 +39554,9 @@ paths: description: Response content: application/json: - schema: *282 + schema: *284 examples: - default: &283 + default: &285 value: id: 410 node_id: IT_kwDNAd3NAZo @@ -39008,8 +39588,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/issue-types#update-issue-type-for-an-organization parameters: - - *167 - - &284 + - *71 + - &286 name: issue_type_id description: The unique identifier of the issue type. in: path @@ -39065,9 +39645,9 @@ paths: description: Response content: application/json: - schema: *282 + schema: *284 examples: - default: *283 + default: *285 '404': *6 '422': *7 x-github: @@ -39091,8 +39671,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/issue-types#delete-issue-type-for-an-organization parameters: - - *167 - - *284 + - *71 + - *286 responses: '204': description: Response @@ -39125,7 +39705,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#list-organization-issues-assigned-to-the-authenticated-user parameters: - - *167 + - *71 - name: filter description: Indicates which sorts of issues to return. `assigned` means issues assigned to you. `created` means issues created by you. `mentioned` means @@ -39155,7 +39735,7 @@ paths: - closed - all default: open - - *285 + - *287 - name: type description: Can be the name of an issue type. in: query @@ -39173,8 +39753,8 @@ paths: - updated - comments default: created - - *86 - - *141 + - *89 + - *144 - *17 - *19 responses: @@ -39184,9 +39764,9 @@ paths: application/json: schema: type: array - items: *151 + items: *154 examples: - default: *286 + default: *288 headers: Link: *38 '404': *6 @@ -39208,7 +39788,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#list-organization-members parameters: - - *167 + - *71 - name: filter description: Filter members returned in the list. `2fa_disabled` means that only members without [two-factor authentication](https://github.com/blog/1614-two-factor-authentication) @@ -39246,7 +39826,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: *38 '422': *15 @@ -39266,8 +39846,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#check-organization-membership-for-a-user parameters: - - *167 - - *215 + - *71 + - *217 responses: '204': description: Response if requester is an organization member and user is @@ -39289,8 +39869,11 @@ paths: subcategory: members delete: summary: Remove an organization member - description: Removing a user from this list will remove them from all teams - and they will no longer have any access to the organization's repositories. + description: |- + Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories. + + > [!NOTE] + > If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team. tags: - orgs operationId: orgs/remove-member @@ -39298,8 +39881,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#remove-an-organization-member parameters: - - *167 - - *215 + - *71 + - *217 responses: '204': description: Response @@ -39325,8 +39908,8 @@ paths: parameters: - *17 - *19 - - *167 - - *215 + - *71 + - *217 responses: '200': description: Response @@ -39342,11 +39925,11 @@ paths: type: integer codespaces: type: array - items: *288 + items: *290 examples: - default: *289 + default: *291 '304': *35 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -39369,9 +39952,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organizations#delete-a-codespace-from-the-organization parameters: - - *167 - - *215 - - &290 + - *71 + - *217 + - &292 name: codespace_name in: path required: true @@ -39381,7 +39964,7 @@ paths: responses: '202': *37 '304': *35 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -39404,17 +39987,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organizations#stop-a-codespace-for-an-organization-user parameters: - - *167 - - *215 - - *290 + - *71 + - *217 + - *292 responses: '200': description: Response content: application/json: - schema: *288 + schema: *290 examples: - default: &477 + default: &479 value: id: 1 name: monalisa-octocat-hello-world-g4wpq6h95q @@ -39556,7 +40139,7 @@ paths: recent_folders: [] template: '304': *35 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -39587,14 +40170,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/copilot/copilot-user-management#get-copilot-seat-assignment-details-for-a-user parameters: - - *167 - - *215 + - *71 + - *217 responses: '200': description: The user's GitHub Copilot seat details, including usage. content: application/json: - schema: *107 + schema: *110 examples: default: value: @@ -39637,7 +40220,7 @@ paths: members_url: https://api.github.com/teams/1/members{/member} repositories_url: https://api.github.com/teams/1/repos parent: - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -39662,14 +40245,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#get-organization-membership-for-a-user parameters: - - *167 - - *215 + - *71 + - *217 responses: '200': description: Response content: application/json: - schema: &291 + schema: &293 title: Org Membership description: Org Membership type: object @@ -39722,7 +40305,7 @@ paths: - organization - user examples: - response-if-user-has-an-active-admin-membership-with-organization: &292 + response-if-user-has-an-active-admin-membership-with-organization: &294 summary: Response if user has an active admin membership with organization value: url: https://api.github.com/orgs/octocat/memberships/defunkt @@ -39790,8 +40373,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#set-organization-membership-for-a-user parameters: - - *167 - - *215 + - *71 + - *217 requestBody: required: false content: @@ -39819,9 +40402,9 @@ paths: description: Response content: application/json: - schema: *291 + schema: *293 examples: - response-if-user-already-had-membership-with-organization: *292 + response-if-user-already-had-membership-with-organization: *294 '422': *15 '403': *27 x-github: @@ -39835,6 +40418,9 @@ paths: In order to remove a user's membership with an organization, the authenticated user must be an organization owner. If the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases. + + > [!NOTE] + > If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team. tags: - orgs operationId: orgs/remove-membership-for-user @@ -39842,8 +40428,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#remove-organization-membership-for-a-user parameters: - - *167 - - *215 + - *71 + - *217 responses: '204': description: Response @@ -39868,7 +40454,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/orgs#list-organization-migrations parameters: - - *167 + - *71 - *17 - *19 - name: exclude @@ -39890,7 +40476,7 @@ paths: application/json: schema: type: array - items: &293 + items: &295 title: Migration description: A migration. type: object @@ -40147,7 +40733,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/orgs#start-an-organization-migration parameters: - - *167 + - *71 requestBody: required: true content: @@ -40228,7 +40814,7 @@ paths: description: Response content: application/json: - schema: *293 + schema: *295 examples: default: value: @@ -40406,8 +40992,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/orgs#get-an-organization-migration-status parameters: - - *167 - - &294 + - *71 + - &296 name: migration_id description: The unique identifier of the migration. in: path @@ -40435,7 +41021,7 @@ paths: * `failed`, which means the migration failed. content: application/json: - schema: *293 + schema: *295 examples: default: value: @@ -40604,8 +41190,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/orgs#download-an-organization-migration-archive parameters: - - *167 - - *294 + - *71 + - *296 responses: '302': description: Response @@ -40626,8 +41212,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/orgs#delete-an-organization-migration-archive parameters: - - *167 - - *294 + - *71 + - *296 responses: '204': description: Response @@ -40650,9 +41236,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/orgs#unlock-an-organization-repository parameters: - - *167 - - *294 - - &739 + - *71 + - *296 + - &741 name: repo_name description: repo_name parameter in: path @@ -40679,8 +41265,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/orgs#list-repositories-in-an-organization-migration parameters: - - *167 - - *294 + - *71 + - *296 - *17 - *19 responses: @@ -40690,9 +41276,9 @@ paths: application/json: schema: type: array - items: *193 + items: *195 examples: - default: &305 + default: &307 value: - id: 1296269 node_id: MDEwOlJlcG9zaXRvcnkxMjk2MjY5 @@ -40831,7 +41417,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#list-organization-fine-grained-permissions-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -40885,7 +41471,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#get-all-organization-roles-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response - list of organization roles @@ -40901,7 +41487,7 @@ paths: roles: type: array description: The list of organization roles available to the organization. - items: &295 + items: &297 title: Organization Role description: Organization roles type: object @@ -41063,7 +41649,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#create-a-custom-organization-role parameters: - - *167 + - *71 requestBody: required: true content: @@ -41110,7 +41696,7 @@ paths: description: Response content: application/json: - schema: *295 + schema: *297 examples: default: value: @@ -41139,7 +41725,7 @@ paths: updated_at: '2022-07-04T22:19:11Z' '422': *15 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -41161,8 +41747,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#remove-all-organization-roles-for-a-team parameters: - - *167 - - &296 + - *71 + - &298 name: team_slug description: The slug of the team name. in: path @@ -41193,9 +41779,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#assign-an-organization-role-to-a-team parameters: - - *167 - - *296 - - *241 + - *71 + - *298 + - *243 responses: '204': description: Response @@ -41224,9 +41810,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#remove-an-organization-role-from-a-team parameters: - - *167 - - *296 - - *241 + - *71 + - *298 + - *243 responses: '204': description: Response @@ -41251,8 +41837,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#remove-all-organization-roles-for-a-user parameters: - - *167 - - *215 + - *71 + - *217 responses: '204': description: Response @@ -41277,9 +41863,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#assign-an-organization-role-to-a-user parameters: - - *167 - - *215 - - *241 + - *71 + - *217 + - *243 responses: '204': description: Response @@ -41309,9 +41895,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#remove-an-organization-role-from-a-user parameters: - - *167 - - *215 - - *241 + - *71 + - *217 + - *243 responses: '204': description: Response @@ -41339,14 +41925,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#get-an-organization-role parameters: - - *167 - - *241 + - *71 + - *243 responses: '200': description: Response content: application/json: - schema: *295 + schema: *297 examples: default: value: @@ -41403,8 +41989,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#update-a-custom-organization-role parameters: - - *167 - - *241 + - *71 + - *243 requestBody: required: true content: @@ -41443,7 +42029,7 @@ paths: description: Response content: application/json: - schema: *295 + schema: *297 examples: default: value: @@ -41471,7 +42057,7 @@ paths: created_at: '2022-07-04T22:19:11Z' updated_at: '2022-07-04T22:19:11Z' '422': *15 - '409': *94 + '409': *97 '404': *6 x-github: githubCloudOnly: true @@ -41496,8 +42082,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#delete-a-custom-organization-role parameters: - - *167 - - *241 + - *71 + - *243 responses: '204': description: Response @@ -41522,8 +42108,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#list-teams-that-are-assigned-to-an-organization-role parameters: - - *167 - - *241 + - *71 + - *243 - *17 - *19 responses: @@ -41602,7 +42188,7 @@ paths: parent: anyOf: - type: 'null' - - *297 + - *299 required: - id - node_id @@ -41616,7 +42202,7 @@ paths: - slug - parent examples: - default: *298 + default: *300 headers: Link: *38 '404': @@ -41645,8 +42231,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#list-users-that-are-assigned-to-an-organization-role parameters: - - *167 - - *241 + - *71 + - *243 - *17 - *19 responses: @@ -41675,7 +42261,7 @@ paths: inherited_from: description: Team the user has gotten the role through type: array - items: *297 + items: *299 name: type: - string @@ -41792,7 +42378,7 @@ paths: - type - url examples: - default: *287 + default: *289 headers: Link: *38 '404': @@ -41816,7 +42402,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/outside-collaborators#list-outside-collaborators-for-an-organization parameters: - - *167 + - *71 - name: filter description: Filter the list of outside collaborators. `2fa_disabled` means that only outside collaborators without [two-factor authentication](https://github.com/blog/1614-two-factor-authentication) @@ -41843,7 +42429,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: *38 x-github: @@ -41868,8 +42454,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/outside-collaborators#convert-an-organization-member-to-outside-collaborator parameters: - - *167 - - *215 + - *71 + - *217 requestBody: required: false content: @@ -41926,8 +42512,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/outside-collaborators#remove-outside-collaborator-from-an-organization parameters: - - *167 - - *215 + - *71 + - *217 responses: '204': description: Response @@ -41984,8 +42570,8 @@ paths: - docker - nuget - container - - *167 - - &741 + - *71 + - &743 name: visibility description: |- The selected visibility of the packages. This parameter is optional and only filters an existing result set. @@ -42021,12 +42607,12 @@ paths: application/json: schema: type: array - items: *299 + items: *301 examples: - default: *300 + default: *302 '403': *27 '401': *23 - '400': &743 + '400': &745 description: The value of `per_page` multiplied by `page` cannot be greater than 10000. x-github: @@ -42048,7 +42634,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#get-a-package-for-an-organization parameters: - - &301 + - &303 name: package_type description: The type of supported package. Packages in GitHub's Gradle registry have the type `maven`. Docker images pushed to GitHub's Container registry @@ -42066,20 +42652,20 @@ paths: - docker - nuget - container - - &302 + - &304 name: package_name description: The name of the package. in: path required: true schema: type: string - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: *299 + schema: *301 examples: default: value: @@ -42131,9 +42717,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#delete-a-package-for-an-organization parameters: - - *301 - - *302 - - *167 + - *303 + - *304 + - *71 responses: '204': description: Response @@ -42165,9 +42751,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#restore-a-package-for-an-organization parameters: - - *301 - - *302 - - *167 + - *303 + - *304 + - *71 - name: token description: package token schema: @@ -42199,9 +42785,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#list-package-versions-for-a-package-owned-by-an-organization parameters: - - *301 - - *302 - - *167 + - *303 + - *304 + - *71 - *19 - *17 - name: state @@ -42221,7 +42807,7 @@ paths: application/json: schema: type: array - items: &303 + items: &305 title: Package Version description: A version of a software package type: object @@ -42356,10 +42942,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#get-a-package-version-for-an-organization parameters: - - *301 - - *302 - - *167 - - &304 + - *303 + - *304 + - *71 + - &306 name: package_version_id description: Unique identifier of the package version. in: path @@ -42371,7 +42957,7 @@ paths: description: Response content: application/json: - schema: *303 + schema: *305 examples: default: value: @@ -42407,10 +42993,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#delete-package-version-for-an-organization parameters: - - *301 - - *302 - - *167 + - *303 - *304 + - *71 + - *306 responses: '204': description: Response @@ -42442,10 +43028,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#restore-package-version-for-an-organization parameters: - - *301 - - *302 - - *167 + - *303 - *304 + - *71 + - *306 responses: '204': description: Response @@ -42472,10 +43058,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/personal-access-tokens#list-requests-to-access-organization-resources-with-fine-grained-personal-access-tokens parameters: - - *167 + - *71 - *17 - *19 - - &306 + - &308 name: sort description: The property by which to sort the results. in: query @@ -42485,8 +43071,8 @@ paths: enum: - created_at default: created_at - - *86 - - &307 + - *89 + - &309 name: owner description: A list of owner usernames to use to filter the results. in: query @@ -42498,7 +43084,7 @@ paths: type: string examples: - owner[]=octocat1,owner[]=octocat2 - - &308 + - &310 name: repository description: The name of the repository to use to filter the results. in: query @@ -42507,7 +43093,7 @@ paths: type: string examples: - Hello-World - - &309 + - &311 name: permission description: The permission to use to filter the results. in: query @@ -42516,7 +43102,7 @@ paths: type: string examples: - issues_read - - &310 + - &312 name: last_used_before description: 'Only show fine-grained personal access tokens used before the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) @@ -42526,7 +43112,7 @@ paths: schema: type: string format: date-time - - &311 + - &313 name: last_used_after description: 'Only show fine-grained personal access tokens used after the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) @@ -42536,7 +43122,7 @@ paths: schema: type: string format: date-time - - &312 + - &314 name: token_id description: The ID of the token in: query @@ -42549,7 +43135,7 @@ paths: examples: - token_id[]=1,token_id[]=2 responses: - '500': *83 + '500': *86 '422': *15 '404': *6 '403': *27 @@ -42704,7 +43290,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/personal-access-tokens#review-requests-to-access-organization-resources-with-fine-grained-personal-access-tokens parameters: - - *167 + - *71 requestBody: required: true content: @@ -42746,7 +43332,7 @@ paths: action: deny reason: Access is too broad. responses: - '500': *83 + '500': *86 '422': *15 '404': *6 '403': *27 @@ -42771,7 +43357,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/personal-access-tokens#review-a-request-to-access-organization-resources-with-a-fine-grained-personal-access-token parameters: - - *167 + - *71 - name: pat_request_id in: path description: Unique identifier of the request for access via fine-grained @@ -42808,11 +43394,11 @@ paths: action: deny reason: This request is denied because the access is too broad. responses: - '500': *83 + '500': *86 '422': *15 '404': *6 '403': *27 - '204': *116 + '204': *119 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -42833,7 +43419,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/personal-access-tokens#list-repositories-requested-to-be-accessed-by-a-fine-grained-personal-access-token parameters: - - *167 + - *71 - name: pat_request_id in: path description: Unique identifier of the request for access via fine-grained @@ -42844,7 +43430,7 @@ paths: - *17 - *19 responses: - '500': *83 + '500': *86 '404': *6 '403': *27 '200': @@ -42853,9 +43439,9 @@ paths: application/json: schema: type: array - items: *193 + items: *195 examples: - default: *305 + default: *307 headers: Link: *38 x-github: @@ -42878,19 +43464,19 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/personal-access-tokens#list-fine-grained-personal-access-tokens-with-access-to-organization-resources parameters: - - *167 + - *71 - *17 - *19 - - *306 - - *86 - - *307 - *308 + - *89 - *309 - *310 - *311 - *312 + - *313 + - *314 responses: - '500': *83 + '500': *86 '422': *15 '404': *6 '403': *27 @@ -43039,7 +43625,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/personal-access-tokens#update-the-access-to-organization-resources-via-fine-grained-personal-access-tokens parameters: - - *167 + - *71 requestBody: required: true content: @@ -43074,7 +43660,7 @@ paths: - 1296269 - 1296280 responses: - '500': *83 + '500': *86 '404': *6 '202': *37 '403': *27 @@ -43099,7 +43685,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/personal-access-tokens#update-the-access-a-fine-grained-personal-access-token-has-to-organization-resources parameters: - - *167 + - *71 - name: pat_id description: The unique identifier of the fine-grained personal access token. in: path @@ -43127,9 +43713,9 @@ paths: value: action: revoke responses: - '500': *83 + '500': *86 '404': *6 - '204': *116 + '204': *119 '403': *27 '422': *15 x-github: @@ -43151,7 +43737,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/personal-access-tokens#list-repositories-a-fine-grained-personal-access-token-has-access-to parameters: - - *167 + - *71 - name: pat_id in: path description: Unique identifier of the fine-grained personal access token. @@ -43161,7 +43747,7 @@ paths: - *17 - *19 responses: - '500': *83 + '500': *86 '404': *6 '403': *27 '200': @@ -43170,9 +43756,9 @@ paths: application/json: schema: type: array - items: *193 + items: *195 examples: - default: *305 + default: *307 headers: Link: *38 x-github: @@ -43196,7 +43782,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/private-registries/organization-configurations#list-private-registries-for-an-organization parameters: - - *167 + - *71 - *17 - *19 responses: @@ -43214,7 +43800,7 @@ paths: type: integer configurations: type: array - items: &313 + items: &315 title: Organization private registry description: Private registry configuration for an organization type: object @@ -43293,7 +43879,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/private-registries/organization-configurations#create-a-private-registry-for-an-organization parameters: - - *167 + - *71 requestBody: required: true content: @@ -43437,7 +44023,7 @@ paths: - created_at - updated_at examples: - org-private-registry-with-selected-visibility: &314 + org-private-registry-with-selected-visibility: &316 value: name: MAVEN_REPOSITORY_SECRET registry_type: maven_repository @@ -43478,7 +44064,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/private-registries/organization-configurations#get-private-registries-public-key-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -43528,16 +44114,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/private-registries/organization-configurations#get-a-private-registry-for-an-organization parameters: - - *167 - - *203 + - *71 + - *205 responses: '200': description: The specified private registry configuration for the organization content: application/json: - schema: *313 + schema: *315 examples: - default: *314 + default: *316 '404': *6 x-github: githubCloudOnly: false @@ -43558,8 +44144,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/private-registries/organization-configurations#update-a-private-registry-for-an-organization parameters: - - *167 - - *203 + - *71 + - *205 requestBody: required: true content: @@ -43643,8 +44229,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/private-registries/organization-configurations#delete-a-private-registry-for-an-organization parameters: - - *167 - - *203 + - *71 + - *205 responses: '204': description: Response @@ -43669,7 +44255,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/projects#list-organization-projects parameters: - - *167 + - *71 - name: state description: Indicates the state of the projects to return. in: query @@ -43690,7 +44276,7 @@ paths: application/json: schema: type: array - items: &315 + items: &317 title: Project description: Projects are a way to organize columns and cards of work. @@ -43846,7 +44432,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/projects#create-an-organization-project parameters: - - *167 + - *71 requestBody: required: true content: @@ -43872,7 +44458,7 @@ paths: description: Response content: application/json: - schema: *315 + schema: *317 examples: default: value: @@ -43910,7 +44496,7 @@ paths: '401': *23 '403': *27 '404': *6 - '410': &379 + '410': &381 description: Gone content: application/json: @@ -43937,7 +44523,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-properties#get-all-custom-properties-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -43945,9 +44531,9 @@ paths: application/json: schema: type: array - items: *112 + items: *115 examples: - default: *113 + default: *116 '403': *27 '404': *6 x-github: @@ -43974,7 +44560,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-properties#create-or-update-custom-properties-for-an-organization parameters: - - *167 + - *71 requestBody: required: true content: @@ -43985,7 +44571,7 @@ paths: properties: type: array description: The array of custom properties to create or update. - items: *112 + items: *115 minItems: 1 maxItems: 100 required: @@ -44015,9 +44601,9 @@ paths: application/json: schema: type: array - items: *112 + items: *115 examples: - default: *113 + default: *116 '403': *27 '404': *6 x-github: @@ -44038,16 +44624,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-properties#get-a-custom-property-for-an-organization parameters: - - *167 - - *114 + - *71 + - *117 responses: '200': description: Response content: application/json: - schema: *112 + schema: *115 examples: - default: *115 + default: *118 '403': *27 '404': *6 x-github: @@ -44070,13 +44656,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-properties#create-or-update-a-custom-property-for-an-organization parameters: - - *167 - - *114 + - *71 + - *117 requestBody: required: true content: application/json: - schema: *316 + schema: *318 examples: default: value: @@ -44092,9 +44678,9 @@ paths: description: Response content: application/json: - schema: *112 + schema: *115 examples: - default: *115 + default: *118 '403': *27 '404': *6 x-github: @@ -44117,10 +44703,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-properties#remove-a-custom-property-for-an-organization parameters: - - *167 - - *114 + - *71 + - *117 responses: - '204': *116 + '204': *119 '403': *27 '404': *6 x-github: @@ -44141,7 +44727,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-properties#list-custom-property-values-for-organization-repositories parameters: - - *167 + - *71 - *17 - *19 - name: repository_query @@ -44182,7 +44768,7 @@ paths: - octocat/Hello-World properties: type: array - items: &317 + items: &319 title: Custom Property Value description: Custom property name and associated value type: object @@ -44252,7 +44838,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-properties#create-or-update-custom-property-values-for-organization-repositories parameters: - - *167 + - *71 requestBody: required: true content: @@ -44272,7 +44858,7 @@ paths: type: array description: List of custom property names and associated values to apply to the repositories. - items: *317 + items: *319 required: - repository_names - properties @@ -44313,7 +44899,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#list-public-organization-members parameters: - - *167 + - *71 - *17 - *19 responses: @@ -44325,7 +44911,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: *38 x-github: @@ -44344,8 +44930,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#check-public-organization-membership-for-a-user parameters: - - *167 - - *215 + - *71 + - *217 responses: '204': description: Response if user is a public member @@ -44369,8 +44955,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#set-public-organization-membership-for-the-authenticated-user parameters: - - *167 - - *215 + - *71 + - *217 responses: '204': description: Response @@ -44391,8 +44977,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#remove-public-organization-membership-for-the-authenticated-user parameters: - - *167 - - *215 + - *71 + - *217 responses: '204': description: Response @@ -44416,7 +45002,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#list-organization-repositories parameters: - - *167 + - *71 - name: type description: Specifies the types of repositories you want returned. `internal` is not yet supported when a GitHub App calls this endpoint with an installation @@ -44463,9 +45049,9 @@ paths: application/json: schema: type: array - items: *193 + items: *195 examples: - default: *305 + default: *307 headers: Link: *38 x-github: @@ -44486,7 +45072,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#create-an-organization-repository parameters: - - *167 + - *71 requestBody: required: true content: @@ -44669,7 +45255,7 @@ paths: description: Response content: application/json: - schema: &381 + schema: &383 title: Full Repository description: Full Repository type: object @@ -45115,7 +45701,7 @@ paths: license: anyOf: - type: 'null' - - *152 + - *155 organization: anyOf: - type: 'null' @@ -45134,7 +45720,7 @@ paths: description: Whether anonymous git access is allowed. default: true type: boolean - code_of_conduct: &496 + code_of_conduct: &498 title: Code Of Conduct Simple description: Code of Conduct Simple type: object @@ -45164,7 +45750,7 @@ paths: - key - name - html_url - security_and_analysis: *318 + security_and_analysis: *320 custom_properties: type: object description: The custom properties that were defined for the repository. @@ -45248,7 +45834,7 @@ paths: - network_count - subscribers_count examples: - default: &383 + default: &385 value: id: 1296269 node_id: MDEwOlJlcG9zaXRvcnkxMjk2MjY5 @@ -45766,7 +46352,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-roles#list-repository-fine-grained-permissions-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response @@ -45774,9 +46360,9 @@ paths: application/json: schema: type: array - items: *319 + items: *321 examples: - default: *320 + default: *322 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -45798,10 +46384,10 @@ paths: category: orgs subcategory: rules parameters: - - *167 + - *71 - *17 - *19 - - &640 + - &642 name: targets description: | A comma-separated list of rule targets to filter by. @@ -45820,7 +46406,7 @@ paths: application/json: schema: type: array - items: *126 + items: *129 examples: default: value: @@ -45851,7 +46437,7 @@ paths: created_at: '2023-08-15T08:43:03Z' updated_at: '2023-09-23T16:29:47Z' '404': *6 - '500': *83 + '500': *86 post: summary: Create an organization repository ruleset description: Create a repository ruleset for an organization. @@ -45867,7 +46453,7 @@ paths: category: orgs subcategory: rules parameters: - - *167 + - *71 requestBody: description: Request body required: true @@ -45888,16 +46474,16 @@ paths: - push - repository default: branch - enforcement: *123 + enforcement: *126 bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: *124 - conditions: *321 + items: *127 + conditions: *323 rules: type: array description: An array of rules within the ruleset. - items: *125 + items: *128 required: - name - enforcement @@ -45935,9 +46521,9 @@ paths: description: Response content: application/json: - schema: *126 + schema: *129 examples: - default: &322 + default: &324 value: id: 21 name: super cool ruleset @@ -45977,7 +46563,7 @@ paths: created_at: '2023-08-15T08:43:03Z' updated_at: '2023-09-23T16:29:47Z' '404': *6 - '500': *83 + '500': *86 "/orgs/{org}/rulesets/rule-suites": get: summary: List organization rule suites @@ -45991,8 +46577,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/rule-suites#list-organization-rule-suites parameters: - - *167 - - &641 + - *71 + - &643 name: ref description: The name of the ref. Cannot contain wildcard characters. Optionally prefix with `refs/heads/` to limit to branches or `refs/tags/` to limit @@ -46002,16 +46588,16 @@ paths: schema: type: string x-multi-segment: true - - *222 - - *218 - - &642 + - *224 + - *220 + - &644 name: actor_name description: The handle for the GitHub user account to filter on. When specified, only rule evaluations triggered by this actor will be returned. in: query schema: type: string - - &643 + - &645 name: rule_suite_result description: The rule suite results to filter on. When specified, only suites with this result will be returned. @@ -46031,7 +46617,7 @@ paths: description: Response content: application/json: - schema: &644 + schema: &646 title: Rule Suites description: Response type: array @@ -46087,7 +46673,7 @@ paths: whether rules would pass or fail if all rules in the rule suite were `active`. examples: - default: &645 + default: &647 value: - id: 21 actor_id: 12 @@ -46111,7 +46697,7 @@ paths: result: pass evaluation_result: fail '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -46130,8 +46716,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/rule-suites#get-an-organization-rule-suite parameters: - - *167 - - &646 + - *71 + - &648 name: rule_suite_id description: |- The unique identifier of the rule suite result. @@ -46147,7 +46733,7 @@ paths: description: Response content: application/json: - schema: &647 + schema: &649 title: Rule Suite description: Response type: object @@ -46254,7 +46840,7 @@ paths: description: The detailed failure message for the rule. Null if the rule passed. examples: - default: &648 + default: &650 value: id: 21 actor_id: 12 @@ -46289,7 +46875,7 @@ paths: result: fail rule_type: commit_message_pattern '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -46315,7 +46901,7 @@ paths: category: orgs subcategory: rules parameters: - - *167 + - *71 - name: ruleset_id description: The ID of the ruleset. in: path @@ -46327,11 +46913,11 @@ paths: description: Response content: application/json: - schema: *126 + schema: *129 examples: - default: *322 + default: *324 '404': *6 - '500': *83 + '500': *86 put: summary: Update an organization repository ruleset description: Update a ruleset for an organization. @@ -46347,7 +46933,7 @@ paths: category: orgs subcategory: rules parameters: - - *167 + - *71 - name: ruleset_id description: The ID of the ruleset. in: path @@ -46373,16 +46959,16 @@ paths: - tag - push - repository - enforcement: *123 + enforcement: *126 bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: *124 - conditions: *321 + items: *127 + conditions: *323 rules: description: An array of rules within the ruleset. type: array - items: *125 + items: *128 examples: default: value: @@ -46417,11 +47003,11 @@ paths: description: Response content: application/json: - schema: *126 + schema: *129 examples: - default: *322 + default: *324 '404': *6 - '500': *83 + '500': *86 delete: summary: Delete an organization repository ruleset description: Delete a ruleset for an organization. @@ -46437,7 +47023,7 @@ paths: category: orgs subcategory: rules parameters: - - *167 + - *71 - name: ruleset_id description: The ID of the ruleset. in: path @@ -46448,7 +47034,7 @@ paths: '204': description: Response '404': *6 - '500': *83 + '500': *86 "/orgs/{org}/rulesets/{ruleset_id}/history": get: summary: Get organization ruleset history @@ -46460,7 +47046,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/rules#get-organization-ruleset-history parameters: - - *167 + - *71 - *17 - *19 - name: ruleset_id @@ -46476,11 +47062,11 @@ paths: application/json: schema: type: array - items: *129 + items: *132 examples: - default: *323 + default: *325 '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -46497,7 +47083,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/rules#get-organization-ruleset-version parameters: - - *167 + - *71 - name: ruleset_id description: The ID of the ruleset. in: path @@ -46515,7 +47101,7 @@ paths: description: Response content: application/json: - schema: *324 + schema: *326 examples: default: value: @@ -46555,7 +47141,7 @@ paths: operator: contains pattern: github '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -46577,15 +47163,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/secret-scanning/secret-scanning#list-secret-scanning-alerts-for-an-organization parameters: - - *167 - - *325 - - *326 + - *71 - *327 - *328 - - *86 + - *329 + - *330 + - *89 - *19 - *17 - - &650 + - &652 name: before description: A cursor, as given in the [Link header](https://docs.github.com/enterprise-cloud@latest//rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for events before this cursor. To @@ -46595,7 +47181,7 @@ paths: required: false schema: type: string - - &651 + - &653 name: after description: A cursor, as given in the [Link header](https://docs.github.com/enterprise-cloud@latest//rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for events after this cursor. To @@ -46605,10 +47191,10 @@ paths: required: false schema: type: string - - *329 - - *330 - *331 - *332 + - *333 + - *334 responses: '200': description: Response @@ -46616,13 +47202,13 @@ paths: application/json: schema: type: array - items: *333 + items: *335 examples: - default: *334 + default: *336 headers: Link: *38 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -46644,8 +47230,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/repository-advisories#list-repository-security-advisories-for-an-organization parameters: - - *167 - - *86 + - *71 + - *89 - name: sort description: The property to sort the results by. in: query @@ -46657,8 +47243,8 @@ paths: - updated - published default: created - - *84 - - *85 + - *87 + - *88 - name: per_page description: The number of advisories to return per page. For more information, see "[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api)." @@ -46688,7 +47274,7 @@ paths: application/json: schema: type: array - items: &672 + items: &674 description: A repository security advisory. type: object properties: @@ -46896,7 +47482,7 @@ paths: required: - vector_string - score - cvss_severities: *98 + cvss_severities: *101 cwes: type: - array @@ -46932,7 +47518,7 @@ paths: login: type: string description: The username of the user credited. - type: *335 + type: *337 credits_detailed: type: - array @@ -46943,7 +47529,7 @@ paths: type: object properties: user: *4 - type: *335 + type: *337 state: type: string description: The state of the user's acceptance of the @@ -46969,13 +47555,13 @@ paths: - array - 'null' description: A list of teams that collaborate on the advisory. - items: *224 + items: *226 private_fork: readOnly: true description: A temporary private fork of the advisory's repository for collaborating on a fix. allOf: - - *95 + - *98 type: - 'null' required: @@ -47007,7 +47593,7 @@ paths: - private_fork additionalProperties: false examples: - default: &673 + default: &675 value: - ghsa_id: GHSA-abcd-1234-efgh cve_id: CVE-2050-00000 @@ -47386,7 +47972,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/security-managers#list-security-manager-teams parameters: - - *167 + - *71 responses: '200': description: Response @@ -47394,9 +47980,9 @@ paths: application/json: schema: type: array - items: *297 + items: *299 examples: - default: *298 + default: *300 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -47419,8 +48005,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/security-managers#add-a-security-manager-team parameters: - - *167 - - *296 + - *71 + - *298 responses: '204': description: Response @@ -47445,8 +48031,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/security-managers#remove-a-security-manager-team parameters: - - *167 - - *296 + - *71 + - *298 responses: '204': description: Response @@ -47475,15 +48061,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/billing/billing#get-github-actions-billing-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: *336 + schema: *338 examples: - default: *337 + default: *339 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -47507,8 +48093,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/billing/billing#get-github-advanced-security-active-committers-for-an-organization parameters: - - *167 - - *338 + - *71 + - *340 - *17 - *19 responses: @@ -47516,9 +48102,9 @@ paths: description: Success content: application/json: - schema: *339 + schema: *341 examples: - default: *340 + default: *342 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -47540,15 +48126,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/billing/billing#get-github-packages-billing-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: *341 + schema: *343 examples: - default: *342 + default: *344 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -47570,15 +48156,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/billing/billing#get-shared-storage-billing-for-an-organization parameters: - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: *343 + schema: *345 examples: - default: *344 + default: *346 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -47598,7 +48184,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/network-configurations#list-hosted-compute-network-configurations-for-an-organization parameters: - - *167 + - *71 - *17 - *19 responses: @@ -47616,9 +48202,9 @@ paths: type: integer network_configurations: type: array - items: *109 + items: *112 examples: - default: *345 + default: *347 headers: Link: *38 x-github: @@ -47639,7 +48225,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/network-configurations#create-a-hosted-compute-network-configuration-for-an-organization parameters: - - *167 + - *71 requestBody: required: true content: @@ -47681,9 +48267,9 @@ paths: description: Response content: application/json: - schema: *109 + schema: *112 examples: - default: *110 + default: *113 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -47703,16 +48289,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/network-configurations#get-a-hosted-compute-network-configuration-for-an-organization parameters: - - *167 - - *111 + - *71 + - *114 responses: '200': description: Response content: application/json: - schema: *109 + schema: *112 examples: - default: *110 + default: *113 headers: Link: *38 x-github: @@ -47733,8 +48319,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/network-configurations#update-a-hosted-compute-network-configuration-for-an-organization parameters: - - *167 - - *111 + - *71 + - *114 requestBody: required: true content: @@ -47773,9 +48359,9 @@ paths: description: Response content: application/json: - schema: *109 + schema: *112 examples: - default: *110 + default: *113 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -47794,8 +48380,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/network-configurations#delete-a-hosted-compute-network-configuration-from-an-organization parameters: - - *167 - - *111 + - *71 + - *114 responses: '204': description: Response @@ -47818,16 +48404,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/network-configurations#get-a-hosted-compute-network-settings-resource-for-an-organization parameters: - - *167 - - *346 + - *71 + - *348 responses: '200': description: Response content: application/json: - schema: *347 + schema: *349 examples: - default: *348 + default: *350 headers: Link: *38 x-github: @@ -47846,7 +48432,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/team-sync#list-idp-groups-for-an-organization parameters: - - *167 + - *71 - *17 - name: page description: Page token @@ -47865,7 +48451,7 @@ paths: description: Response content: application/json: - schema: &370 + schema: &372 title: GroupMapping description: External Groups to be mapped to a team for membership type: object @@ -47917,7 +48503,7 @@ paths: group_description: Another group of Developers working on AzureAD SAML SSO examples: - default: &371 + default: &373 value: groups: - group_id: '123' @@ -47962,8 +48548,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/copilot/copilot-metrics#get-copilot-metrics-for-a-team parameters: - - *167 - - *296 + - *71 + - *298 - name: since description: Show usage metrics since this date. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format (`YYYY-MM-DDTHH:MM:SSZ`). @@ -47995,13 +48581,13 @@ paths: application/json: schema: type: array - items: *134 + items: *137 examples: - default: *135 - '500': *83 + default: *138 + '500': *86 '403': *27 '404': *6 - '422': *136 + '422': *139 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -48019,7 +48605,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#list-teams parameters: - - *167 + - *71 - *17 - *19 responses: @@ -48029,9 +48615,9 @@ paths: application/json: schema: type: array - items: *224 + items: *226 examples: - default: *298 + default: *300 headers: Link: *38 '403': *27 @@ -48053,7 +48639,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#create-a-team parameters: - - *167 + - *71 requestBody: required: true content: @@ -48125,7 +48711,7 @@ paths: description: Response content: application/json: - schema: &349 + schema: &351 title: Full Team description: Groups of organization members that gives permissions on specified repositories. @@ -48199,7 +48785,7 @@ paths: parent: anyOf: - type: 'null' - - *297 + - *299 members_count: type: integer examples: @@ -48505,7 +49091,7 @@ paths: - repos_count - organization examples: - default: &350 + default: &352 value: id: 1 node_id: MDQ6VGVhbTE= @@ -48575,16 +49161,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#get-a-team-by-name parameters: - - *167 - - *296 + - *71 + - *298 responses: '200': description: Response content: application/json: - schema: *349 + schema: *351 examples: - default: *350 + default: *352 '404': *6 x-github: githubCloudOnly: false @@ -48605,8 +49191,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#update-a-team parameters: - - *167 - - *296 + - *71 + - *298 requestBody: required: false content: @@ -48669,16 +49255,16 @@ paths: description: Response when the updated information already exists content: application/json: - schema: *349 + schema: *351 examples: - default: *350 + default: *352 '201': description: Response content: application/json: - schema: *349 + schema: *351 examples: - default: *350 + default: *352 '404': *6 '422': *15 '403': *27 @@ -48703,8 +49289,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#delete-a-team parameters: - - *167 - - *296 + - *71 + - *298 responses: '204': description: Response @@ -48730,9 +49316,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussions#list-discussions parameters: - - *167 - - *296 - - *86 + - *71 + - *298 + - *89 - *17 - *19 - name: pinned @@ -48748,7 +49334,7 @@ paths: application/json: schema: type: array - items: &351 + items: &353 title: Team Discussion description: A team discussion is a persistent record of a free-form conversation within a team. @@ -48839,7 +49425,7 @@ paths: format: uri examples: - https://api.github.com/organizations/1/team/2343027/discussions/1 - reactions: *139 + reactions: *142 required: - author - body @@ -48859,7 +49445,7 @@ paths: - updated_at - url examples: - default: &713 + default: &715 value: - author: login: octocat @@ -48933,8 +49519,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussions#create-a-discussion parameters: - - *167 - - *296 + - *71 + - *298 requestBody: required: true content: @@ -48968,9 +49554,9 @@ paths: description: Response content: application/json: - schema: *351 + schema: *353 examples: - default: &352 + default: &354 value: author: login: octocat @@ -49042,9 +49628,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussions#get-a-discussion parameters: - - *167 - - *296 - - &353 + - *71 + - *298 + - &355 name: discussion_number description: The number that identifies the discussion. in: path @@ -49056,9 +49642,9 @@ paths: description: Response content: application/json: - schema: *351 + schema: *353 examples: - default: *352 + default: *354 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -49080,9 +49666,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussions#update-a-discussion parameters: - - *167 - - *296 - - *353 + - *71 + - *298 + - *355 requestBody: required: false content: @@ -49105,9 +49691,9 @@ paths: description: Response content: application/json: - schema: *351 + schema: *353 examples: - default: &714 + default: &716 value: author: login: octocat @@ -49177,9 +49763,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussions#delete-a-discussion parameters: - - *167 - - *296 - - *353 + - *71 + - *298 + - *355 responses: '204': description: Response @@ -49205,10 +49791,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussion-comments#list-discussion-comments parameters: - - *167 - - *296 - - *353 - - *86 + - *71 + - *298 + - *355 + - *89 - *17 - *19 responses: @@ -49218,7 +49804,7 @@ paths: application/json: schema: type: array - items: &354 + items: &356 title: Team Discussion Comment description: A reply to a discussion within a team. type: object @@ -49283,7 +49869,7 @@ paths: format: uri examples: - https://api.github.com/organizations/1/team/2403582/discussions/1/comments/1 - reactions: *139 + reactions: *142 required: - author - body @@ -49298,7 +49884,7 @@ paths: - updated_at - url examples: - default: &715 + default: &717 value: - author: login: octocat @@ -49366,9 +49952,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussion-comments#create-a-discussion-comment parameters: - - *167 - - *296 - - *353 + - *71 + - *298 + - *355 requestBody: required: true content: @@ -49390,9 +49976,9 @@ paths: description: Response content: application/json: - schema: *354 + schema: *356 examples: - default: &355 + default: &357 value: author: login: octocat @@ -49458,10 +50044,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussion-comments#get-a-discussion-comment parameters: - - *167 - - *296 - - *353 - - &356 + - *71 + - *298 + - *355 + - &358 name: comment_number description: The number that identifies the comment. in: path @@ -49473,9 +50059,9 @@ paths: description: Response content: application/json: - schema: *354 + schema: *356 examples: - default: *355 + default: *357 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -49497,10 +50083,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussion-comments#update-a-discussion-comment parameters: - - *167 - - *296 - - *353 - - *356 + - *71 + - *298 + - *355 + - *358 requestBody: required: true content: @@ -49522,9 +50108,9 @@ paths: description: Response content: application/json: - schema: *354 + schema: *356 examples: - default: &716 + default: &718 value: author: login: octocat @@ -49588,10 +50174,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussion-comments#delete-a-discussion-comment parameters: - - *167 - - *296 - - *353 - - *356 + - *71 + - *298 + - *355 + - *358 responses: '204': description: Response @@ -49617,10 +50203,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#list-reactions-for-a-team-discussion-comment parameters: - - *167 - - *296 - - *353 - - *356 + - *71 + - *298 + - *355 + - *358 - name: content description: Returns a single [reaction type](https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to a team discussion comment. @@ -49646,7 +50232,7 @@ paths: application/json: schema: type: array - items: &357 + items: &359 title: Reaction description: Reactions to conversations provide a way to help people express their feelings more simply and effectively. @@ -49690,7 +50276,7 @@ paths: - content - created_at examples: - default: &359 + default: &361 value: - id: 1 node_id: MDg6UmVhY3Rpb24x @@ -49740,10 +50326,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#create-reaction-for-a-team-discussion-comment parameters: - - *167 - - *296 - - *353 - - *356 + - *71 + - *298 + - *355 + - *358 requestBody: required: true content: @@ -49776,9 +50362,9 @@ paths: team discussion comment content: application/json: - schema: *357 + schema: *359 examples: - default: &358 + default: &360 value: id: 1 node_id: MDg6UmVhY3Rpb24x @@ -49807,9 +50393,9 @@ paths: description: Response content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -49832,11 +50418,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#delete-team-discussion-comment-reaction parameters: - - *167 - - *296 - - *353 - - *356 - - &360 + - *71 + - *298 + - *355 + - *358 + - &362 name: reaction_id description: The unique identifier of the reaction. in: path @@ -49868,9 +50454,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#list-reactions-for-a-team-discussion parameters: - - *167 - - *296 - - *353 + - *71 + - *298 + - *355 - name: content description: Returns a single [reaction type](https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to a team discussion. @@ -49896,9 +50482,9 @@ paths: application/json: schema: type: array - items: *357 + items: *359 examples: - default: *359 + default: *361 headers: Link: *38 x-github: @@ -49924,9 +50510,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#create-reaction-for-a-team-discussion parameters: - - *167 - - *296 - - *353 + - *71 + - *298 + - *355 requestBody: required: true content: @@ -49958,16 +50544,16 @@ paths: description: Response content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 '201': description: Response content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -49990,10 +50576,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#delete-team-discussion-reaction parameters: - - *167 - - *296 - - *353 - - *360 + - *71 + - *298 + - *355 + - *362 responses: '204': description: Response @@ -50016,16 +50602,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/external-groups#list-a-connection-between-an-external-group-and-a-team parameters: - - *167 - - *296 + - *71 + - *298 responses: '200': description: Response content: application/json: - schema: *361 + schema: *363 examples: - default: *362 + default: *364 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -50044,8 +50630,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/external-groups#update-the-connection-between-an-external-group-and-a-team parameters: - - *167 - - *296 + - *71 + - *298 requestBody: required: true content: @@ -50069,9 +50655,9 @@ paths: description: Response content: application/json: - schema: *363 + schema: *365 examples: - default: *364 + default: *366 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -50090,8 +50676,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/external-groups#remove-the-connection-between-an-external-group-and-a-team parameters: - - *167 - - *296 + - *71 + - *298 responses: '204': description: Response @@ -50115,8 +50701,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#list-pending-team-invitations parameters: - - *167 - - *296 + - *71 + - *298 - *17 - *19 responses: @@ -50126,9 +50712,9 @@ paths: application/json: schema: type: array - items: *279 + items: *281 examples: - default: *280 + default: *282 headers: Link: *38 x-github: @@ -50150,8 +50736,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#list-team-members parameters: - - *167 - - *296 + - *71 + - *298 - name: role description: Filters members returned by their role in the team. in: query @@ -50174,7 +50760,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: *38 x-github: @@ -50204,15 +50790,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#get-team-membership-for-a-user parameters: - - *167 - - *296 - - *215 + - *71 + - *298 + - *217 responses: '200': description: Response content: application/json: - schema: &365 + schema: &367 title: Team Membership description: Team Membership type: object @@ -50240,7 +50826,7 @@ paths: - state - url examples: - response-if-user-is-a-team-maintainer: &717 + response-if-user-is-a-team-maintainer: &719 summary: Response if user is a team maintainer value: url: https://api.github.com/teams/1/memberships/octocat @@ -50276,9 +50862,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#add-or-update-team-membership-for-a-user parameters: - - *167 - - *296 - - *215 + - *71 + - *298 + - *217 requestBody: required: false content: @@ -50303,9 +50889,9 @@ paths: description: Response content: application/json: - schema: *365 + schema: *367 examples: - response-if-users-membership-with-team-is-now-pending: &718 + response-if-users-membership-with-team-is-now-pending: &720 summary: Response if user's membership with team is now pending value: url: https://api.github.com/teams/1/memberships/octocat @@ -50340,9 +50926,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#remove-team-membership-for-a-user parameters: - - *167 - - *296 - - *215 + - *71 + - *298 + - *217 responses: '204': description: Response @@ -50367,8 +50953,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#list-team-projects parameters: - - *167 - - *296 + - *71 + - *298 - *17 - *19 responses: @@ -50378,7 +50964,7 @@ paths: application/json: schema: type: array - items: &366 + items: &368 title: Team Project description: A team's access to a project. type: object @@ -50447,7 +51033,7 @@ paths: - updated_at - permissions examples: - default: &719 + default: &721 value: - owner_url: https://api.github.com/orgs/octocat url: https://api.github.com/projects/1002605 @@ -50510,9 +51096,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#check-team-permissions-for-a-project parameters: - - *167 - - *296 - - &367 + - *71 + - *298 + - &369 name: project_id description: The unique identifier of the project. in: path @@ -50524,9 +51110,9 @@ paths: description: Response content: application/json: - schema: *366 + schema: *368 examples: - default: &720 + default: &722 value: owner_url: https://api.github.com/orgs/octocat url: https://api.github.com/projects/1002605 @@ -50588,9 +51174,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#add-or-update-team-project-permissions parameters: - - *167 - - *296 - - *367 + - *71 + - *298 + - *369 requestBody: required: false content: @@ -50657,9 +51243,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#remove-a-project-from-a-team parameters: - - *167 - - *296 - - *367 + - *71 + - *298 + - *369 responses: '204': description: Response @@ -50686,8 +51272,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#list-team-repositories parameters: - - *167 - - *296 + - *71 + - *298 - *17 - *19 responses: @@ -50697,9 +51283,9 @@ paths: application/json: schema: type: array - items: *193 + items: *195 examples: - default: *305 + default: *307 headers: Link: *38 x-github: @@ -50728,16 +51314,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#check-team-permissions-for-a-repository parameters: - - *167 - - *296 - - *368 - - *369 + - *71 + - *298 + - *370 + - *371 responses: '200': description: Alternative response with repository permissions content: application/json: - schema: &721 + schema: &723 title: Team Repository description: A team's access to a repository. type: object @@ -50763,7 +51349,7 @@ paths: license: anyOf: - type: 'null' - - *152 + - *155 forks: type: integer permissions: @@ -51378,10 +51964,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#add-or-update-team-repository-permissions parameters: - - *167 - - *296 - - *368 - - *369 + - *71 + - *298 + - *370 + - *371 requestBody: required: false content: @@ -51426,10 +52012,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#remove-a-repository-from-a-team parameters: - - *167 - - *296 - - *368 - - *369 + - *71 + - *298 + - *370 + - *371 responses: '204': description: Response @@ -51455,16 +52041,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/team-sync#list-idp-groups-for-a-team parameters: - - *167 - - *296 + - *71 + - *298 responses: '200': description: Response content: application/json: - schema: *370 + schema: *372 examples: - default: *371 + default: *373 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -51486,8 +52072,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/team-sync#create-or-update-idp-group-connections parameters: - - *167 - - *296 + - *71 + - *298 requestBody: required: true content: @@ -51530,7 +52116,7 @@ paths: description: Response content: application/json: - schema: *370 + schema: *372 examples: default: value: @@ -51562,8 +52148,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#list-child-teams parameters: - - *167 - - *296 + - *71 + - *298 - *17 - *19 responses: @@ -51573,9 +52159,9 @@ paths: application/json: schema: type: array - items: *224 + items: *226 examples: - response-if-child-teams-exist: &722 + response-if-child-teams-exist: &724 value: - id: 2 node_id: MDQ6VGVhbTI= @@ -51628,7 +52214,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/orgs#enable-or-disable-a-security-feature-for-an-organization parameters: - - *167 + - *71 - name: security_product in: path description: The security feature to enable or disable. @@ -51702,7 +52288,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/cards#get-a-project-card parameters: - - &372 + - &374 name: card_id description: The unique identifier of the card. in: path @@ -51714,7 +52300,7 @@ paths: description: Response content: application/json: - schema: &373 + schema: &375 title: Project Card description: Project cards represent a scope of work. type: object @@ -51789,7 +52375,7 @@ paths: - created_at - updated_at examples: - default: &374 + default: &376 value: url: https://api.github.com/projects/columns/cards/1478 id: 1478 @@ -51845,7 +52431,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/cards#update-an-existing-project-card parameters: - - *372 + - *374 requestBody: required: false content: @@ -51875,9 +52461,9 @@ paths: description: Response content: application/json: - schema: *373 + schema: *375 examples: - default: *374 + default: *376 '304': *35 '403': *27 '401': *23 @@ -51904,7 +52490,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/cards#delete-a-project-card parameters: - - *372 + - *374 responses: '204': description: Response @@ -51948,7 +52534,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/cards#move-a-project-card parameters: - - *372 + - *374 requestBody: required: true content: @@ -52061,7 +52647,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/columns#get-a-project-column parameters: - - &375 + - &377 name: column_id description: The unique identifier of the column. in: path @@ -52073,7 +52659,7 @@ paths: description: Response content: application/json: - schema: &376 + schema: &378 title: Project Column description: Project columns contain cards of work. type: object @@ -52127,7 +52713,7 @@ paths: - created_at - updated_at examples: - default: &377 + default: &379 value: url: https://api.github.com/projects/columns/367 project_url: https://api.github.com/projects/120 @@ -52162,7 +52748,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/columns#update-an-existing-project-column parameters: - - *375 + - *377 requestBody: required: true content: @@ -52187,9 +52773,9 @@ paths: description: Response content: application/json: - schema: *376 + schema: *378 examples: - default: *377 + default: *379 '304': *35 '403': *27 '401': *23 @@ -52214,7 +52800,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/columns#delete-a-project-column parameters: - - *375 + - *377 responses: '204': description: Response @@ -52243,7 +52829,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/cards#list-project-cards parameters: - - *375 + - *377 - name: archived_state description: Filters the project cards that are returned by the card's state. in: query @@ -52264,7 +52850,7 @@ paths: application/json: schema: type: array - items: *373 + items: *375 examples: default: value: @@ -52323,7 +52909,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/cards#create-a-project-card parameters: - - *375 + - *377 requestBody: required: true content: @@ -52367,9 +52953,9 @@ paths: description: Response content: application/json: - schema: *373 + schema: *375 examples: - default: *374 + default: *376 '304': *35 '403': *27 '401': *23 @@ -52379,8 +52965,8 @@ paths: application/json: schema: oneOf: - - *176 - - *177 + - *178 + - *179 '503': description: Response content: @@ -52425,7 +53011,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/columns#move-a-project-column parameters: - - *375 + - *377 requestBody: required: true content: @@ -52486,15 +53072,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/projects#get-a-project parameters: - - *367 + - *369 responses: '200': description: Response content: application/json: - schema: *315 + schema: *317 examples: - default: &378 + default: &380 value: owner_url: https://api.github.com/repos/api-playground/projects-test url: https://api.github.com/projects/1002604 @@ -52551,7 +53137,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/projects#update-a-project parameters: - - *367 + - *369 requestBody: required: false content: @@ -52600,9 +53186,9 @@ paths: description: Response content: application/json: - schema: *315 + schema: *317 examples: - default: *378 + default: *380 '404': description: Not Found if the authenticated user does not have access to the project @@ -52623,7 +53209,7 @@ paths: items: type: string '401': *23 - '410': *379 + '410': *381 '422': *7 x-github: githubCloudOnly: false @@ -52646,7 +53232,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/projects#delete-a-project parameters: - - *367 + - *369 responses: '204': description: Delete Success @@ -52667,7 +53253,7 @@ paths: items: type: string '401': *23 - '410': *379 + '410': *381 '404': *6 x-github: githubCloudOnly: false @@ -52691,7 +53277,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/collaborators#list-project-collaborators parameters: - - *367 + - *369 - name: affiliation description: Filters the collaborators by their affiliation. `outside` means outside collaborators of a project that are not a member of the project's @@ -52718,7 +53304,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: *38 '404': *6 @@ -52748,8 +53334,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/collaborators#add-project-collaborator parameters: - - *367 - - *215 + - *369 + - *217 requestBody: required: false content: @@ -52803,8 +53389,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/collaborators#remove-user-as-a-collaborator parameters: - - *367 - - *215 + - *369 + - *217 responses: '204': description: Response @@ -52835,8 +53421,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/collaborators#get-project-permission-for-a-user parameters: - - *367 - - *215 + - *369 + - *217 responses: '200': description: Response @@ -52906,7 +53492,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/columns#list-project-columns parameters: - - *367 + - *369 - *17 - *19 responses: @@ -52916,7 +53502,7 @@ paths: application/json: schema: type: array - items: *376 + items: *378 examples: default: value: @@ -52954,7 +53540,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/columns#create-a-project-column parameters: - - *367 + - *369 requestBody: required: true content: @@ -52978,7 +53564,7 @@ paths: description: Response content: application/json: - schema: *376 + schema: *378 examples: default: value: @@ -53043,7 +53629,7 @@ paths: resources: type: object properties: - core: &380 + core: &382 title: Rate Limit type: object properties: @@ -53060,21 +53646,21 @@ paths: - remaining - reset - used - graphql: *380 - search: *380 - code_search: *380 - source_import: *380 - integration_manifest: *380 - code_scanning_upload: *380 - actions_runner_registration: *380 - scim: *380 - dependency_snapshots: *380 - dependency_sbom: *380 - code_scanning_autofix: *380 + graphql: *382 + search: *382 + code_search: *382 + source_import: *382 + integration_manifest: *382 + code_scanning_upload: *382 + actions_runner_registration: *382 + scim: *382 + dependency_snapshots: *382 + dependency_sbom: *382 + code_scanning_autofix: *382 required: - core - search - rate: *380 + rate: *382 required: - rate - resources @@ -53178,14 +53764,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#get-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response content: application/json: - schema: *381 + schema: *383 examples: default-response: summary: Default response @@ -53690,7 +54276,7 @@ paths: status: disabled '403': *27 '404': *6 - '301': *382 + '301': *384 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -53708,8 +54294,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#update-a-repository parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: false content: @@ -53964,10 +54550,10 @@ paths: description: Response content: application/json: - schema: *381 + schema: *383 examples: - default: *383 - '307': &384 + default: *385 + '307': &386 description: Temporary Redirect content: application/json: @@ -53996,8 +54582,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#delete-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response @@ -54019,9 +54605,9 @@ paths: value: message: Organization members cannot delete repositories. documentation_url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#delete-a-repository - '307': *384 + '307': *386 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -54043,11 +54629,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/artifacts#list-artifacts-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 - - &399 + - &401 name: name description: The name field of an artifact. When specified, only artifacts with this name will be returned. @@ -54070,7 +54656,7 @@ paths: type: integer artifacts: type: array - items: &385 + items: &387 title: Artifact description: An artifact type: object @@ -54165,7 +54751,7 @@ paths: - expires_at - updated_at examples: - default: &400 + default: &402 value: total_count: 2 artifacts: @@ -54226,9 +54812,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/artifacts#get-an-artifact parameters: - - *368 - - *369 - - &386 + - *370 + - *371 + - &388 name: artifact_id description: The unique identifier of the artifact. in: path @@ -54240,7 +54826,7 @@ paths: description: Response content: application/json: - schema: *385 + schema: *387 examples: default: value: @@ -54278,9 +54864,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/artifacts#delete-an-artifact parameters: - - *368 - - *369 - - *386 + - *370 + - *371 + - *388 responses: '204': description: Response @@ -54304,9 +54890,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/artifacts#download-an-artifact parameters: - - *368 - - *369 - - *386 + - *370 + - *371 + - *388 - name: archive_format in: path required: true @@ -54320,7 +54906,7 @@ paths: example: https://pipelines.actions.githubusercontent.com/OhgS4QRKqmgx7bKC27GKU83jnQjyeqG8oIMTge8eqtheppcmw8/_apis/pipelines/1/runs/176/signedlogcontent?urlExpires=2020-01-24T18%3A10%3A31.5729946Z&urlSigningMethod=HMACV1&urlSignature=agG73JakPYkHrh06seAkvmH7rBR4Ji4c2%2B6a2ejYh3E%3D schema: type: string - '410': *379 + '410': *381 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -54343,14 +54929,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/cache#get-github-actions-cache-usage-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response content: application/json: - schema: *387 + schema: *389 examples: default: value: @@ -54376,11 +54962,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/cache#list-github-actions-caches-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 - - &388 + - &390 name: ref description: The full Git reference for narrowing down the cache. The `ref` for a branch should be formatted as `refs/heads/`. To reference @@ -54408,13 +54994,13 @@ paths: - last_accessed_at - size_in_bytes default: last_accessed_at - - *86 + - *89 responses: '200': description: Response content: application/json: - schema: &389 + schema: &391 title: Repository actions caches description: Repository actions caches type: object @@ -54464,7 +55050,7 @@ paths: - total_count - actions_caches examples: - default: &390 + default: &392 value: total_count: 1 actions_caches: @@ -54496,23 +55082,23 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/cache#delete-github-actions-caches-for-a-repository-using-a-cache-key parameters: - - *368 - - *369 + - *370 + - *371 - name: key description: A key for identifying the cache. in: query required: true schema: type: string - - *388 + - *390 responses: '200': description: Response content: application/json: - schema: *389 + schema: *391 examples: - default: *390 + default: *392 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -54532,8 +55118,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/cache#delete-a-github-actions-cache-for-a-repository-using-a-cache-id parameters: - - *368 - - *369 + - *370 + - *371 - name: cache_id description: The unique identifier of the GitHub Actions cache. in: path @@ -54564,9 +55150,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-jobs#get-a-job-for-a-workflow-run parameters: - - *368 - - *369 - - &391 + - *370 + - *371 + - &393 name: job_id description: The unique identifier of the job. in: path @@ -54578,7 +55164,7 @@ paths: description: Response content: application/json: - schema: &403 + schema: &405 title: Job description: Information of a job execution in a workflow run type: object @@ -54925,9 +55511,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-jobs#download-job-logs-for-a-workflow-run parameters: - - *368 - - *369 - - *391 + - *370 + - *371 + - *393 responses: '302': description: Response @@ -54955,9 +55541,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#re-run-a-job-from-a-workflow-run parameters: - - *368 - - *369 - - *391 + - *370 + - *371 + - *393 requestBody: required: false content: @@ -54979,7 +55565,7 @@ paths: description: Response content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -55003,8 +55589,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/oidc#get-the-customization-template-for-an-oidc-subject-claim-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Status response @@ -55054,8 +55640,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/oidc#set-the-customization-template-for-an-oidc-subject-claim-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -55089,7 +55675,7 @@ paths: description: Empty response content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -55118,8 +55704,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#list-repository-organization-secrets parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -55137,7 +55723,7 @@ paths: type: integer secrets: type: array - items: &405 + items: &407 title: Actions Secret description: Set secrets for GitHub Actions. type: object @@ -55158,7 +55744,7 @@ paths: - created_at - updated_at examples: - default: &406 + default: &408 value: total_count: 2 secrets: @@ -55191,9 +55777,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#list-repository-organization-variables parameters: - - *368 - - *369 - - *392 + - *370 + - *371 + - *394 - *19 responses: '200': @@ -55210,7 +55796,7 @@ paths: type: integer variables: type: array - items: &409 + items: &411 title: Actions Variable type: object properties: @@ -55244,7 +55830,7 @@ paths: - created_at - updated_at examples: - default: &410 + default: &412 value: total_count: 2 variables: @@ -55277,8 +55863,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#get-github-actions-permissions-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -55287,11 +55873,11 @@ paths: schema: type: object properties: - enabled: &393 + enabled: &395 type: boolean description: Whether GitHub Actions is enabled on the repository. allowed_actions: *47 - selected_actions_url: *186 + selected_actions_url: *188 required: - enabled examples: @@ -55320,8 +55906,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#set-github-actions-permissions-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response @@ -55332,7 +55918,7 @@ paths: schema: type: object properties: - enabled: *393 + enabled: *395 allowed_actions: *47 required: - enabled @@ -55363,14 +55949,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#get-the-level-of-access-for-workflows-outside-of-the-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response content: application/json: - schema: &394 + schema: &396 type: object properties: access_level: @@ -55388,7 +55974,7 @@ paths: required: - access_level examples: - default: &395 + default: &397 value: access_level: organization x-github: @@ -55413,15 +55999,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#set-the-level-of-access-for-workflows-outside-of-the-repository parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: application/json: - schema: *394 + schema: *396 examples: - default: *395 + default: *397 responses: '204': description: Response @@ -55445,8 +56031,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#get-allowed-actions-and-reusable-workflows-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -55477,8 +56063,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#set-allowed-actions-and-reusable-workflows-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response @@ -55510,14 +56096,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#get-default-workflow-permissions-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response content: application/json: - schema: *189 + schema: *191 examples: default: *53 x-github: @@ -55540,8 +56126,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#set-default-workflow-permissions-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Success response @@ -55552,7 +56138,7 @@ paths: required: true content: application/json: - schema: *190 + schema: *192 examples: default: *53 x-github: @@ -55581,8 +56167,8 @@ paths: in: query schema: type: string - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -55626,8 +56212,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#list-runner-applications-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -55635,9 +56221,9 @@ paths: application/json: schema: type: array - items: *194 + items: *196 examples: - default: *195 + default: *197 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -55659,8 +56245,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#create-configuration-for-a-just-in-time-runner-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -55703,10 +56289,10 @@ paths: - no-gpu work_folder: _work responses: - '201': *196 + '201': *198 '404': *6 '422': *7 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -55734,8 +56320,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#create-a-registration-token-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '201': description: Response @@ -55743,7 +56329,7 @@ paths: application/json: schema: *63 examples: - default: *197 + default: *199 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -55771,8 +56357,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#create-a-remove-token-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '201': description: Response @@ -55780,7 +56366,7 @@ paths: application/json: schema: *63 examples: - default: *198 + default: *200 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -55802,8 +56388,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#get-a-self-hosted-runner-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - *59 responses: '200': @@ -55812,7 +56398,7 @@ paths: application/json: schema: *60 examples: - default: *199 + default: *201 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -55833,8 +56419,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#delete-a-self-hosted-runner-from-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - *59 responses: '204': @@ -55861,8 +56447,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#list-labels-for-a-self-hosted-runner-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - *59 responses: '200': *65 @@ -55887,8 +56473,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#add-custom-labels-to-a-self-hosted-runner-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - *59 requestBody: required: true @@ -55937,8 +56523,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#set-custom-labels-for-a-self-hosted-runner-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - *59 requestBody: required: true @@ -55988,11 +56574,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#remove-all-custom-labels-from-a-self-hosted-runner-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - *59 responses: - '200': *200 + '200': *202 '404': *6 x-github: githubCloudOnly: false @@ -56019,10 +56605,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#remove-a-custom-label-from-a-self-hosted-runner-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - *59 - - *201 + - *203 responses: '200': *65 '404': *6 @@ -56050,9 +56636,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#list-workflow-runs-for-a-repository parameters: - - *368 - - *369 - - &413 + - *370 + - *371 + - &415 name: actor description: Returns someone's workflow runs. Use the login for the user who created the `push` associated with the check suite or workflow run. @@ -56060,7 +56646,7 @@ paths: required: false schema: type: string - - &414 + - &416 name: branch description: Returns workflow runs associated with a branch. Use the name of the branch of the `push`. @@ -56068,7 +56654,7 @@ paths: required: false schema: type: string - - &415 + - &417 name: event description: Returns workflow run triggered by the event you specify. For example, `push`, `pull_request` or `issue`. For more information, see "[Events @@ -56077,7 +56663,7 @@ paths: required: false schema: type: string - - &416 + - &418 name: status description: Returns workflow runs with the check run `status` or `conclusion` that you specify. For example, a conclusion can be `success` or a status @@ -56104,7 +56690,7 @@ paths: - pending - *17 - *19 - - &417 + - &419 name: created description: Returns workflow runs created within the given date-time range. For more information on the syntax, see "[Understanding the search syntax](https://docs.github.com/enterprise-cloud@latest//search-github/getting-started-with-searching-on-github/understanding-the-search-syntax#query-for-dates)." @@ -56113,7 +56699,7 @@ paths: schema: type: string format: date-time - - &396 + - &398 name: exclude_pull_requests description: If `true` pull requests are omitted from the response (empty array). @@ -56122,13 +56708,13 @@ paths: schema: type: boolean default: false - - &418 + - &420 name: check_suite_id description: Returns workflow runs with the `check_suite_id` that you specify. in: query schema: type: integer - - &419 + - &421 name: head_sha description: Only returns workflow runs that are associated with the specified `head_sha`. @@ -56151,7 +56737,7 @@ paths: type: integer workflow_runs: type: array - items: &397 + items: &399 title: Workflow Run description: An invocation of a workflow type: object @@ -56268,7 +56854,7 @@ paths: type: - array - 'null' - items: &440 + items: &442 title: Pull Request Minimal type: object properties: @@ -56395,7 +56981,7 @@ paths: head_commit: anyOf: - type: 'null' - - &444 + - &446 title: Simple Commit description: A commit. type: object @@ -56469,8 +57055,8 @@ paths: - timestamp - author - committer - repository: *193 - head_repository: *193 + repository: *195 + head_repository: *195 head_repository_id: type: integer examples: @@ -56510,7 +57096,7 @@ paths: - workflow_url - pull_requests examples: - default: &420 + default: &422 value: total_count: 1 workflow_runs: @@ -56746,24 +57332,24 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#get-a-workflow-run parameters: - - *368 - - *369 - - &398 + - *370 + - *371 + - &400 name: run_id description: The unique identifier of the workflow run. in: path required: true schema: type: integer - - *396 + - *398 responses: '200': description: Response content: application/json: - schema: *397 + schema: *399 examples: - default: &401 + default: &403 value: id: 30433642 name: Build @@ -57004,9 +57590,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#delete-a-workflow-run parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 responses: '204': description: Response @@ -57029,9 +57615,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#get-the-review-history-for-a-workflow-run parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 responses: '200': description: Response @@ -57159,15 +57745,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#approve-a-workflow-run-for-a-fork-pull-request parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 responses: '201': description: Response content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -57194,12 +57780,12 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/artifacts#list-workflow-run-artifacts parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 - *17 - *19 - - *399 + - *401 responses: '200': description: Response @@ -57215,9 +57801,9 @@ paths: type: integer artifacts: type: array - items: *385 + items: *387 examples: - default: *400 + default: *402 headers: Link: *38 x-github: @@ -57241,25 +57827,25 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#get-a-workflow-run-attempt parameters: - - *368 - - *369 - - *398 - - &402 + - *370 + - *371 + - *400 + - &404 name: attempt_number description: The attempt number of the workflow run. in: path required: true schema: type: integer - - *396 + - *398 responses: '200': description: Response content: application/json: - schema: *397 + schema: *399 examples: - default: *401 + default: *403 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -57282,10 +57868,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-jobs#list-jobs-for-a-workflow-run-attempt parameters: - - *368 - - *369 - - *398 - - *402 + - *370 + - *371 + - *400 + - *404 - *17 - *19 responses: @@ -57303,9 +57889,9 @@ paths: type: integer jobs: type: array - items: *403 + items: *405 examples: - default: &404 + default: &406 value: total_count: 1 jobs: @@ -57418,10 +58004,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#download-workflow-run-attempt-logs parameters: - - *368 - - *369 - - *398 - - *402 + - *370 + - *371 + - *400 + - *404 responses: '302': description: Response @@ -57449,19 +58035,19 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#cancel-a-workflow-run parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 responses: '202': description: Response content: application/json: - schema: *204 + schema: *206 examples: default: value: - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -57484,9 +58070,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#review-custom-deployment-protection-rules-for-a-workflow-run parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 requestBody: required: true content: @@ -57553,19 +58139,19 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#force-cancel-a-workflow-run parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 responses: '202': description: Response content: application/json: - schema: *204 + schema: *206 examples: default: value: - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -57588,9 +58174,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-jobs#list-jobs-for-a-workflow-run parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 - name: filter description: Filters jobs by their `completed_at` timestamp. `latest` returns jobs from the most recent execution of the workflow run. `all` returns all @@ -57620,9 +58206,9 @@ paths: type: integer jobs: type: array - items: *403 + items: *405 examples: - default: *404 + default: *406 headers: Link: *38 x-github: @@ -57647,9 +58233,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#download-workflow-run-logs parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 responses: '302': description: Response @@ -57676,14 +58262,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#delete-workflow-run-logs parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 responses: '204': description: Response '403': *27 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -57705,9 +58291,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#get-pending-deployments-for-a-workflow-run parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 responses: '200': description: Response @@ -57776,7 +58362,7 @@ paths: items: type: object properties: - type: &524 + type: &526 type: string description: The type of reviewer. enum: @@ -57787,7 +58373,7 @@ paths: reviewer: anyOf: - *4 - - *224 + - *226 required: - environment - wait_timer @@ -57862,9 +58448,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#review-pending-deployments-for-a-workflow-run parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 requestBody: required: true content: @@ -57914,7 +58500,7 @@ paths: application/json: schema: type: array - items: &510 + items: &512 title: Deployment description: A request for a specific ref(branch,sha,tag) to be deployed @@ -58026,7 +58612,7 @@ paths: - created_at - updated_at examples: - default: &511 + default: &513 value: - url: https://api.github.com/repos/octocat/example/deployments/1 id: 1 @@ -58082,9 +58668,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#re-run-a-workflow parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 requestBody: required: false content: @@ -58106,7 +58692,7 @@ paths: description: Response content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -58129,9 +58715,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#re-run-failed-jobs-from-a-workflow-run parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 requestBody: required: false content: @@ -58153,7 +58739,7 @@ paths: description: Response content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -58186,9 +58772,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#get-workflow-run-usage parameters: - - *368 - - *369 - - *398 + - *370 + - *371 + - *400 responses: '200': description: Response @@ -58325,8 +58911,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#list-repository-secrets parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -58344,9 +58930,9 @@ paths: type: integer secrets: type: array - items: *405 + items: *407 examples: - default: *406 + default: *408 headers: Link: *38 x-github: @@ -58371,16 +58957,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#get-a-repository-public-key parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response content: application/json: - schema: *407 + schema: *409 examples: - default: *408 + default: *410 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -58402,17 +58988,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#get-a-repository-secret parameters: - - *368 - - *369 - - *203 + - *370 + - *371 + - *205 responses: '200': description: Response content: application/json: - schema: *405 + schema: *407 examples: - default: &537 + default: &539 value: name: GH_TOKEN created_at: '2019-08-10T14:59:22Z' @@ -58438,9 +59024,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#create-or-update-a-repository-secret parameters: - - *368 - - *369 - - *203 + - *370 + - *371 + - *205 requestBody: required: true content: @@ -58471,7 +59057,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -58497,9 +59083,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#delete-a-repository-secret parameters: - - *368 - - *369 - - *203 + - *370 + - *371 + - *205 responses: '204': description: Response @@ -58524,9 +59110,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#list-repository-variables parameters: - - *368 - - *369 - - *392 + - *370 + - *371 + - *394 - *19 responses: '200': @@ -58543,9 +59129,9 @@ paths: type: integer variables: type: array - items: *409 + items: *411 examples: - default: *410 + default: *412 headers: Link: *38 x-github: @@ -58568,8 +59154,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#create-a-repository-variable parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -58596,7 +59182,7 @@ paths: description: Response content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -58621,17 +59207,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#get-a-repository-variable parameters: - - *368 - - *369 - - *206 + - *370 + - *371 + - *208 responses: '200': description: Response content: application/json: - schema: *409 + schema: *411 examples: - default: &538 + default: &540 value: name: USERNAME value: octocat @@ -58657,9 +59243,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#update-a-repository-variable parameters: - - *368 - - *369 - - *206 + - *370 + - *371 + - *208 requestBody: required: true content: @@ -58701,9 +59287,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#delete-a-repository-variable parameters: - - *368 - - *369 - - *206 + - *370 + - *371 + - *208 responses: '204': description: Response @@ -58728,8 +59314,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflows#list-repository-workflows parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -58747,7 +59333,7 @@ paths: type: integer workflows: type: array - items: &411 + items: &413 title: Workflow description: A GitHub Actions workflow type: object @@ -58865,9 +59451,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflows#get-a-workflow parameters: - - *368 - - *369 - - &412 + - *370 + - *371 + - &414 name: workflow_id in: path description: The ID of the workflow. You can also pass the workflow file name @@ -58882,7 +59468,7 @@ paths: description: Response content: application/json: - schema: *411 + schema: *413 examples: default: value: @@ -58915,9 +59501,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflows#disable-a-workflow parameters: - - *368 - - *369 - - *412 + - *370 + - *371 + - *414 responses: '204': description: Response @@ -58942,9 +59528,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflows#create-a-workflow-dispatch-event parameters: - - *368 - - *369 - - *412 + - *370 + - *371 + - *414 responses: '204': description: Response @@ -58995,9 +59581,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflows#enable-a-workflow parameters: - - *368 - - *369 - - *412 + - *370 + - *371 + - *414 responses: '204': description: Response @@ -59024,19 +59610,19 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#list-workflow-runs-for-a-workflow parameters: - - *368 - - *369 - - *412 - - *413 + - *370 + - *371 - *414 - *415 - *416 - - *17 - - *19 - *417 - - *396 - *418 + - *17 + - *19 - *419 + - *398 + - *420 + - *421 responses: '200': description: Response @@ -59052,9 +59638,9 @@ paths: type: integer workflow_runs: type: array - items: *397 + items: *399 examples: - default: *420 + default: *422 headers: Link: *38 x-github: @@ -59087,9 +59673,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflows#get-workflow-usage parameters: - - *368 - - *369 - - *412 + - *370 + - *371 + - *414 responses: '200': description: Response @@ -59150,12 +59736,12 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#list-repository-activities parameters: - - *368 - - *369 - - *86 + - *370 + - *371 + - *89 - *17 - - *84 - - *85 + - *87 + - *88 - name: ref description: |- The Git reference for the activities you want to list. @@ -59319,8 +59905,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/assignees#list-assignees parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -59332,7 +59918,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: *38 '404': *6 @@ -59357,8 +59943,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/assignees#check-if-a-user-can-be-assigned parameters: - - *368 - - *369 + - *370 + - *371 - name: assignee in: path required: true @@ -59394,8 +59980,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#create-an-attestation parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -59507,11 +60093,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#list-attestations parameters: - - *368 - - *369 + - *370 + - *371 - *17 - - *84 - - *85 + - *87 + - *88 - name: subject_digest description: The parameter should be set to the attestation's subject's SHA256 digest, in the form `sha256:HEX_DIGEST`. @@ -59562,7 +60148,7 @@ paths: bundle_url: type: string examples: - default: *421 + default: *423 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -59582,8 +60168,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/autolinks#get-all-autolinks-of-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -59591,7 +60177,7 @@ paths: application/json: schema: type: array - items: &422 + items: &424 title: Autolink reference description: An autolink reference. type: object @@ -59645,8 +60231,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/autolinks#create-an-autolink-reference-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -59685,9 +60271,9 @@ paths: description: response content: application/json: - schema: *422 + schema: *424 examples: - default: &423 + default: &425 value: id: 1 key_prefix: TICKET- @@ -59718,9 +60304,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/autolinks#get-an-autolink-reference-of-a-repository parameters: - - *368 - - *369 - - &424 + - *370 + - *371 + - &426 name: autolink_id description: The unique identifier of the autolink. in: path @@ -59732,9 +60318,9 @@ paths: description: Response content: application/json: - schema: *422 + schema: *424 examples: - default: *423 + default: *425 '404': *6 x-github: githubCloudOnly: false @@ -59754,9 +60340,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/autolinks#delete-an-autolink-reference-from-a-repository parameters: - - *368 - - *369 - - *424 + - *370 + - *371 + - *426 responses: '204': description: Response @@ -59780,8 +60366,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#check-if-dependabot-security-updates-are-enabled-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response if Dependabot is enabled @@ -59831,8 +60417,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#enable-dependabot-security-updates parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response @@ -59853,8 +60439,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#disable-dependabot-security-updates parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response @@ -59874,8 +60460,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branches#list-branches parameters: - - *368 - - *369 + - *370 + - *371 - name: protected description: Setting to `true` returns only branches protected by branch protections or rulesets. When set to `false`, only unprotected branches are returned. @@ -59913,7 +60499,7 @@ paths: - url protected: type: boolean - protection: &426 + protection: &428 title: Branch Protection description: Branch Protection type: object @@ -59956,7 +60542,7 @@ paths: required: - contexts - checks - enforce_admins: &429 + enforce_admins: &431 title: Protected Branch Admin Enforced description: Protected Branch Admin Enforced type: object @@ -59973,7 +60559,7 @@ paths: required: - url - enabled - required_pull_request_reviews: &431 + required_pull_request_reviews: &433 title: Protected Branch Pull Request Review description: Protected Branch Pull Request Review type: object @@ -59995,7 +60581,7 @@ paths: description: The list of teams with review dismissal access. type: array - items: *224 + items: *226 apps: description: The list of apps with review dismissal access. @@ -60027,7 +60613,7 @@ paths: description: The list of teams allowed to bypass pull request requirements. type: array - items: *224 + items: *226 apps: description: The list of apps allowed to bypass pull request requirements. @@ -60057,7 +60643,7 @@ paths: required: - dismiss_stale_reviews - require_code_owner_reviews - restrictions: &428 + restrictions: &430 title: Branch Restriction Policy description: Branch Restriction Policy type: object @@ -60382,9 +60968,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branches#get-a-branch parameters: - - *368 - - *369 - - &427 + - *370 + - *371 + - &429 name: branch description: The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use [the GraphQL API](https://docs.github.com/enterprise-cloud@latest//graphql). @@ -60398,14 +60984,14 @@ paths: description: Response content: application/json: - schema: &437 + schema: &439 title: Branch With Protection description: Branch With Protection type: object properties: name: type: string - commit: &486 + commit: &488 title: Commit description: Commit type: object @@ -60444,7 +61030,7 @@ paths: author: anyOf: - type: 'null' - - &425 + - &427 title: Git User description: Metaproperties for Git author/committer information. @@ -60465,7 +61051,7 @@ paths: committer: anyOf: - type: 'null' - - *425 + - *427 message: type: string examples: @@ -60489,7 +61075,7 @@ paths: required: - sha - url - verification: &544 + verification: &546 title: Verification type: object properties: @@ -60525,14 +61111,14 @@ paths: author: oneOf: - *4 - - *204 + - *206 type: - 'null' - object committer: oneOf: - *4 - - *204 + - *206 type: - 'null' - object @@ -60569,7 +61155,7 @@ paths: type: integer files: type: array - items: &498 + items: &500 title: Diff Entry description: Diff Entry type: object @@ -60663,7 +61249,7 @@ paths: - self protected: type: boolean - protection: *426 + protection: *428 protection_url: type: string format: uri @@ -60772,7 +61358,7 @@ paths: contexts: [] checks: [] protection_url: https://api.github.com/repos/octocat/Hello-World/branches/main/protection - '301': *382 + '301': *384 '404': *6 x-github: githubCloudOnly: false @@ -60794,15 +61380,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-branch-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '200': description: Response content: application/json: - schema: *426 + schema: *428 examples: default: value: @@ -60996,9 +61582,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#update-branch-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: true content: @@ -61258,7 +61844,7 @@ paths: url: type: string format: uri - required_status_checks: &434 + required_status_checks: &436 title: Status Check Policy description: Status Check Policy type: object @@ -61339,7 +61925,7 @@ paths: items: *4 teams: type: array - items: *224 + items: *226 apps: type: array items: *5 @@ -61357,7 +61943,7 @@ paths: items: *4 teams: type: array - items: *224 + items: *226 apps: type: array items: *5 @@ -61417,7 +62003,7 @@ paths: additionalProperties: false required: - enabled - restrictions: *428 + restrictions: *430 required_conversation_resolution: type: object properties: @@ -61529,9 +62115,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#delete-branch-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '204': description: Response @@ -61556,17 +62142,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-admin-branch-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '200': description: Response content: application/json: - schema: *429 + schema: *431 examples: - default: &430 + default: &432 value: url: https://api.github.com/repos/octocat/Hello-World/branches/master/protection/enforce_admins enabled: true @@ -61588,17 +62174,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#set-admin-branch-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '200': description: Response content: application/json: - schema: *429 + schema: *431 examples: - default: *430 + default: *432 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -61617,9 +62203,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#delete-admin-branch-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '204': description: Response @@ -61644,17 +62230,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-pull-request-review-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '200': description: Response content: application/json: - schema: *431 + schema: *433 examples: - default: &432 + default: &434 value: url: https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_pull_request_reviews dismissal_restrictions: @@ -61750,9 +62336,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#update-pull-request-review-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: false content: @@ -61850,9 +62436,9 @@ paths: description: Response content: application/json: - schema: *431 + schema: *433 examples: - default: *432 + default: *434 '422': *15 x-github: githubCloudOnly: false @@ -61873,9 +62459,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#delete-pull-request-review-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '204': description: Response @@ -61902,17 +62488,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-commit-signature-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '200': description: Response content: application/json: - schema: *429 + schema: *431 examples: - default: &433 + default: &435 value: url: https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_signatures enabled: true @@ -61935,17 +62521,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#create-commit-signature-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '200': description: Response content: application/json: - schema: *429 + schema: *431 examples: - default: *433 + default: *435 '404': *6 x-github: githubCloudOnly: false @@ -61965,9 +62551,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#delete-commit-signature-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '204': description: Response @@ -61992,17 +62578,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-status-checks-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '200': description: Response content: application/json: - schema: *434 + schema: *436 examples: - default: &435 + default: &437 value: url: https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_status_checks strict: true @@ -62028,9 +62614,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#update-status-check-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: false content: @@ -62082,9 +62668,9 @@ paths: description: Response content: application/json: - schema: *434 + schema: *436 examples: - default: *435 + default: *437 '404': *6 '422': *15 x-github: @@ -62106,9 +62692,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#remove-status-check-protection parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '204': description: Response @@ -62132,9 +62718,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-all-status-check-contexts parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '200': description: Response @@ -62168,9 +62754,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#add-status-check-contexts parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: false content: @@ -62237,9 +62823,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#set-status-check-contexts parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: false content: @@ -62303,9 +62889,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#remove-status-check-contexts parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: content: application/json: @@ -62371,15 +62957,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-access-restrictions parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '200': description: Response content: application/json: - schema: *428 + schema: *430 examples: default: value: @@ -62470,9 +63056,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#delete-access-restrictions parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '204': description: Response @@ -62495,9 +63081,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-apps-with-access-to-the-protected-branch parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '200': description: Response @@ -62507,7 +63093,7 @@ paths: type: array items: *5 examples: - default: &436 + default: &438 value: - id: 1 slug: octoapp @@ -62564,9 +63150,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#add-app-access-restrictions parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: true content: @@ -62600,7 +63186,7 @@ paths: type: array items: *5 examples: - default: *436 + default: *438 '422': *15 x-github: githubCloudOnly: false @@ -62621,9 +63207,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#set-app-access-restrictions parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: true content: @@ -62657,7 +63243,7 @@ paths: type: array items: *5 examples: - default: *436 + default: *438 '422': *15 x-github: githubCloudOnly: false @@ -62678,9 +63264,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#remove-app-access-restrictions parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: true content: @@ -62714,7 +63300,7 @@ paths: type: array items: *5 examples: - default: *436 + default: *438 '422': *15 x-github: githubCloudOnly: false @@ -62736,9 +63322,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-teams-with-access-to-the-protected-branch parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '200': description: Response @@ -62746,9 +63332,9 @@ paths: application/json: schema: type: array - items: *224 + items: *226 examples: - default: *298 + default: *300 '404': *6 x-github: githubCloudOnly: false @@ -62768,9 +63354,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#add-team-access-restrictions parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: false content: @@ -62806,9 +63392,9 @@ paths: application/json: schema: type: array - items: *224 + items: *226 examples: - default: *298 + default: *300 '422': *15 x-github: githubCloudOnly: false @@ -62829,9 +63415,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#set-team-access-restrictions parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: false content: @@ -62867,9 +63453,9 @@ paths: application/json: schema: type: array - items: *224 + items: *226 examples: - default: *298 + default: *300 '422': *15 x-github: githubCloudOnly: false @@ -62890,9 +63476,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#remove-team-access-restrictions parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: content: application/json: @@ -62927,9 +63513,9 @@ paths: application/json: schema: type: array - items: *224 + items: *226 examples: - default: *298 + default: *300 '422': *15 x-github: githubCloudOnly: false @@ -62951,9 +63537,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-users-with-access-to-the-protected-branch parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 responses: '200': description: Response @@ -62963,7 +63549,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 '404': *6 x-github: githubCloudOnly: false @@ -62987,9 +63573,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#add-user-access-restrictions parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: true content: @@ -63022,7 +63608,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 '422': *15 x-github: githubCloudOnly: false @@ -63047,9 +63633,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#set-user-access-restrictions parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: true content: @@ -63082,7 +63668,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 '422': *15 x-github: githubCloudOnly: false @@ -63107,9 +63693,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#remove-user-access-restrictions parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: true content: @@ -63142,7 +63728,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 '422': *15 x-github: githubCloudOnly: false @@ -63169,9 +63755,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branches#rename-a-branch parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 requestBody: required: true content: @@ -63193,7 +63779,7 @@ paths: description: Response content: application/json: - schema: *437 + schema: *439 examples: default: value: @@ -63307,12 +63893,12 @@ paths: category: repos subcategory: bypass-requests parameters: - - *368 - - *369 - - *216 - - *217 + - *370 + - *371 - *218 - *219 + - *220 + - *221 - *17 - *19 responses: @@ -63322,11 +63908,11 @@ paths: application/json: schema: type: array - items: *220 + items: *222 examples: - default: *221 + default: *223 '404': *6 - '500': *83 + '500': *86 "/repos/{owner}/{repo}/bypass-requests/push-rules/{bypass_request_number}": get: summary: Get a repository push bypass request @@ -63344,8 +63930,8 @@ paths: category: repos subcategory: bypass-requests parameters: - - *368 - - *369 + - *370 + - *371 - name: bypass_request_number in: path required: true @@ -63359,7 +63945,7 @@ paths: description: Response content: application/json: - schema: *220 + schema: *222 examples: default: value: @@ -63397,7 +63983,7 @@ paths: url: https://api.github.com/repos/octo-org/smile/bypass-requests/push-rules/2 html_url: https://github.com/octo-org/smile/exemptions/2 '404': *6 - '500': *83 + '500': *86 "/repos/{owner}/{repo}/bypass-requests/secret-scanning": get: summary: List bypass requests for secret scanning for a repository @@ -63418,12 +64004,12 @@ paths: category: secret-scanning subcategory: delegated-bypass parameters: - - *368 - - *369 - - *216 - - *217 + - *370 + - *371 - *218 - *219 + - *220 + - *221 - *17 - *19 responses: @@ -63433,12 +64019,12 @@ paths: application/json: schema: type: array - items: *438 + items: *440 examples: - default: *439 + default: *441 '404': *6 '403': *27 - '500': *83 + '500': *86 "/repos/{owner}/{repo}/bypass-requests/secret-scanning/{bypass_request_number}": get: summary: Get a bypass request for secret scanning @@ -63459,8 +64045,8 @@ paths: category: secret-scanning subcategory: delegated-bypass parameters: - - *368 - - *369 + - *370 + - *371 - name: bypass_request_number in: path required: true @@ -63472,7 +64058,7 @@ paths: description: A single bypass request. content: application/json: - schema: *438 + schema: *440 examples: default: value: @@ -63510,7 +64096,7 @@ paths: html_url: https://github.com/octo-org/smile/exemptions/1 '404': *6 '403': *27 - '500': *83 + '500': *86 patch: summary: Review a bypass request for secret scanning description: |- @@ -63530,8 +64116,8 @@ paths: category: secret-scanning subcategory: delegated-bypass parameters: - - *368 - - *369 + - *370 + - *371 - name: bypass_request_number in: path required: true @@ -63581,7 +64167,7 @@ paths: '404': *6 '403': *27 '422': *15 - '500': *83 + '500': *86 "/repos/{owner}/{repo}/bypass-responses/secret-scanning/{bypass_response_id}": delete: summary: Dismiss a response on a bypass request for secret scanning @@ -63602,8 +64188,8 @@ paths: category: secret-scanning subcategory: delegated-bypass parameters: - - *368 - - *369 + - *370 + - *371 - name: bypass_response_id in: path required: true @@ -63616,7 +64202,7 @@ paths: '404': *6 '403': *27 '422': *15 - '500': *83 + '500': *86 "/repos/{owner}/{repo}/check-runs": post: summary: Create a check run @@ -63636,8 +64222,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/runs#create-a-check-run parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -63916,7 +64502,7 @@ paths: description: Response content: application/json: - schema: &441 + schema: &443 title: CheckRun description: A check performed on the code of a given code change type: object @@ -64051,8 +64637,8 @@ paths: do not necessarily indicate pull requests that triggered the check. type: array - items: *440 - deployment: &775 + items: *442 + deployment: &777 title: Deployment description: A deployment created as the result of an Actions check run from a workflow that references an environment @@ -64339,9 +64925,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/runs#get-a-check-run parameters: - - *368 - - *369 - - &442 + - *370 + - *371 + - &444 name: check_run_id description: The unique identifier of the check run. in: path @@ -64353,9 +64939,9 @@ paths: description: Response content: application/json: - schema: *441 + schema: *443 examples: - default: &443 + default: &445 value: id: 4 head_sha: ce587453ced02b1526dfb4cb910479d431683101 @@ -64455,9 +65041,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/runs#update-a-check-run parameters: - - *368 - - *369 - - *442 + - *370 + - *371 + - *444 requestBody: required: true content: @@ -64697,9 +65283,9 @@ paths: description: Response content: application/json: - schema: *441 + schema: *443 examples: - default: *443 + default: *445 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -64719,9 +65305,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/runs#list-check-run-annotations parameters: - - *368 - - *369 - - *442 + - *370 + - *371 + - *444 - *17 - *19 responses: @@ -64831,15 +65417,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/runs#rerequest-a-check-run parameters: - - *368 - - *369 - - *442 + - *370 + - *371 + - *444 responses: '201': description: Response content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -64877,8 +65463,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/suites#create-a-check-suite parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -64900,7 +65486,7 @@ paths: description: Response when the suite already exists content: application/json: - schema: &445 + schema: &447 title: CheckSuite description: A suite of checks performed on the code of a given code change @@ -64982,12 +65568,12 @@ paths: type: - array - 'null' - items: *440 + items: *442 app: anyOf: - type: 'null' - *5 - repository: *193 + repository: *195 created_at: type: - string @@ -64998,7 +65584,7 @@ paths: - string - 'null' format: date-time - head_commit: *444 + head_commit: *446 latest_check_runs_count: type: integer check_runs_url: @@ -65026,7 +65612,7 @@ paths: - check_runs_url - pull_requests examples: - default: &446 + default: &448 value: id: 5 node_id: MDEwOkNoZWNrU3VpdGU1 @@ -65317,9 +65903,9 @@ paths: description: Response when the suite was created content: application/json: - schema: *445 + schema: *447 examples: - default: *446 + default: *448 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -65338,8 +65924,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/suites#update-repository-preferences-for-check-suites parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -65400,7 +65986,7 @@ paths: required: - app_id - setting - repository: *193 + repository: *195 examples: default: value: @@ -65648,9 +66234,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/suites#get-a-check-suite parameters: - - *368 - - *369 - - &447 + - *370 + - *371 + - &449 name: check_suite_id description: The unique identifier of the check suite. in: path @@ -65662,9 +66248,9 @@ paths: description: Response content: application/json: - schema: *445 + schema: *447 examples: - default: *446 + default: *448 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -65687,17 +66273,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/runs#list-check-runs-in-a-check-suite parameters: - - *368 - - *369 - - *447 - - &493 + - *370 + - *371 + - *449 + - &495 name: check_name description: Returns check runs with the specified `name`. in: query required: false schema: type: string - - &494 + - &496 name: status description: Returns check runs with the specified `status`. in: query @@ -65736,9 +66322,9 @@ paths: type: integer check_runs: type: array - items: *441 + items: *443 examples: - default: &495 + default: &497 value: total_count: 1 check_runs: @@ -65840,15 +66426,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/suites#rerequest-a-check-suite parameters: - - *368 - - *369 - - *447 + - *370 + - *371 + - *449 responses: '201': description: Response content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -65875,30 +66461,30 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#list-code-scanning-alerts-for-a-repository parameters: - - *368 - - *369 - - *228 - - *229 + - *370 + - *371 + - *230 + - *231 - *19 - *17 - - &463 + - &465 name: ref description: The Git reference for the results you want to list. The `ref` for a branch can be formatted either as `refs/heads/` or simply ``. To reference a pull request use `refs/pull//merge`. in: query required: false - schema: *448 - - &464 + schema: *450 + - &466 name: pr description: The number of the pull request for the results you want to list. in: query required: false schema: type: integer - - *86 - - *84 - - *85 + - *89 + - *87 + - *88 - name: sort description: The property by which to sort the results. in: query @@ -65914,13 +66500,13 @@ paths: be returned. in: query required: false - schema: *230 + schema: *232 - name: severity description: If specified, only code scanning alerts with this severity will be returned. in: query required: false - schema: *449 + schema: *451 responses: '200': description: Response @@ -65931,24 +66517,24 @@ paths: items: type: object properties: - number: *96 - created_at: *103 - updated_at: *104 - url: *101 - html_url: *102 - instances_url: *450 - state: *89 - fixed_at: *106 + number: *99 + created_at: *106 + updated_at: *107 + url: *104 + html_url: *105 + instances_url: *452 + state: *92 + fixed_at: *109 dismissed_by: anyOf: - type: 'null' - *4 - dismissed_at: *105 - dismissed_reason: *451 - dismissed_comment: *452 - rule: *453 - tool: *454 - most_recent_instance: *455 + dismissed_at: *108 + dismissed_reason: *453 + dismissed_comment: *454 + rule: *455 + tool: *456 + most_recent_instance: *457 dismissal_approved_by: anyOf: - type: 'null' @@ -66068,14 +66654,14 @@ paths: classifications: [] instances_url: https://api.github.com/repos/octocat/hello-world/code-scanning/alerts/3/instances '304': *35 - '403': &456 + '403': &458 description: Response if GitHub Advanced Security is not enabled for this repository content: application/json: schema: *3 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -66095,9 +66681,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#get-a-code-scanning-alert parameters: - - *368 - - *369 - - &457 + - *370 + - *371 + - &459 name: alert_number in: path description: The number that identifies an alert. You can find this at the @@ -66105,30 +66691,30 @@ paths: field in the response from the `GET /repos/{owner}/{repo}/code-scanning/alerts` operation. required: true - schema: *96 + schema: *99 responses: '200': description: Response content: application/json: - schema: &458 + schema: &460 type: object properties: - number: *96 - created_at: *103 - updated_at: *104 - url: *101 - html_url: *102 - instances_url: *450 - state: *89 - fixed_at: *106 + number: *99 + created_at: *106 + updated_at: *107 + url: *104 + html_url: *105 + instances_url: *452 + state: *92 + fixed_at: *109 dismissed_by: anyOf: - type: 'null' - *4 - dismissed_at: *105 - dismissed_reason: *451 - dismissed_comment: *452 + dismissed_at: *108 + dismissed_reason: *453 + dismissed_comment: *454 rule: type: object properties: @@ -66190,8 +66776,8 @@ paths: - 'null' description: A link to the documentation for the rule used to detect the alert. - tool: *454 - most_recent_instance: *455 + tool: *456 + most_recent_instance: *457 dismissal_approved_by: anyOf: - type: 'null' @@ -66284,9 +66870,9 @@ paths: - test instances_url: https://api.github.com/repos/octocat/hello-world/code-scanning/alerts/42/instances '304': *35 - '403': *456 + '403': *458 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -66304,9 +66890,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#update-a-code-scanning-alert parameters: - - *368 - - *369 - - *457 + - *370 + - *371 + - *459 requestBody: required: true content: @@ -66321,8 +66907,8 @@ paths: enum: - open - dismissed - dismissed_reason: *451 - dismissed_comment: *452 + dismissed_reason: *453 + dismissed_comment: *454 create_request: type: boolean description: If `true`, attempt to create an alert dismissal request. @@ -66341,7 +66927,7 @@ paths: description: Response content: application/json: - schema: *458 + schema: *460 examples: default: value: @@ -66417,14 +67003,14 @@ paths: - test instances_url: https://api.github.com/repos/octocat/hello-world/code-scanning/alerts/42/instances '400': *14 - '403': &462 + '403': &464 description: Response if the repository is archived or if GitHub Advanced Security is not enabled for this repository content: application/json: schema: *3 '404': *6 - '503': *130 + '503': *133 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -66444,15 +67030,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#get-the-status-of-an-autofix-for-a-code-scanning-alert parameters: - - *368 - - *369 - - *457 + - *370 + - *371 + - *459 responses: '200': description: Response content: application/json: - schema: &459 + schema: &461 type: object properties: status: @@ -66479,13 +67065,13 @@ paths: - description - started_at examples: - default: &460 + default: &462 value: status: success description: This fixes an XSS vulnerability by escaping the user input. started_at: '2024-02-14T12:29:18Z' - '400': &461 + '400': &463 description: Bad Request content: application/json: @@ -66496,9 +67082,9 @@ paths: message: The alert_number is not valid documentation_url: https://docs.github.com/rest/code-scanning/code-scanning#get-the-status-of-an-autofix-for-a-code-scanning-alert status: '400' - '403': *456 + '403': *458 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -66521,29 +67107,29 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#create-an-autofix-for-a-code-scanning-alert parameters: - - *368 - - *369 - - *457 + - *370 + - *371 + - *459 responses: '200': description: OK content: application/json: - schema: *459 + schema: *461 examples: - default: *460 + default: *462 '202': description: Accepted content: application/json: - schema: *459 + schema: *461 examples: default: value: status: pending description: started_at: '2024-02-14T12:29:18Z' - '400': *461 + '400': *463 '403': description: Response if the repository is archived, if GitHub Advanced Security is not enabled for this repository or if rate limit is exceeded @@ -66553,7 +67139,7 @@ paths: '404': *6 '422': description: Unprocessable Entity - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -66575,9 +67161,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#commit-an-autofix-for-a-code-scanning-alert parameters: - - *368 - - *369 - - *457 + - *370 + - *371 + - *459 requestBody: required: false content: @@ -66623,12 +67209,12 @@ paths: value: target_ref: refs/heads/main sha: 178f4f6090b3fccad4a65b3e83d076a622d59652 - '400': *461 - '403': *462 + '400': *463 + '403': *464 '404': *6 '422': description: Unprocessable Entity - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -66648,13 +67234,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#list-instances-of-a-code-scanning-alert parameters: - - *368 - - *369 - - *457 + - *370 + - *371 + - *459 - *19 - *17 - - *463 - - *464 + - *465 + - *466 responses: '200': description: Response @@ -66662,7 +67248,7 @@ paths: application/json: schema: type: array - items: *455 + items: *457 examples: default: value: @@ -66701,9 +67287,9 @@ paths: end_column: 50 classifications: - source - '403': *456 + '403': *458 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -66735,30 +67321,30 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#list-code-scanning-analyses-for-a-repository parameters: - - *368 - - *369 - - *228 - - *229 + - *370 + - *371 + - *230 + - *231 - *19 - *17 - - *464 + - *466 - name: ref in: query description: The Git reference for the analyses you want to list. The `ref` for a branch can be formatted either as `refs/heads/` or simply ``. To reference a pull request use `refs/pull//merge`. required: false - schema: *448 + schema: *450 - name: sarif_id in: query description: Filter analyses belonging to the same SARIF upload. required: false - schema: &467 + schema: &469 type: string description: An identifier for the upload. examples: - 6c81cd8e-b078-4ac3-a3be-1dad7dbd0b53 - - *86 + - *89 - name: sort description: The property by which to sort the results. in: query @@ -66775,23 +67361,23 @@ paths: application/json: schema: type: array - items: &468 + items: &470 type: object properties: - ref: *448 - commit_sha: &476 + ref: *450 + commit_sha: &478 description: The SHA of the commit to which the analysis you are uploading relates. type: string minLength: 40 maxLength: 40 pattern: "^[0-9a-fA-F]+$" - analysis_key: *465 + analysis_key: *467 environment: type: string description: Identifies the variable values associated with the environment in which this analysis was performed. - category: *466 + category: *468 error: type: string examples: @@ -66816,8 +67402,8 @@ paths: description: The REST API URL of the analysis resource. format: uri readOnly: true - sarif_id: *467 - tool: *454 + sarif_id: *469 + tool: *456 deletable: type: boolean warning: @@ -66879,9 +67465,9 @@ paths: version: 1.2.0 deletable: true warning: '' - '403': *456 + '403': *458 '404': *6 - '503': *130 + '503': *133 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -66915,8 +67501,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#get-a-code-scanning-analysis-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - name: analysis_id in: path description: The ID of the analysis, as returned from the `GET /repos/{owner}/{repo}/code-scanning/analyses` @@ -66929,7 +67515,7 @@ paths: description: Response content: application/json: - schema: *468 + schema: *470 examples: response: summary: application/json response @@ -66983,14 +67569,14 @@ paths: properties: - github/alertNumber: 2 - github/alertUrl: https://api.github.com/repos/monalisa/monalisa/code-scanning/alerts/2 - '403': *456 + '403': *458 '404': *6 '422': description: Response if analysis could not be processed content: application/json: schema: *3 - '503': *130 + '503': *133 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -67070,8 +67656,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#delete-a-code-scanning-analysis-from-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - name: analysis_id in: path description: The ID of the analysis, as returned from the `GET /repos/{owner}/{repo}/code-scanning/analyses` @@ -67127,9 +67713,9 @@ paths: next_analysis_url: https://api.github.com/repos/octocat/hello-world/code-scanning/analyses/41 confirm_delete_url: https://api.github.com/repos/octocat/hello-world/code-scanning/analyses/41?confirm_delete '400': *14 - '403': *462 + '403': *464 '404': *6 - '503': *130 + '503': *133 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -67149,8 +67735,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#list-codeql-databases-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -67158,7 +67744,7 @@ paths: application/json: schema: type: array - items: &469 + items: &471 title: CodeQL Database description: A CodeQL database. type: object @@ -67270,9 +67856,9 @@ paths: updated_at: '2022-09-12T12:14:32Z' url: https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/ruby commit_oid: 1927de39fefa25a9d0e64e3f540ff824a72f538c - '403': *456 + '403': *458 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -67299,8 +67885,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#get-a-codeql-database-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - name: language in: path description: The language of the CodeQL database. @@ -67312,7 +67898,7 @@ paths: description: Response content: application/json: - schema: *469 + schema: *471 examples: default: value: @@ -67344,11 +67930,11 @@ paths: updated_at: '2022-09-12T12:14:32Z' url: https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/java commit_oid: 1927de39fefa25a9d0e64e3f540ff824a72f538c - '302': &500 + '302': &502 description: Found - '403': *456 + '403': *458 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -67368,8 +67954,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#delete-a-codeql-database parameters: - - *368 - - *369 + - *370 + - *371 - name: language in: path description: The language of the CodeQL database. @@ -67379,9 +67965,9 @@ paths: responses: '204': description: Response - '403': *462 + '403': *464 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -67407,8 +67993,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#create-a-codeql-variant-analysis parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -67417,7 +68003,7 @@ paths: type: object additionalProperties: false properties: - language: &470 + language: &472 type: string description: The language targeted by the CodeQL query enum: @@ -67496,7 +68082,7 @@ paths: description: Variant analysis submitted for processing content: application/json: - schema: &474 + schema: &476 title: Variant Analysis description: A run of a CodeQL query against one or more repositories. type: object @@ -67504,9 +68090,9 @@ paths: id: type: integer description: The ID of the variant analysis. - controller_repo: *95 + controller_repo: *98 actor: *4 - query_language: *470 + query_language: *472 query_pack_url: type: string description: The download url for the query pack. @@ -67554,7 +68140,7 @@ paths: items: type: object properties: - repository: &471 + repository: &473 title: Repository Identifier description: Repository Identifier type: object @@ -67596,7 +68182,7 @@ paths: - private - stargazers_count - updated_at - analysis_status: &475 + analysis_status: &477 type: string description: The new status of the CodeQL variant analysis repository task. @@ -67628,7 +68214,7 @@ paths: from processing. This information is only available to the user that initiated the variant analysis. properties: - access_mismatch_repos: &472 + access_mismatch_repos: &474 type: object properties: repository_count: @@ -67643,7 +68229,7 @@ paths: This list may not include all repositories that were skipped. This is only available when the repository was found and the user has access to it. - items: *471 + items: *473 required: - repository_count - repositories @@ -67666,8 +68252,8 @@ paths: required: - repository_count - repository_full_names - no_codeql_db_repos: *472 - over_limit_repos: *472 + no_codeql_db_repos: *474 + over_limit_repos: *474 required: - access_mismatch_repos - not_found_repos @@ -67683,7 +68269,7 @@ paths: examples: repositories_parameter: summary: Response for a successful variant analysis submission - value: &473 + value: &475 summary: Default response value: id: 1 @@ -67835,17 +68421,17 @@ paths: private: false repository_owners: summary: Response for a successful variant analysis submission - value: *473 + value: *475 repository_lists: summary: Response for a successful variant analysis submission - value: *473 + value: *475 '404': *6 '422': description: Unable to process variant analysis submission content: application/json: schema: *3 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -67866,8 +68452,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#get-the-summary-of-a-codeql-variant-analysis parameters: - - *368 - - *369 + - *370 + - *371 - name: codeql_variant_analysis_id in: path description: The unique identifier of the variant analysis. @@ -67879,11 +68465,11 @@ paths: description: Response content: application/json: - schema: *474 + schema: *476 examples: - default: *473 + default: *475 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -67904,7 +68490,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#get-the-analysis-status-of-a-repository-in-a-codeql-variant-analysis parameters: - - *368 + - *370 - name: repo in: path description: The name of the controller repository. @@ -67938,8 +68524,8 @@ paths: schema: type: object properties: - repository: *95 - analysis_status: *475 + repository: *98 + analysis_status: *477 artifact_size_in_bytes: type: integer description: The size of the artifact. This is only available @@ -68043,7 +68629,7 @@ paths: source_location_prefix: "/" artifact_url: https://example.com '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -68064,8 +68650,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#get-a-code-scanning-default-setup-configuration parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -68158,9 +68744,9 @@ paths: threat_model: remote updated_at: '2023-01-19T11:21:34Z' schedule: weekly - '403': *456 + '403': *458 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -68179,8 +68765,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#update-a-code-scanning-default-setup-configuration parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -68249,7 +68835,7 @@ paths: description: Response content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -68274,7 +68860,7 @@ paths: value: run_id: 42 run_url: https://api.github.com/repos/octoorg/octocat/actions/runs/42 - '403': *462 + '403': *464 '404': *6 '409': description: Response if there is already a validation run in progress with @@ -68282,7 +68868,7 @@ paths: content: application/json: schema: *3 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -68339,8 +68925,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#upload-an-analysis-as-sarif-data parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -68348,7 +68934,7 @@ paths: schema: type: object properties: - commit_sha: *476 + commit_sha: *478 ref: type: string description: |- @@ -68408,7 +68994,7 @@ paths: schema: type: object properties: - id: *467 + id: *469 url: type: string description: The REST API URL for checking the status of the upload. @@ -68422,11 +69008,11 @@ paths: url: https://api.github.com/repos/octocat/hello-world/code-scanning/sarifs/47177e22-5596-11eb-80a1-c1e54ef945c6 '400': description: Bad Request if the sarif field is invalid - '403': *462 + '403': *464 '404': *6 '413': description: Payload Too Large if the sarif field is too large - '503': *130 + '503': *133 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -68445,8 +69031,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#get-information-about-a-sarif-upload parameters: - - *368 - - *369 + - *370 + - *371 - name: sarif_id description: The SARIF ID obtained after uploading. in: path @@ -68494,10 +69080,10 @@ paths: value: processing_status: complete analyses_url: https://api.github.com/repos/octocat/hello-world/code-scanning/analyses?sarif_id=47177e22-5596-11eb-80a1-c1e54ef945c6 - '403': *456 + '403': *458 '404': description: Not Found if the sarif id does not match any upload - '503': *130 + '503': *133 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -68519,8 +69105,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#get-the-code-security-configuration-associated-with-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -68544,7 +69130,7 @@ paths: - failed - updating - removed_by_enterprise - configuration: *90 + configuration: *93 examples: default: value: @@ -68576,7 +69162,7 @@ paths: html_url: https://github.com/organizations/octo-org/settings/security_products/configurations/edit/1325 created_at: '2024-05-01T00:00:00Z' updated_at: '2024-05-01T00:00:00Z' - '204': *116 + '204': *119 '304': *35 '403': *27 '404': *6 @@ -68601,8 +69187,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#list-codeowners-errors parameters: - - *368 - - *369 + - *370 + - *371 - name: ref description: 'A branch, tag or commit name used to determine which version of the CODEOWNERS file to use. Default: the repository''s default branch @@ -68730,8 +69316,8 @@ paths: parameters: - *17 - *19 - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -68747,7 +69333,7 @@ paths: type: integer codespaces: type: array - items: *288 + items: *290 examples: default: value: @@ -69023,7 +69609,7 @@ paths: start_url: https://api.github.com/user/codespaces/monalisa-octocat-hello-world-3f89ada1j3/start stop_url: https://api.github.com/user/codespaces/monalisa-octocat-hello-world-3f89ada1j3/stop recent_folders: [] - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -69045,8 +69631,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#create-a-codespace-in-a-repository parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -69110,22 +69696,22 @@ paths: description: Response when the codespace was successfully created content: application/json: - schema: *288 + schema: *290 examples: - default: *477 + default: *479 '202': description: Response when the codespace creation partially failed but is being retried in the background content: application/json: - schema: *288 + schema: *290 examples: - default: *477 + default: *479 '400': *14 '401': *23 '403': *27 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -69149,8 +69735,8 @@ paths: parameters: - *17 - *19 - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -69190,7 +69776,7 @@ paths: - path: ".devcontainer.json" display_name: Default project configuration total_count: 3 - '500': *83 + '500': *86 '400': *14 '401': *23 '403': *27 @@ -69214,8 +69800,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/machines#list-available-machine-types-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - name: location description: The location to check for available machines. Assigned by IP if not provided. @@ -69252,9 +69838,9 @@ paths: type: integer machines: type: array - items: *478 + items: *480 examples: - default: &729 + default: &731 value: total_count: 2 machines: @@ -69271,7 +69857,7 @@ paths: memory_in_bytes: 34359738368 cpus: 8 '304': *35 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -69294,8 +69880,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#get-default-attributes-for-a-codespace parameters: - - *368 - - *369 + - *370 + - *371 - name: ref description: The branch or commit to check for a default devcontainer path. If not specified, the default branch will be checked. @@ -69382,8 +69968,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#check-if-permissions-defined-by-a-devcontainer-have-been-accepted-by-the-authenticated-user parameters: - - *368 - - *369 + - *370 + - *371 - name: ref description: The git reference that points to the location of the devcontainer configuration to use for the permission check. The value of `ref` will typically @@ -69431,7 +70017,7 @@ paths: '403': *27 '404': *6 '422': *15 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -69452,8 +70038,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/repository-secrets#list-repository-secrets parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -69471,7 +70057,7 @@ paths: type: integer secrets: type: array - items: &482 + items: &484 title: Codespaces Secret description: Set repository secrets for GitHub Codespaces. type: object @@ -69492,7 +70078,7 @@ paths: - created_at - updated_at examples: - default: *479 + default: *481 headers: Link: *38 x-github: @@ -69515,16 +70101,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/repository-secrets#get-a-repository-public-key parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response content: application/json: - schema: *480 + schema: *482 examples: - default: *481 + default: *483 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -69544,17 +70130,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/repository-secrets#get-a-repository-secret parameters: - - *368 - - *369 - - *203 + - *370 + - *371 + - *205 responses: '200': description: Response content: application/json: - schema: *482 + schema: *484 examples: - default: *483 + default: *485 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -69574,9 +70160,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/repository-secrets#create-or-update-a-repository-secret parameters: - - *368 - - *369 - - *203 + - *370 + - *371 + - *205 requestBody: required: true content: @@ -69604,7 +70190,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -69628,9 +70214,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/repository-secrets#delete-a-repository-secret parameters: - - *368 - - *369 - - *203 + - *370 + - *371 + - *205 responses: '204': description: Response @@ -69658,8 +70244,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/collaborators#list-repository-collaborators parameters: - - *368 - - *369 + - *370 + - *371 - name: affiliation description: Filter collaborators returned by their affiliation. `outside` means all outside collaborators of an organization-owned repository. `direct` @@ -69697,7 +70283,7 @@ paths: application/json: schema: type: array - items: &484 + items: &486 title: Collaborator description: Collaborator type: object @@ -69890,9 +70476,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/collaborators#check-if-a-user-is-a-repository-collaborator parameters: - - *368 - - *369 - - *215 + - *370 + - *371 + - *217 responses: '204': description: Response if user is a collaborator @@ -69938,9 +70524,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/collaborators#add-a-repository-collaborator parameters: - - *368 - - *369 - - *215 + - *370 + - *371 + - *217 requestBody: required: false content: @@ -69966,7 +70552,7 @@ paths: description: Response when a new invitation is created content: application/json: - schema: &557 + schema: &559 title: Repository Invitation description: Repository invitations let you manage who you collaborate with. @@ -69978,7 +70564,7 @@ paths: format: int64 examples: - 42 - repository: *193 + repository: *195 invitee: anyOf: - type: 'null' @@ -70154,7 +70740,7 @@ paths: - an Enterprise Managed User (EMU) account was invited to a repository in an enterprise with personal user accounts content: application/json: - schema: *176 + schema: *178 '403': *27 x-github: triggersNotification: true @@ -70194,9 +70780,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/collaborators#remove-a-repository-collaborator parameters: - - *368 - - *369 - - *215 + - *370 + - *371 + - *217 responses: '204': description: No Content when collaborator was removed from the repository. @@ -70227,9 +70813,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/collaborators#get-repository-permissions-for-a-user parameters: - - *368 - - *369 - - *215 + - *370 + - *371 + - *217 responses: '200': description: if user has admin permissions @@ -70249,7 +70835,7 @@ paths: user: anyOf: - type: 'null' - - *484 + - *486 required: - permission - role_name @@ -70303,8 +70889,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/comments#list-commit-comments-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -70314,7 +70900,7 @@ paths: application/json: schema: type: array - items: &485 + items: &487 title: Commit Comment description: Commit Comment type: object @@ -70355,8 +70941,8 @@ paths: updated_at: type: string format: date-time - author_association: *138 - reactions: *139 + author_association: *141 + reactions: *142 required: - url - html_url @@ -70372,7 +70958,7 @@ paths: - created_at - updated_at examples: - default: &488 + default: &490 value: - html_url: https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e#commitcomment-1 url: https://api.github.com/repos/octocat/Hello-World/comments/1 @@ -70431,17 +71017,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/comments#get-a-commit-comment parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 responses: '200': description: Response content: application/json: - schema: *485 + schema: *487 examples: - default: &489 + default: &491 value: html_url: https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e#commitcomment-1 url: https://api.github.com/repos/octocat/Hello-World/comments/1 @@ -70498,9 +71084,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/comments#update-a-commit-comment parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 requestBody: required: true content: @@ -70522,7 +71108,7 @@ paths: description: Response content: application/json: - schema: *485 + schema: *487 examples: default: value: @@ -70573,9 +71159,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/comments#delete-a-commit-comment parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 responses: '204': description: Response @@ -70596,9 +71182,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#list-reactions-for-a-commit-comment parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 - name: content description: Returns a single [reaction type](https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to a commit comment. @@ -70624,9 +71210,9 @@ paths: application/json: schema: type: array - items: *357 + items: *359 examples: - default: *359 + default: *361 headers: Link: *38 '404': *6 @@ -70647,9 +71233,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#create-reaction-for-a-commit-comment parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 requestBody: required: true content: @@ -70681,16 +71267,16 @@ paths: description: Reaction exists content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 '201': description: Reaction created content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 '422': *15 x-github: githubCloudOnly: false @@ -70712,10 +71298,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#delete-a-commit-comment-reaction parameters: - - *368 - - *369 - - *150 - - *360 + - *370 + - *371 + - *153 + - *362 responses: '204': description: Response @@ -70764,8 +71350,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/commits#list-commits parameters: - - *368 - - *369 + - *370 + - *371 - name: sha description: 'SHA or branch to start listing commits from. Default: the repository’s default branch (usually `main`).' @@ -70821,9 +71407,9 @@ paths: application/json: schema: type: array - items: *486 + items: *488 examples: - default: &605 + default: &607 value: - url: https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e sha: 6dcb09b5b57875f334f61aebed695e2e4193db5e @@ -70894,10 +71480,10 @@ paths: sha: 6dcb09b5b57875f334f61aebed695e2e4193db5e headers: Link: *38 - '500': *83 + '500': *86 '400': *14 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -70917,9 +71503,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/commits#list-branches-for-head-commit parameters: - - *368 - - *369 - - &487 + - *370 + - *371 + - &489 name: commit_sha description: The SHA of the commit. in: path @@ -70966,7 +71552,7 @@ paths: url: https://api.github.com/repos/octocat/Hello-World/commits/c5b97d5ae6c19d5c5df71a34c7fbeeda2479ccbc protected: false '422': *15 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -70991,9 +71577,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/comments#list-commit-comments parameters: - - *368 - - *369 - - *487 + - *370 + - *371 + - *489 - *17 - *19 responses: @@ -71003,9 +71589,9 @@ paths: application/json: schema: type: array - items: *485 + items: *487 examples: - default: *488 + default: *490 headers: Link: *38 x-github: @@ -71033,9 +71619,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/comments#create-a-commit-comment parameters: - - *368 - - *369 - - *487 + - *370 + - *371 + - *489 requestBody: required: true content: @@ -71070,9 +71656,9 @@ paths: description: Response content: application/json: - schema: *485 + schema: *487 examples: - default: *489 + default: *491 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/comments/1 @@ -71100,9 +71686,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/commits#list-pull-requests-associated-with-a-commit parameters: - - *368 - - *369 - - *487 + - *370 + - *371 + - *489 - *17 - *19 responses: @@ -71112,7 +71698,7 @@ paths: application/json: schema: type: array - items: &596 + items: &598 title: Pull Request Simple description: Pull Request Simple type: object @@ -71232,7 +71818,7 @@ paths: milestone: anyOf: - type: 'null' - - *490 + - *492 active_lock_reason: type: - string @@ -71287,7 +71873,7 @@ paths: type: - array - 'null' - items: *224 + items: *226 head: type: object properties: @@ -71331,7 +71917,7 @@ paths: _links: type: object properties: - comments: &491 + comments: &493 title: Link description: Hypermedia Link type: object @@ -71340,13 +71926,13 @@ paths: type: string required: - href - commits: *491 - statuses: *491 - html: *491 - issue: *491 - review_comments: *491 - review_comment: *491 - self: *491 + commits: *493 + statuses: *493 + html: *493 + issue: *493 + review_comments: *493 + review_comment: *493 + self: *493 required: - comments - commits @@ -71356,8 +71942,8 @@ paths: - review_comments - review_comment - self - author_association: *138 - auto_merge: &598 + author_association: *141 + auto_merge: &600 title: Auto merge description: The status of auto merging a pull request. type: @@ -71422,7 +72008,7 @@ paths: - author_association - auto_merge examples: - default: &597 + default: &599 value: - url: https://api.github.com/repos/octocat/Hello-World/pulls/1347 id: 1 @@ -71902,7 +72488,7 @@ paths: draft: false headers: Link: *38 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -71959,11 +72545,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/commits#get-a-commit parameters: - - *368 - - *369 + - *370 + - *371 - *19 - *17 - - &492 + - &494 name: ref description: The commit reference. Can be a commit SHA, branch name (`heads/BRANCH_NAME`), or tag name (`tags/TAG_NAME`). For more information, see "[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)" @@ -71978,9 +72564,9 @@ paths: description: Response content: application/json: - schema: *486 + schema: *488 examples: - default: &584 + default: &586 value: url: https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e sha: 6dcb09b5b57875f334f61aebed695e2e4193db5e @@ -72066,9 +72652,9 @@ paths: ..... '422': *15 '404': *6 - '500': *83 - '503': *130 - '409': *94 + '500': *86 + '503': *133 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -72093,11 +72679,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/runs#list-check-runs-for-a-git-reference parameters: - - *368 - - *369 - - *492 - - *493 + - *370 + - *371 - *494 + - *495 + - *496 - name: filter description: Filters check runs by their `completed_at` timestamp. `latest` returns the most recent check runs. @@ -72131,9 +72717,9 @@ paths: type: integer check_runs: type: array - items: *441 + items: *443 examples: - default: *495 + default: *497 headers: Link: *38 x-github: @@ -72158,9 +72744,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/suites#list-check-suites-for-a-git-reference parameters: - - *368 - - *369 - - *492 + - *370 + - *371 + - *494 - name: app_id description: Filters check suites by GitHub App `id`. in: query @@ -72168,7 +72754,7 @@ paths: schema: type: integer example: 1 - - *493 + - *495 - *17 - *19 responses: @@ -72186,7 +72772,7 @@ paths: type: integer check_suites: type: array - items: *445 + items: *447 examples: default: value: @@ -72386,9 +72972,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/statuses#get-the-combined-status-for-a-specific-reference parameters: - - *368 - - *369 - - *492 + - *370 + - *371 + - *494 - *17 - *19 responses: @@ -72459,7 +73045,7 @@ paths: type: string total_count: type: integer - repository: *193 + repository: *195 commit_url: type: string format: uri @@ -72590,9 +73176,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/statuses#list-commit-statuses-for-a-reference parameters: - - *368 - - *369 - - *492 + - *370 + - *371 + - *494 - *17 - *19 responses: @@ -72602,7 +73188,7 @@ paths: application/json: schema: type: array - items: &677 + items: &679 title: Status description: The status of a commit. type: object @@ -72683,7 +73269,7 @@ paths: site_admin: false headers: Link: *38 - '301': *382 + '301': *384 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -72711,8 +73297,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/community#get-community-profile-metrics parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -72745,11 +73331,11 @@ paths: code_of_conduct: anyOf: - type: 'null' - - *496 + - *498 code_of_conduct_file: anyOf: - type: 'null' - - &497 + - &499 title: Community Health File type: object properties: @@ -72765,23 +73351,23 @@ paths: license: anyOf: - type: 'null' - - *152 + - *155 contributing: anyOf: - type: 'null' - - *497 + - *499 readme: anyOf: - type: 'null' - - *497 + - *499 issue_template: anyOf: - type: 'null' - - *497 + - *499 pull_request_template: anyOf: - type: 'null' - - *497 + - *499 required: - code_of_conduct - code_of_conduct_file @@ -72910,8 +73496,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/commits#compare-two-commits parameters: - - *368 - - *369 + - *370 + - *371 - *19 - *17 - name: basehead @@ -72959,8 +73545,8 @@ paths: format: uri examples: - https://github.com/octocat/Hello-World/compare/master...topic.patch - base_commit: *486 - merge_base_commit: *486 + base_commit: *488 + merge_base_commit: *488 status: type: string enum: @@ -72984,10 +73570,10 @@ paths: - 6 commits: type: array - items: *486 + items: *488 files: type: array - items: *498 + items: *500 required: - url - html_url @@ -73230,8 +73816,8 @@ paths: patch: "@@ -132,7 +132,7 @@ module Test @@ -1000,7 +1000,7 @@ module Test" '404': *6 - '500': *83 - '503': *130 + '500': *86 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -73273,8 +73859,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/contents#get-repository-content parameters: - - *368 - - *369 + - *370 + - *371 - name: path description: path parameter in: path @@ -73427,7 +74013,7 @@ paths: - type - url examples: - response-if-content-is-a-file: &499 + response-if-content-is-a-file: &501 summary: Response if content is a file value: type: file @@ -73564,7 +74150,7 @@ paths: - size - type - url - - &610 + - &612 title: Content File description: Content File type: object @@ -73782,7 +74368,7 @@ paths: - url - submodule_git_url examples: - response-if-content-is-a-file: *499 + response-if-content-is-a-file: *501 response-if-content-is-a-directory: summary: Response if content is a directory and the application/json media type is requested @@ -73851,7 +74437,7 @@ paths: html: https://github.com/jquery/qunit/tree/6ca3721222109997540bd6d9ccd396902e0ad2f9 '404': *6 '403': *27 - '302': *500 + '302': *502 '304': *35 x-github: githubCloudOnly: false @@ -73874,8 +74460,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/contents#create-or-update-file-contents parameters: - - *368 - - *369 + - *370 + - *371 - name: path description: path parameter in: path @@ -73970,7 +74556,7 @@ paths: description: Response content: application/json: - schema: &501 + schema: &503 title: File Commit description: File Commit type: object @@ -74126,7 +74712,7 @@ paths: description: Response content: application/json: - schema: *501 + schema: *503 examples: example-for-creating-a-file: value: @@ -74180,7 +74766,7 @@ paths: schema: oneOf: - *3 - - &539 + - &541 description: Repository rule violation was detected type: object properties: @@ -74201,7 +74787,7 @@ paths: items: type: object properties: - placeholder_id: &669 + placeholder_id: &671 description: The ID of the push protection bypass placeholder. This value is returned on any push protected routes. @@ -74233,8 +74819,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/contents#delete-a-file parameters: - - *368 - - *369 + - *370 + - *371 - name: path description: path parameter in: path @@ -74295,7 +74881,7 @@ paths: description: Response content: application/json: - schema: *501 + schema: *503 examples: default: value: @@ -74329,8 +74915,8 @@ paths: verified_at: '422': *15 '404': *6 - '409': *94 - '503': *130 + '409': *97 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -74350,8 +74936,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#list-repository-contributors parameters: - - *368 - - *369 + - *370 + - *371 - name: anon description: Set to `1` or `true` to include anonymous contributors in results. in: query @@ -74475,23 +75061,23 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/alerts#list-dependabot-alerts-for-a-repository parameters: - - *368 - - *369 - - *244 - - *245 + - *370 + - *371 - *246 - *247 + - *248 + - *249 - name: manifest in: query description: A comma-separated list of full manifest paths. If specified, only alerts for these manifests will be returned. schema: type: string - - *248 - - *249 - *250 - *251 - - *86 + - *252 + - *253 + - *89 - name: page description: "**Closing down notice**. Page number of the results to fetch. Use cursor-based pagination with `before` or `after` instead." @@ -74508,10 +75094,10 @@ paths: schema: type: integer default: 30 - - *84 - - *85 - - *252 - - *253 + - *87 + - *88 + - *254 + - *255 responses: '200': description: Response @@ -74519,11 +75105,11 @@ paths: application/json: schema: type: array - items: &504 + items: &506 type: object description: A Dependabot alert. properties: - number: *96 + number: *99 state: type: string description: The state of the Dependabot alert. @@ -74538,7 +75124,7 @@ paths: description: Details for the vulnerable dependency. readOnly: true properties: - package: *97 + package: *100 manifest_path: type: string description: The full path to the dependency manifest file, @@ -74569,13 +75155,13 @@ paths: - direct - transitive - - security_advisory: *502 - security_vulnerability: *100 - url: *101 - html_url: *102 - created_at: *103 - updated_at: *104 - dismissed_at: *105 + security_advisory: *504 + security_vulnerability: *103 + url: *104 + html_url: *105 + created_at: *106 + updated_at: *107 + dismissed_at: *108 dismissed_by: anyOf: - type: 'null' @@ -74599,8 +75185,8 @@ paths: description: An optional comment associated with the alert's dismissal. maxLength: 280 - fixed_at: *106 - auto_dismissed_at: *503 + fixed_at: *109 + auto_dismissed_at: *505 required: - number - state @@ -74830,9 +75416,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/alerts#get-a-dependabot-alert parameters: - - *368 - - *369 - - &505 + - *370 + - *371 + - &507 name: alert_number in: path description: |- @@ -74841,13 +75427,13 @@ paths: or in `number` fields in the response from the `GET /repos/{owner}/{repo}/dependabot/alerts` operation. required: true - schema: *96 + schema: *99 responses: '200': description: Response content: application/json: - schema: *504 + schema: *506 examples: default: value: @@ -74960,9 +75546,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/alerts#update-a-dependabot-alert parameters: - - *368 - - *369 - - *505 + - *370 + - *371 + - *507 requestBody: required: true content: @@ -75007,7 +75593,7 @@ paths: description: Response content: application/json: - schema: *504 + schema: *506 examples: default: value: @@ -75113,7 +75699,7 @@ paths: '400': *14 '403': *27 '404': *6 - '409': *94 + '409': *97 '422': *7 x-github: githubCloudOnly: false @@ -75136,8 +75722,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#list-repository-secrets parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -75155,7 +75741,7 @@ paths: type: integer secrets: type: array - items: &508 + items: &510 title: Dependabot Secret description: Set secrets for Dependabot. type: object @@ -75209,16 +75795,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#get-a-repository-public-key parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response content: application/json: - schema: *506 + schema: *508 examples: - default: *507 + default: *509 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -75238,15 +75824,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#get-a-repository-secret parameters: - - *368 - - *369 - - *203 + - *370 + - *371 + - *205 responses: '200': description: Response content: application/json: - schema: *508 + schema: *510 examples: default: value: @@ -75272,9 +75858,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#create-or-update-a-repository-secret parameters: - - *368 - - *369 - - *203 + - *370 + - *371 + - *205 requestBody: required: true content: @@ -75302,7 +75888,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -75326,9 +75912,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#delete-a-repository-secret parameters: - - *368 - - *369 - - *203 + - *370 + - *371 + - *205 responses: '204': description: Response @@ -75350,8 +75936,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependency-graph/dependency-review#get-a-diff-of-the-dependencies-between-commits parameters: - - *368 - - *369 + - *370 + - *371 - name: basehead description: The base and head Git revisions to compare. The Git revisions will be resolved to commit SHAs. Named revisions will be resolved to their @@ -75525,8 +76111,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependency-graph/sboms#export-a-software-bill-of-materials-sbom-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -75786,8 +76372,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependency-graph/dependency-submission#create-a-snapshot-of-dependencies-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -75870,7 +76456,7 @@ paths: - version - url additionalProperties: false - metadata: &509 + metadata: &511 title: metadata description: User-defined metadata to store domain-specific information limited to 8 keys with scalar values. @@ -75909,7 +76495,7 @@ paths: examples: - "/src/build/package-lock.json" additionalProperties: false - metadata: *509 + metadata: *511 resolved: type: object description: A collection of resolved package dependencies. @@ -75923,7 +76509,7 @@ paths: pattern: "^pkg" examples: - pkg:/npm/%40actions/http-client@1.0.11 - metadata: *509 + metadata: *511 relationship: type: string description: A notation of whether a dependency is requested @@ -76056,8 +76642,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/deployments#list-deployments parameters: - - *368 - - *369 + - *370 + - *371 - name: sha description: The SHA recorded at creation time. in: query @@ -76098,9 +76684,9 @@ paths: application/json: schema: type: array - items: *510 + items: *512 examples: - default: *511 + default: *513 headers: Link: *38 x-github: @@ -76166,8 +76752,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/deployments#create-a-deployment parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -76249,7 +76835,7 @@ paths: description: Response content: application/json: - schema: *510 + schema: *512 examples: simple-example: summary: Simple example @@ -76322,9 +76908,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/deployments#get-a-deployment parameters: - - *368 - - *369 - - &512 + - *370 + - *371 + - &514 name: deployment_id description: deployment_id parameter in: path @@ -76336,7 +76922,7 @@ paths: description: Response content: application/json: - schema: *510 + schema: *512 examples: default: value: @@ -76401,9 +76987,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/deployments#delete-a-deployment parameters: - - *368 - - *369 - - *512 + - *370 + - *371 + - *514 responses: '204': description: Response @@ -76425,9 +77011,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/statuses#list-deployment-statuses parameters: - - *368 - - *369 - - *512 + - *370 + - *371 + - *514 - *17 - *19 responses: @@ -76437,7 +77023,7 @@ paths: application/json: schema: type: array - items: &513 + items: &515 title: Deployment Status description: The status of a deployment. type: object @@ -76601,9 +77187,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/statuses#create-a-deployment-status parameters: - - *368 - - *369 - - *512 + - *370 + - *371 + - *514 requestBody: required: true content: @@ -76678,9 +77264,9 @@ paths: description: Response content: application/json: - schema: *513 + schema: *515 examples: - default: &514 + default: &516 value: url: https://api.github.com/repos/octocat/example/deployments/42/statuses/1 id: 1 @@ -76736,9 +77322,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/statuses#get-a-deployment-status parameters: - - *368 - - *369 - - *512 + - *370 + - *371 + - *514 - name: status_id in: path required: true @@ -76749,9 +77335,9 @@ paths: description: Response content: application/json: - schema: *513 + schema: *515 examples: - default: *514 + default: *516 '404': *6 x-github: githubCloudOnly: false @@ -76778,12 +77364,12 @@ paths: category: code-scanning subcategory: alert-dismissal-requests parameters: - - *368 - - *369 - - *515 - - *516 + - *370 + - *371 - *517 - *518 + - *519 + - *520 - *17 - *19 responses: @@ -76793,12 +77379,12 @@ paths: application/json: schema: type: array - items: *519 + items: *521 examples: - default: *520 + default: *522 '404': *6 '403': *27 - '500': *83 + '500': *86 "/repos/{owner}/{repo}/dismissal-requests/code-scanning/{alert_number}": get: summary: Get a dismissal request for a code scanning alert for a repository @@ -76819,8 +77405,8 @@ paths: category: code-scanning subcategory: alert-dismissal-requests parameters: - - *368 - - *369 + - *370 + - *371 - name: alert_number in: path required: true @@ -76832,7 +77418,7 @@ paths: description: A single dismissal request. content: application/json: - schema: *519 + schema: *521 examples: default: value: @@ -76868,7 +77454,7 @@ paths: html_url: https://github.com/octo-org/smile/code-scanning/alerts/1 '404': *6 '403': *27 - '500': *83 + '500': *86 patch: summary: Review a dismissal request for a code scanning alert for a repository description: |- @@ -76888,8 +77474,8 @@ paths: category: code-scanning subcategory: alert-dismissal-requests parameters: - - *368 - - *369 + - *370 + - *371 - name: alert_number in: path required: true @@ -76927,7 +77513,7 @@ paths: '404': *6 '403': *27 '422': *15 - '500': *83 + '500': *86 "/repos/{owner}/{repo}/dismissal-requests/secret-scanning": get: summary: List alert dismissal requests for secret scanning for a repository @@ -76948,12 +77534,12 @@ paths: category: secret-scanning subcategory: alert-dismissal-requests parameters: - - *368 - - *369 - - *216 - - *217 + - *370 + - *371 - *218 - - *521 + - *219 + - *220 + - *523 - *17 - *19 responses: @@ -76963,12 +77549,12 @@ paths: application/json: schema: type: array - items: *522 + items: *524 examples: - default: *523 + default: *525 '404': *6 '403': *27 - '500': *83 + '500': *86 "/repos/{owner}/{repo}/dismissal-requests/secret-scanning/{alert_number}": get: summary: Get an alert dismissal request for secret scanning @@ -76990,8 +77576,8 @@ paths: category: secret-scanning subcategory: alert-dismissal-requests parameters: - - *368 - - *369 + - *370 + - *371 - name: alert_number in: path required: true @@ -77003,7 +77589,7 @@ paths: description: A single dismissal request. content: application/json: - schema: *522 + schema: *524 examples: default: value: @@ -77040,7 +77626,7 @@ paths: html_url: https://github.com/octo-org/smile/security/secret-scanning/17 '404': *6 '403': *27 - '500': *83 + '500': *86 patch: summary: Review an alert dismissal request for secret scanning description: |- @@ -77061,8 +77647,8 @@ paths: category: secret-scanning subcategory: alert-dismissal-requests parameters: - - *368 - - *369 + - *370 + - *371 - name: alert_number in: path required: true @@ -77112,7 +77698,7 @@ paths: '404': *6 '403': *27 '422': *15 - '500': *83 + '500': *86 "/repos/{owner}/{repo}/dispatches": post: summary: Create a repository dispatch event @@ -77131,8 +77717,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#create-a-repository-dispatch-event parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -77189,8 +77775,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/environments#list-environments parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -77208,7 +77794,7 @@ paths: - 5 environments: type: array - items: &525 + items: &527 title: Environment description: Details of a deployment environment type: object @@ -77270,7 +77856,7 @@ paths: type: string examples: - wait_timer - wait_timer: &527 + wait_timer: &529 type: integer description: The amount of time to delay a job after the job is initially triggered. The time (in minutes) @@ -77312,11 +77898,11 @@ paths: items: type: object properties: - type: *524 + type: *526 reviewer: anyOf: - *4 - - *224 + - *226 required: - id - node_id @@ -77339,7 +77925,7 @@ paths: - id - node_id - type - deployment_branch_policy: &528 + deployment_branch_policy: &530 type: - object - 'null' @@ -77456,9 +78042,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/environments#get-an-environment parameters: - - *368 - - *369 - - &526 + - *370 + - *371 + - &528 name: environment_name in: path required: true @@ -77471,9 +78057,9 @@ paths: description: Response content: application/json: - schema: *525 + schema: *527 examples: - default: &529 + default: &531 value: id: 161088068 node_id: MDExOkVudmlyb25tZW50MTYxMDg4MDY4 @@ -77557,9 +78143,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/environments#create-or-update-an-environment parameters: - - *368 - - *369 - - *526 + - *370 + - *371 + - *528 requestBody: required: false content: @@ -77569,7 +78155,7 @@ paths: - object - 'null' properties: - wait_timer: *527 + wait_timer: *529 prevent_self_review: type: boolean description: Whether or not a user who created the job is prevented @@ -77588,14 +78174,14 @@ paths: items: type: object properties: - type: *524 + type: *526 id: type: integer description: The id of the user or team who can review the deployment examples: - 4532992 - deployment_branch_policy: *528 + deployment_branch_policy: *530 additionalProperties: false examples: default: @@ -77615,9 +78201,9 @@ paths: description: Response content: application/json: - schema: *525 + schema: *527 examples: - default: *529 + default: *531 '422': description: Validation error when the environment name is invalid or when `protected_branches` and `custom_branch_policies` in `deployment_branch_policy` @@ -77641,9 +78227,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/environments#delete-an-environment parameters: - - *368 - - *369 - - *526 + - *370 + - *371 + - *528 responses: '204': description: Default response @@ -77668,9 +78254,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/branch-policies#list-deployment-branch-policies parameters: - - *368 - - *369 - - *526 + - *370 + - *371 + - *528 - *17 - *19 responses: @@ -77689,7 +78275,7 @@ paths: - 2 branch_policies: type: array - items: &530 + items: &532 title: Deployment branch policy description: Details of a deployment branch or tag policy. type: object @@ -77750,9 +78336,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/branch-policies#create-a-deployment-branch-policy parameters: - - *368 - - *369 - - *526 + - *370 + - *371 + - *528 requestBody: required: true content: @@ -77800,9 +78386,9 @@ paths: description: Response content: application/json: - schema: *530 + schema: *532 examples: - example-wildcard: &531 + example-wildcard: &533 value: id: 364662 node_id: MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjQ2NjI= @@ -77844,10 +78430,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/branch-policies#get-a-deployment-branch-policy parameters: - - *368 - - *369 - - *526 - - &532 + - *370 + - *371 + - *528 + - &534 name: branch_policy_id in: path required: true @@ -77859,9 +78445,9 @@ paths: description: Response content: application/json: - schema: *530 + schema: *532 examples: - default: *531 + default: *533 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -77880,10 +78466,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/branch-policies#update-a-deployment-branch-policy parameters: - - *368 - - *369 - - *526 - - *532 + - *370 + - *371 + - *528 + - *534 requestBody: required: true content: @@ -77912,9 +78498,9 @@ paths: description: Response content: application/json: - schema: *530 + schema: *532 examples: - default: *531 + default: *533 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -77933,10 +78519,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/branch-policies#delete-a-deployment-branch-policy parameters: - - *368 - - *369 - - *526 - - *532 + - *370 + - *371 + - *528 + - *534 responses: '204': description: Response @@ -77961,9 +78547,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/protection-rules#get-all-deployment-protection-rules-for-an-environment parameters: - - *526 - - *369 - - *368 + - *528 + - *371 + - *370 responses: '200': description: List of deployment protection rules @@ -77980,7 +78566,7 @@ paths: - 10 custom_deployment_protection_rules: type: array - items: &533 + items: &535 title: Deployment protection rule description: Deployment protection rule type: object @@ -78002,7 +78588,7 @@ paths: for the environment. examples: - true - app: &534 + app: &536 title: Custom deployment protection rule app description: A GitHub App that is providing a custom deployment protection rule. @@ -78105,9 +78691,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/protection-rules#create-a-custom-deployment-protection-rule-on-an-environment parameters: - - *526 - - *369 - - *368 + - *528 + - *371 + - *370 requestBody: content: application/json: @@ -78128,9 +78714,9 @@ paths: description: The enabled custom deployment protection rule content: application/json: - schema: *533 + schema: *535 examples: - default: &535 + default: &537 value: id: 3 node_id: IEH37kRlcGxveW1lbnRTdGF0ddiv @@ -78165,9 +78751,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/protection-rules#list-custom-deployment-rule-integrations-available-for-an-environment parameters: - - *526 - - *369 - - *368 + - *528 + - *371 + - *370 - *19 - *17 responses: @@ -78187,7 +78773,7 @@ paths: - 35 available_custom_deployment_protection_rule_integrations: type: array - items: *534 + items: *536 examples: default: value: @@ -78222,10 +78808,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/protection-rules#get-a-custom-deployment-protection-rule parameters: - - *368 - - *369 - - *526 - - &536 + - *370 + - *371 + - *528 + - &538 name: protection_rule_id description: The unique identifier of the protection rule. in: path @@ -78237,9 +78823,9 @@ paths: description: Response content: application/json: - schema: *533 + schema: *535 examples: - default: *535 + default: *537 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -78260,10 +78846,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/protection-rules#disable-a-custom-protection-rule-for-an-environment parameters: - - *526 - - *369 - - *368 - - *536 + - *528 + - *371 + - *370 + - *538 responses: '204': description: Response @@ -78289,9 +78875,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#list-environment-secrets parameters: - - *368 - - *369 - - *526 + - *370 + - *371 + - *528 - *17 - *19 responses: @@ -78309,9 +78895,9 @@ paths: type: integer secrets: type: array - items: *405 + items: *407 examples: - default: *406 + default: *408 headers: Link: *38 x-github: @@ -78336,17 +78922,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#get-an-environment-public-key parameters: - - *368 - - *369 - - *526 + - *370 + - *371 + - *528 responses: '200': description: Response content: application/json: - schema: *407 + schema: *409 examples: - default: *408 + default: *410 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -78368,18 +78954,18 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#get-an-environment-secret parameters: - - *368 - - *369 - - *526 - - *203 + - *370 + - *371 + - *528 + - *205 responses: '200': description: Response content: application/json: - schema: *405 + schema: *407 examples: - default: *537 + default: *539 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -78401,10 +78987,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#create-or-update-an-environment-secret parameters: - - *368 - - *369 - - *526 - - *203 + - *370 + - *371 + - *528 + - *205 requestBody: required: true content: @@ -78435,7 +79021,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -78461,10 +79047,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#delete-an-environment-secret parameters: - - *368 - - *369 - - *526 - - *203 + - *370 + - *371 + - *528 + - *205 responses: '204': description: Default response @@ -78489,10 +79075,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#list-environment-variables parameters: - - *368 - - *369 - - *526 - - *392 + - *370 + - *371 + - *528 + - *394 - *19 responses: '200': @@ -78509,9 +79095,9 @@ paths: type: integer variables: type: array - items: *409 + items: *411 examples: - default: *410 + default: *412 headers: Link: *38 x-github: @@ -78534,9 +79120,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#create-an-environment-variable parameters: - - *368 - - *369 - - *526 + - *370 + - *371 + - *528 requestBody: required: true content: @@ -78563,7 +79149,7 @@ paths: description: Response content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -78588,18 +79174,18 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#get-an-environment-variable parameters: - - *368 - - *369 - - *526 - - *206 + - *370 + - *371 + - *528 + - *208 responses: '200': description: Response content: application/json: - schema: *409 + schema: *411 examples: - default: *538 + default: *540 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -78620,10 +79206,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#update-an-environment-variable parameters: - - *368 - - *369 - - *206 - - *526 + - *370 + - *371 + - *208 + - *528 requestBody: required: true content: @@ -78665,10 +79251,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#delete-an-environment-variable parameters: - - *368 - - *369 - - *206 - - *526 + - *370 + - *371 + - *208 + - *528 responses: '204': description: Response @@ -78690,8 +79276,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/events#list-repository-events parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -78701,7 +79287,7 @@ paths: application/json: schema: type: array - items: *162 + items: *165 examples: 200-response: value: @@ -78768,8 +79354,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/forks#list-forks parameters: - - *368 - - *369 + - *370 + - *371 - name: sort description: The sort order. `stargazers` will sort by star count. in: query @@ -78791,7 +79377,7 @@ paths: application/json: schema: type: array - items: *193 + items: *195 examples: default: value: @@ -78928,8 +79514,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/forks#create-a-fork parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: false content: @@ -78962,9 +79548,9 @@ paths: description: Response content: application/json: - schema: *381 + schema: *383 examples: - default: *383 + default: *385 '400': *14 '422': *15 '403': *27 @@ -78985,8 +79571,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/blobs#create-a-blob parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -79037,7 +79623,7 @@ paths: schema: type: string '404': *6 - '409': *94 + '409': *97 '403': *27 '422': description: Validation failed @@ -79045,8 +79631,8 @@ paths: application/json: schema: oneOf: - - *176 - - *539 + - *178 + - *541 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79071,8 +79657,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/blobs#get-a-blob parameters: - - *368 - - *369 + - *370 + - *371 - name: file_sha in: path required: true @@ -79124,7 +79710,7 @@ paths: '404': *6 '422': *15 '403': *27 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79172,8 +79758,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/commits#create-a-commit parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -79282,7 +79868,7 @@ paths: description: Response content: application/json: - schema: &540 + schema: &542 title: Git Commit description: Low-level Git commit operations within a repository type: object @@ -79459,7 +80045,7 @@ paths: type: string '422': *15 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79509,15 +80095,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/commits#get-a-commit-object parameters: - - *368 - - *369 - - *487 + - *370 + - *371 + - *489 responses: '200': description: Response content: application/json: - schema: *540 + schema: *542 examples: default: value: @@ -79548,7 +80134,7 @@ paths: payload: verified_at: '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79573,9 +80159,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/refs#list-matching-references parameters: - - *368 - - *369 - - &541 + - *370 + - *371 + - &543 name: ref description: The Git reference. For more information, see "[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)" in the Git documentation. @@ -79592,7 +80178,7 @@ paths: application/json: schema: type: array - items: &542 + items: &544 title: Git Reference description: Git references within a repository type: object @@ -79647,7 +80233,7 @@ paths: url: https://api.github.com/repos/octocat/Hello-World/git/commits/612077ae6dffb4d2fbd8ce0cccaa58893b07b5ac headers: Link: *38 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79668,17 +80254,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/refs#get-a-reference parameters: - - *368 - - *369 - - *541 + - *370 + - *371 + - *543 responses: '200': description: Response content: application/json: - schema: *542 + schema: *544 examples: - default: &543 + default: &545 value: ref: refs/heads/featureA node_id: MDM6UmVmcmVmcy9oZWFkcy9mZWF0dXJlQQ== @@ -79688,7 +80274,7 @@ paths: sha: aa218f56b14c9653891f9e74264a383fa43fefbd url: https://api.github.com/repos/octocat/Hello-World/git/commits/aa218f56b14c9653891f9e74264a383fa43fefbd '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79707,8 +80293,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/refs#create-a-reference parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -79737,16 +80323,16 @@ paths: description: Response content: application/json: - schema: *542 + schema: *544 examples: - default: *543 + default: *545 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/git/refs/heads/featureA schema: type: string '422': *15 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79765,9 +80351,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/refs#update-a-reference parameters: - - *368 - - *369 - - *541 + - *370 + - *371 + - *543 requestBody: required: true content: @@ -79796,11 +80382,11 @@ paths: description: Response content: application/json: - schema: *542 + schema: *544 examples: - default: *543 + default: *545 '422': *15 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79816,16 +80402,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/refs#delete-a-reference parameters: - - *368 - - *369 - - *541 + - *370 + - *371 + - *543 responses: '204': description: Response '422': description: Validation failed, an attempt was made to delete the default branch, or the endpoint has been spammed. - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79873,8 +80459,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/tags#create-a-tag-object parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -79941,7 +80527,7 @@ paths: description: Response content: application/json: - schema: &545 + schema: &547 title: Git Tag description: Metadata for a Git tag type: object @@ -79997,7 +80583,7 @@ paths: - sha - type - url - verification: *544 + verification: *546 required: - sha - url @@ -80007,7 +80593,7 @@ paths: - tag - message examples: - default: &546 + default: &548 value: node_id: MDM6VGFnOTQwYmQzMzYyNDhlZmFlMGY5ZWU1YmM3YjJkNWM5ODU4ODdiMTZhYw== tag: v0.0.1 @@ -80034,7 +80620,7 @@ paths: schema: type: string '422': *15 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -80080,8 +80666,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/tags#get-a-tag parameters: - - *368 - - *369 + - *370 + - *371 - name: tag_sha in: path required: true @@ -80092,11 +80678,11 @@ paths: description: Response content: application/json: - schema: *545 + schema: *547 examples: - default: *546 + default: *548 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -80118,8 +80704,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/trees#create-a-tree parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -80193,7 +80779,7 @@ paths: description: Response content: application/json: - schema: &547 + schema: &549 title: Git Tree description: The hierarchy between files in a Git repository. type: object @@ -80272,7 +80858,7 @@ paths: '422': *15 '404': *6 '403': *27 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -80295,8 +80881,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/trees#get-a-tree parameters: - - *368 - - *369 + - *370 + - *371 - name: tree_sha description: The SHA1 value or ref (branch or tag) name of the tree. in: path @@ -80319,7 +80905,7 @@ paths: description: Response content: application/json: - schema: *547 + schema: *549 examples: default-response: summary: Default response @@ -80360,7 +80946,7 @@ paths: truncated: false '422': *15 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -80378,8 +80964,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#list-repository-webhooks parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -80389,7 +80975,7 @@ paths: application/json: schema: type: array - items: &548 + items: &550 title: Webhook description: Webhooks for repositories. type: object @@ -80452,7 +81038,7 @@ paths: format: uri examples: - https://api.github.com/repos/octocat/Hello-World/hooks/1/deliveries - last_response: &806 + last_response: &808 title: Hook Response type: object properties: @@ -80529,8 +81115,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#create-a-repository-webhook parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: false content: @@ -80583,9 +81169,9 @@ paths: description: Response content: application/json: - schema: *548 + schema: *550 examples: - default: &549 + default: &551 value: type: Repository id: 12345678 @@ -80633,17 +81219,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#get-a-repository-webhook parameters: - - *368 - - *369 - - *259 + - *370 + - *371 + - *261 responses: '200': description: Response content: application/json: - schema: *548 + schema: *550 examples: - default: *549 + default: *551 '404': *6 x-github: githubCloudOnly: false @@ -80663,9 +81249,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#update-a-repository-webhook parameters: - - *368 - - *369 - - *259 + - *370 + - *371 + - *261 requestBody: required: true content: @@ -80710,9 +81296,9 @@ paths: description: Response content: application/json: - schema: *548 + schema: *550 examples: - default: *549 + default: *551 '422': *15 '404': *6 x-github: @@ -80733,9 +81319,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#delete-a-repository-webhook parameters: - - *368 - - *369 - - *259 + - *370 + - *371 + - *261 responses: '204': description: Response @@ -80759,9 +81345,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#get-a-webhook-configuration-for-a-repository parameters: - - *368 - - *369 - - *259 + - *370 + - *371 + - *261 responses: '200': description: Response @@ -80788,9 +81374,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#update-a-webhook-configuration-for-a-repository parameters: - - *368 - - *369 - - *259 + - *370 + - *371 + - *261 requestBody: required: false content: @@ -80834,11 +81420,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#list-deliveries-for-a-repository-webhook parameters: - - *368 - - *369 - - *259 + - *370 + - *371 + - *261 - *17 - - *260 + - *262 responses: '200': description: Response @@ -80846,9 +81432,9 @@ paths: application/json: schema: type: array - items: *261 + items: *263 examples: - default: *262 + default: *264 '400': *14 '422': *15 x-github: @@ -80867,18 +81453,18 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#get-a-delivery-for-a-repository-webhook parameters: - - *368 - - *369 - - *259 + - *370 + - *371 + - *261 - *16 responses: '200': description: Response content: application/json: - schema: *263 + schema: *265 examples: - default: *264 + default: *266 '400': *14 '422': *15 x-github: @@ -80897,9 +81483,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#redeliver-a-delivery-for-a-repository-webhook parameters: - - *368 - - *369 - - *259 + - *370 + - *371 + - *261 - *16 responses: '202': *37 @@ -80922,9 +81508,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#ping-a-repository-webhook parameters: - - *368 - - *369 - - *259 + - *370 + - *371 + - *261 responses: '204': description: Response @@ -80949,9 +81535,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#test-the-push-repository-webhook parameters: - - *368 - - *369 - - *259 + - *370 + - *371 + - *261 responses: '204': description: Response @@ -81009,14 +81595,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/source-imports#get-an-import-status parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response content: application/json: - schema: &550 + schema: &552 title: Import description: A repository import from an external source. type: object @@ -81123,7 +81709,7 @@ paths: - html_url - authors_url examples: - default: &553 + default: &555 value: vcs: subversion use_lfs: true @@ -81139,7 +81725,7 @@ paths: authors_url: https://api.github.com/repos/octocat/socm/import/authors repository_url: https://api.github.com/repos/octocat/socm '404': *6 - '503': &551 + '503': &553 description: Unavailable due to service under maintenance. content: application/json: @@ -81168,8 +81754,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/source-imports#start-an-import parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -81217,7 +81803,7 @@ paths: description: Response content: application/json: - schema: *550 + schema: *552 examples: default: value: @@ -81242,7 +81828,7 @@ paths: type: string '422': *15 '404': *6 - '503': *551 + '503': *553 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -81270,8 +81856,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/source-imports#update-an-import parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: false content: @@ -81323,7 +81909,7 @@ paths: description: Response content: application/json: - schema: *550 + schema: *552 examples: example-1: summary: Example 1 @@ -81371,7 +81957,7 @@ paths: html_url: https://import.github.com/octocat/socm/import authors_url: https://api.github.com/repos/octocat/socm/import/authors repository_url: https://api.github.com/repos/octocat/socm - '503': *551 + '503': *553 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -81394,12 +81980,12 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/source-imports#cancel-an-import parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response - '503': *551 + '503': *553 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -81425,9 +82011,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/source-imports#get-commit-authors parameters: - - *368 - - *369 - - &752 + - *370 + - *371 + - &754 name: since description: A user ID. Only return users with an ID greater than this ID. in: query @@ -81441,7 +82027,7 @@ paths: application/json: schema: type: array - items: &552 + items: &554 title: Porter Author description: Porter Author type: object @@ -81495,7 +82081,7 @@ paths: url: https://api.github.com/repos/octocat/socm/import/authors/2268559 import_url: https://api.github.com/repos/octocat/socm/import '404': *6 - '503': *551 + '503': *553 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -81520,8 +82106,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/source-imports#map-a-commit-author parameters: - - *368 - - *369 + - *370 + - *371 - name: author_id in: path required: true @@ -81551,7 +82137,7 @@ paths: description: Response content: application/json: - schema: *552 + schema: *554 examples: default: value: @@ -81564,7 +82150,7 @@ paths: import_url: https://api.github.com/repos/octocat/socm/import '422': *15 '404': *6 - '503': *551 + '503': *553 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -81588,8 +82174,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/source-imports#get-large-files parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -81630,7 +82216,7 @@ paths: path: foo/bar/3 oid: c20ad4d76fe97759aa27a0c99bff6710 size: 12582912 - '503': *551 + '503': *553 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -81658,8 +82244,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/source-imports#update-git-lfs-preference parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -81686,11 +82272,11 @@ paths: description: Response content: application/json: - schema: *550 + schema: *552 examples: - default: *553 + default: *555 '422': *15 - '503': *551 + '503': *553 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -81713,8 +82299,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#get-a-repository-installation-for-the-authenticated-app parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -81722,8 +82308,8 @@ paths: application/json: schema: *20 examples: - default: *554 - '301': *382 + default: *556 + '301': *384 '404': *6 x-github: githubCloudOnly: false @@ -81743,8 +82329,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/interactions/repos#get-interaction-restrictions-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -81752,12 +82338,12 @@ paths: application/json: schema: anyOf: - - *277 + - *279 - type: object properties: {} additionalProperties: false examples: - default: &556 + default: &558 value: limit: collaborators_only origin: repository @@ -81782,13 +82368,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/interactions/repos#set-interaction-restrictions-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: application/json: - schema: *555 + schema: *557 examples: default: summary: Example request body @@ -81800,9 +82386,9 @@ paths: description: Response content: application/json: - schema: *277 + schema: *279 examples: - default: *556 + default: *558 '409': description: Response x-github: @@ -81824,8 +82410,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/interactions/repos#remove-interaction-restrictions-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response @@ -81848,8 +82434,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/invitations#list-repository-invitations parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -81859,9 +82445,9 @@ paths: application/json: schema: type: array - items: *557 + items: *559 examples: - default: &745 + default: &747 value: - id: 1 repository: @@ -81992,9 +82578,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/invitations#update-a-repository-invitation parameters: - - *368 - - *369 - - *281 + - *370 + - *371 + - *283 requestBody: required: false content: @@ -82023,7 +82609,7 @@ paths: description: Response content: application/json: - schema: *557 + schema: *559 examples: default: value: @@ -82154,9 +82740,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/invitations#delete-a-repository-invitation parameters: - - *368 - - *369 - - *281 + - *370 + - *371 + - *283 responses: '204': description: Response @@ -82187,8 +82773,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#list-repository-issues parameters: - - *368 - - *369 + - *370 + - *371 - name: milestone description: If an `integer` is passed, it should refer to a milestone by its `number` field. If the string `*` is passed, issues with any milestone @@ -82236,7 +82822,7 @@ paths: required: false schema: type: string - - *285 + - *287 - name: sort description: What to sort results by. in: query @@ -82248,8 +82834,8 @@ paths: - updated - comments default: created - - *86 - - *141 + - *89 + - *144 - *17 - *19 responses: @@ -82259,9 +82845,9 @@ paths: application/json: schema: type: array - items: *151 + items: *154 examples: - default: &566 + default: &568 value: - id: 1 node_id: MDU6SXNzdWUx @@ -82409,7 +82995,7 @@ paths: state_reason: completed headers: Link: *38 - '301': *382 + '301': *384 '422': *15 '404': *6 x-github: @@ -82438,8 +83024,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#create-an-issue parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -82529,9 +83115,9 @@ paths: description: Response content: application/json: - schema: *151 + schema: *154 examples: - default: &561 + default: &563 value: id: 1 node_id: MDU6SXNzdWUx @@ -82685,9 +83271,9 @@ paths: '400': *14 '403': *27 '422': *15 - '503': *130 + '503': *133 '404': *6 - '410': *379 + '410': *381 x-github: triggersNotification: true githubCloudOnly: false @@ -82715,9 +83301,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/comments#list-issue-comments-for-a-repository parameters: - - *368 - - *369 - - *160 + - *370 + - *371 + - *163 - name: direction description: Either `asc` or `desc`. Ignored without the `sort` parameter. in: query @@ -82727,7 +83313,7 @@ paths: enum: - asc - desc - - *141 + - *144 - *17 - *19 responses: @@ -82737,9 +83323,9 @@ paths: application/json: schema: type: array - items: *558 + items: *560 examples: - default: &563 + default: &565 value: - id: 1 node_id: MDEyOklzc3VlQ29tbWVudDE= @@ -82797,17 +83383,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/comments#get-an-issue-comment parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 responses: '200': description: Response content: application/json: - schema: *558 + schema: *560 examples: - default: &559 + default: &561 value: id: 1 node_id: MDEyOklzc3VlQ29tbWVudDE= @@ -82861,9 +83447,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/comments#update-an-issue-comment parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 requestBody: required: true content: @@ -82885,9 +83471,9 @@ paths: description: Response content: application/json: - schema: *558 + schema: *560 examples: - default: *559 + default: *561 '422': *15 x-github: githubCloudOnly: false @@ -82905,9 +83491,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/comments#delete-an-issue-comment parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 responses: '204': description: Response @@ -82927,9 +83513,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#list-reactions-for-an-issue-comment parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 - name: content description: Returns a single [reaction type](https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to an issue comment. @@ -82955,9 +83541,9 @@ paths: application/json: schema: type: array - items: *357 + items: *359 examples: - default: *359 + default: *361 headers: Link: *38 '404': *6 @@ -82978,9 +83564,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#create-reaction-for-an-issue-comment parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 requestBody: required: true content: @@ -83012,16 +83598,16 @@ paths: description: Reaction exists content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 '201': description: Reaction created content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 '422': *15 x-github: githubCloudOnly: false @@ -83043,10 +83629,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#delete-an-issue-comment-reaction parameters: - - *368 - - *369 - - *150 - - *360 + - *370 + - *371 + - *153 + - *362 responses: '204': description: Response @@ -83066,8 +83652,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/events#list-issue-events-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -83077,7 +83663,7 @@ paths: application/json: schema: type: array - items: &560 + items: &562 title: Issue Event description: Issue Event type: object @@ -83124,7 +83710,7 @@ paths: issue: anyOf: - type: 'null' - - *151 + - *154 label: title: Issue Event Label description: Issue Event Label @@ -83157,7 +83743,7 @@ paths: anyOf: - type: 'null' - *4 - requested_team: *224 + requested_team: *226 dismissed_review: title: Issue Event Dismissed Review type: object @@ -83224,7 +83810,7 @@ paths: required: - from - to - author_association: *138 + author_association: *141 lock_reason: type: - string @@ -83416,8 +84002,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/events#get-an-issue-event parameters: - - *368 - - *369 + - *370 + - *371 - name: event_id in: path required: true @@ -83428,7 +84014,7 @@ paths: description: Response content: application/json: - schema: *560 + schema: *562 examples: default: value: @@ -83621,7 +84207,7 @@ paths: author_association: COLLABORATOR state_reason: completed '404': *6 - '410': *379 + '410': *381 '403': *27 x-github: githubCloudOnly: false @@ -83655,9 +84241,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue parameters: - - *368 - - *369 - - &562 + - *370 + - *371 + - &564 name: issue_number description: The number that identifies the issue. in: path @@ -83669,12 +84255,12 @@ paths: description: Response content: application/json: - schema: *151 + schema: *154 examples: - default: *561 - '301': *382 + default: *563 + '301': *384 '404': *6 - '410': *379 + '410': *381 '304': *35 x-github: githubCloudOnly: false @@ -83699,9 +84285,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#update-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 requestBody: required: false content: @@ -83819,15 +84405,15 @@ paths: description: Response content: application/json: - schema: *151 + schema: *154 examples: - default: *561 + default: *563 '422': *15 - '503': *130 + '503': *133 '403': *27 - '301': *382 + '301': *384 '404': *6 - '410': *379 + '410': *381 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -83845,9 +84431,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/assignees#add-assignees-to-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 requestBody: required: false content: @@ -83873,9 +84459,9 @@ paths: description: Response content: application/json: - schema: *151 + schema: *154 examples: - default: *561 + default: *563 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -83891,9 +84477,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/assignees#remove-assignees-from-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 requestBody: content: application/json: @@ -83918,9 +84504,9 @@ paths: description: Response content: application/json: - schema: *151 + schema: *154 examples: - default: *561 + default: *563 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -83942,9 +84528,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/assignees#check-if-a-user-can-be-assigned-to-a-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 - name: assignee in: path required: true @@ -83984,10 +84570,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/comments#list-issue-comments parameters: - - *368 - - *369 - - *562 - - *141 + - *370 + - *371 + - *564 + - *144 - *17 - *19 responses: @@ -83997,13 +84583,13 @@ paths: application/json: schema: type: array - items: *558 + items: *560 examples: - default: *563 + default: *565 headers: Link: *38 '404': *6 - '410': *379 + '410': *381 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -84032,9 +84618,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/comments#create-an-issue-comment parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 requestBody: required: true content: @@ -84056,16 +84642,16 @@ paths: description: Response content: application/json: - schema: *558 + schema: *560 examples: - default: *559 + default: *561 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/comments/1 schema: type: string '403': *27 - '410': *379 + '410': *381 '422': *15 '404': *6 x-github: @@ -84085,9 +84671,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/events#list-issue-events parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 - *17 - *19 responses: @@ -84101,7 +84687,7 @@ paths: title: Issue Event for Issue description: Issue Event for Issue anyOf: - - &567 + - &569 title: Labeled Issue Event description: Labeled Issue Event type: object @@ -84150,7 +84736,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &568 + - &570 title: Unlabeled Issue Event description: Unlabeled Issue Event type: object @@ -84278,7 +84864,7 @@ paths: - performed_via_github_app - assignee - assigner - - &569 + - &571 title: Milestoned Issue Event description: Milestoned Issue Event type: object @@ -84324,7 +84910,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &570 + - &572 title: Demilestoned Issue Event description: Demilestoned Issue Event type: object @@ -84370,7 +84956,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &571 + - &573 title: Renamed Issue Event description: Renamed Issue Event type: object @@ -84419,7 +85005,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &572 + - &574 title: Review Requested Issue Event description: Review Requested Issue Event type: object @@ -84448,7 +85034,7 @@ paths: - type: 'null' - *5 review_requester: *4 - requested_team: *224 + requested_team: *226 requested_reviewer: *4 required: - review_requester @@ -84461,7 +85047,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &573 + - &575 title: Review Request Removed Issue Event description: Review Request Removed Issue Event type: object @@ -84490,7 +85076,7 @@ paths: - type: 'null' - *5 review_requester: *4 - requested_team: *224 + requested_team: *226 requested_reviewer: *4 required: - review_requester @@ -84503,7 +85089,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &574 + - &576 title: Review Dismissed Issue Event description: Review Dismissed Issue Event type: object @@ -84559,7 +85145,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &575 + - &577 title: Locked Issue Event description: Locked Issue Event type: object @@ -84604,7 +85190,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &576 + - &578 title: Added to Project Issue Event description: Added to Project Issue Event type: object @@ -84665,7 +85251,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &577 + - &579 title: Moved Column in Project Issue Event description: Moved Column in Project Issue Event type: object @@ -84726,7 +85312,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &578 + - &580 title: Removed from Project Issue Event description: Removed from Project Issue Event type: object @@ -84787,7 +85373,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &579 + - &581 title: Converted Note to Issue Issue Event description: Converted Note to Issue Issue Event type: object @@ -84880,7 +85466,7 @@ paths: color: red headers: Link: *38 - '410': *379 + '410': *381 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -84897,9 +85483,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#list-labels-for-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 - *17 - *19 responses: @@ -84909,7 +85495,7 @@ paths: application/json: schema: type: array - items: &564 + items: &566 title: Label description: Color-coded labels help you categorize and filter your issues (just like labels in Gmail). @@ -84964,7 +85550,7 @@ paths: - color - default examples: - default: &565 + default: &567 value: - id: 208045946 node_id: MDU6TGFiZWwyMDgwNDU5NDY= @@ -84982,9 +85568,9 @@ paths: default: false headers: Link: *38 - '301': *382 + '301': *384 '404': *6 - '410': *379 + '410': *381 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -85001,9 +85587,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#add-labels-to-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 requestBody: required: false content: @@ -85062,12 +85648,12 @@ paths: application/json: schema: type: array - items: *564 + items: *566 examples: - default: *565 - '301': *382 + default: *567 + '301': *384 '404': *6 - '410': *379 + '410': *381 '422': *15 x-github: githubCloudOnly: false @@ -85084,9 +85670,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#set-labels-for-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 requestBody: required: false content: @@ -85146,12 +85732,12 @@ paths: application/json: schema: type: array - items: *564 + items: *566 examples: - default: *565 - '301': *382 + default: *567 + '301': *384 '404': *6 - '410': *379 + '410': *381 '422': *15 x-github: githubCloudOnly: false @@ -85168,15 +85754,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#remove-all-labels-from-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 responses: '204': description: Response - '301': *382 + '301': *384 '404': *6 - '410': *379 + '410': *381 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -85195,9 +85781,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#remove-a-label-from-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 - name: name in: path required: true @@ -85210,7 +85796,7 @@ paths: application/json: schema: type: array - items: *564 + items: *566 examples: default: value: @@ -85221,9 +85807,9 @@ paths: description: Something isn't working color: f29513 default: true - '301': *382 + '301': *384 '404': *6 - '410': *379 + '410': *381 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -85243,9 +85829,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#lock-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 requestBody: required: false content: @@ -85274,7 +85860,7 @@ paths: '204': description: Response '403': *27 - '410': *379 + '410': *381 '404': *6 '422': *15 x-github: @@ -85292,9 +85878,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#unlock-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 responses: '204': description: Response @@ -85316,9 +85902,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#list-reactions-for-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 - name: content description: Returns a single [reaction type](https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to an issue. @@ -85344,13 +85930,13 @@ paths: application/json: schema: type: array - items: *357 + items: *359 examples: - default: *359 + default: *361 headers: Link: *38 '404': *6 - '410': *379 + '410': *381 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -85368,9 +85954,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#create-reaction-for-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 requestBody: required: true content: @@ -85402,16 +85988,16 @@ paths: description: Response content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 '201': description: Response content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 '422': *15 x-github: githubCloudOnly: false @@ -85433,10 +86019,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#delete-an-issue-reaction parameters: - - *368 - - *369 - - *562 - - *360 + - *370 + - *371 + - *564 + - *362 responses: '204': description: Response @@ -85465,9 +86051,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/sub-issues#remove-sub-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 requestBody: required: true content: @@ -85489,9 +86075,9 @@ paths: description: Response content: application/json: - schema: *151 + schema: *154 examples: - default: *561 + default: *563 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/1/sub-issue @@ -85524,9 +86110,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/sub-issues#list-sub-issues parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 - *17 - *19 responses: @@ -85536,13 +86122,13 @@ paths: application/json: schema: type: array - items: *151 + items: *154 examples: - default: *566 + default: *568 headers: Link: *38 '404': *6 - '410': *379 + '410': *381 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -85570,9 +86156,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/sub-issues#add-sub-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 requestBody: required: true content: @@ -85599,16 +86185,16 @@ paths: description: Response content: application/json: - schema: *151 + schema: *154 examples: - default: *561 + default: *563 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/sub-issues/1 schema: type: string '403': *27 - '410': *379 + '410': *381 '422': *15 '404': *6 x-github: @@ -85628,9 +86214,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/sub-issues#reprioritize-sub-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 requestBody: required: true content: @@ -85661,13 +86247,13 @@ paths: description: Response content: application/json: - schema: *151 + schema: *154 examples: - default: *561 + default: *563 '403': *27 '404': *6 '422': *7 - '503': *130 + '503': *133 x-github: triggersNotification: true githubCloudOnly: false @@ -85685,9 +86271,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/timeline#list-timeline-events-for-an-issue parameters: - - *368 - - *369 - - *562 + - *370 + - *371 + - *564 - *17 - *19 responses: @@ -85702,8 +86288,6 @@ paths: description: Timeline Event type: object anyOf: - - *567 - - *568 - *569 - *570 - *571 @@ -85715,6 +86299,8 @@ paths: - *577 - *578 - *579 + - *580 + - *581 - title: Timeline Comment Event description: Timeline Comment Event type: object @@ -85762,12 +86348,12 @@ paths: issue_url: type: string format: uri - author_association: *138 + author_association: *141 performed_via_github_app: anyOf: - type: 'null' - *5 - reactions: *139 + reactions: *142 required: - event - actor @@ -85798,7 +86384,7 @@ paths: properties: type: type: string - issue: *151 + issue: *154 required: - event - created_at @@ -86015,7 +86601,7 @@ paths: type: string body_text: type: string - author_association: *138 + author_association: *141 required: - event - id @@ -86038,7 +86624,7 @@ paths: type: string comments: type: array - items: &599 + items: &601 title: Pull Request Review Comment description: Pull Request Review Comments are comments on a portion of the Pull Request's diff. @@ -86143,7 +86729,7 @@ paths: format: uri examples: - https://api.github.com/repos/octocat/Hello-World/pulls/1 - author_association: *138 + author_association: *141 _links: type: object properties: @@ -86238,7 +86824,7 @@ paths: enum: - line - file - reactions: *139 + reactions: *142 body_html: type: string examples: @@ -86276,7 +86862,7 @@ paths: type: string comments: type: array - items: *485 + items: *487 - title: Timeline Assigned Issue Event description: Timeline Assigned Issue Event type: object @@ -86551,7 +87137,7 @@ paths: headers: Link: *38 '404': *6 - '410': *379 + '410': *381 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -86568,8 +87154,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deploy-keys/deploy-keys#list-deploy-keys parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -86579,7 +87165,7 @@ paths: application/json: schema: type: array - items: &580 + items: &582 title: Deploy Key description: An SSH key granting access to a single repository. type: object @@ -86646,8 +87232,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deploy-keys/deploy-keys#create-a-deploy-key parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -86683,9 +87269,9 @@ paths: description: Response content: application/json: - schema: *580 + schema: *582 examples: - default: &581 + default: &583 value: id: 1 key: ssh-rsa AAA... @@ -86719,9 +87305,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deploy-keys/deploy-keys#get-a-deploy-key parameters: - - *368 - - *369 - - &582 + - *370 + - *371 + - &584 name: key_id description: The unique identifier of the key. in: path @@ -86733,9 +87319,9 @@ paths: description: Response content: application/json: - schema: *580 + schema: *582 examples: - default: *581 + default: *583 '404': *6 x-github: githubCloudOnly: false @@ -86753,9 +87339,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deploy-keys/deploy-keys#delete-a-deploy-key parameters: - - *368 - - *369 - - *582 + - *370 + - *371 + - *584 responses: '204': description: Response @@ -86775,8 +87361,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#list-labels-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -86786,9 +87372,9 @@ paths: application/json: schema: type: array - items: *564 + items: *566 examples: - default: *565 + default: *567 headers: Link: *38 '404': *6 @@ -86809,8 +87395,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#create-a-label parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -86846,9 +87432,9 @@ paths: description: Response content: application/json: - schema: *564 + schema: *566 examples: - default: &583 + default: &585 value: id: 208045946 node_id: MDU6TGFiZWwyMDgwNDU5NDY= @@ -86880,8 +87466,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#get-a-label parameters: - - *368 - - *369 + - *370 + - *371 - name: name in: path required: true @@ -86892,9 +87478,9 @@ paths: description: Response content: application/json: - schema: *564 + schema: *566 examples: - default: *583 + default: *585 '404': *6 x-github: githubCloudOnly: false @@ -86911,8 +87497,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#update-a-label parameters: - - *368 - - *369 + - *370 + - *371 - name: name in: path required: true @@ -86951,7 +87537,7 @@ paths: description: Response content: application/json: - schema: *564 + schema: *566 examples: default: value: @@ -86977,8 +87563,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#delete-a-label parameters: - - *368 - - *369 + - *370 + - *371 - name: name in: path required: true @@ -87004,8 +87590,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#list-repository-languages parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -87041,8 +87627,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/lfs#enable-git-lfs-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '202': *37 '403': @@ -87070,8 +87656,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/lfs#disable-git-lfs-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response @@ -87097,9 +87683,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/licenses/licenses#get-the-license-for-a-repository parameters: - - *368 - - *369 - - *463 + - *370 + - *371 + - *465 responses: '200': description: Response @@ -87165,7 +87751,7 @@ paths: license: anyOf: - type: 'null' - - *152 + - *155 required: - _links - git_url @@ -87246,8 +87832,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branches#sync-a-fork-branch-with-the-upstream-repository parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -87312,8 +87898,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branches#merge-a-branch parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -87347,9 +87933,9 @@ paths: description: Successful Response (The resulting merge commit) content: application/json: - schema: *486 + schema: *488 examples: - default: *584 + default: *586 '204': description: Response when already merged '404': @@ -87374,8 +87960,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/milestones#list-milestones parameters: - - *368 - - *369 + - *370 + - *371 - name: state description: The state of the milestone. Either `open`, `closed`, or `all`. in: query @@ -87416,7 +88002,7 @@ paths: application/json: schema: type: array - items: *490 + items: *492 examples: default: value: @@ -87472,8 +88058,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/milestones#create-a-milestone parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -87513,9 +88099,9 @@ paths: description: Response content: application/json: - schema: *490 + schema: *492 examples: - default: &585 + default: &587 value: url: https://api.github.com/repos/octocat/Hello-World/milestones/1 html_url: https://github.com/octocat/Hello-World/milestones/v1.0 @@ -87574,9 +88160,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/milestones#get-a-milestone parameters: - - *368 - - *369 - - &586 + - *370 + - *371 + - &588 name: milestone_number description: The number that identifies the milestone. in: path @@ -87588,9 +88174,9 @@ paths: description: Response content: application/json: - schema: *490 + schema: *492 examples: - default: *585 + default: *587 '404': *6 x-github: githubCloudOnly: false @@ -87607,9 +88193,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/milestones#update-a-milestone parameters: - - *368 - - *369 - - *586 + - *370 + - *371 + - *588 requestBody: required: false content: @@ -87647,9 +88233,9 @@ paths: description: Response content: application/json: - schema: *490 + schema: *492 examples: - default: *585 + default: *587 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -87665,9 +88251,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/milestones#delete-a-milestone parameters: - - *368 - - *369 - - *586 + - *370 + - *371 + - *588 responses: '204': description: Response @@ -87688,9 +88274,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#list-labels-for-issues-in-a-milestone parameters: - - *368 - - *369 - - *586 + - *370 + - *371 + - *588 - *17 - *19 responses: @@ -87700,9 +88286,9 @@ paths: application/json: schema: type: array - items: *564 + items: *566 examples: - default: *565 + default: *567 headers: Link: *38 x-github: @@ -87721,12 +88307,12 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/notifications#list-repository-notifications-for-the-authenticated-user parameters: - - *368 - - *369 - - *587 - - *588 - - *141 + - *370 + - *371 - *589 + - *590 + - *144 + - *591 - *17 - *19 responses: @@ -87736,9 +88322,9 @@ paths: application/json: schema: type: array - items: *163 + items: *166 examples: - default: *590 + default: *592 headers: Link: *38 x-github: @@ -87762,8 +88348,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/notifications#mark-repository-notifications-as-read parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: false content: @@ -87821,14 +88407,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#get-a-apiname-pages-site parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response content: application/json: - schema: &591 + schema: &593 title: GitHub Pages description: The configuration for GitHub Pages for a repository. type: object @@ -87972,7 +88558,7 @@ paths: - custom_404 - public examples: - default: &592 + default: &594 value: url: https://api.github.com/repos/github/developer.github.com/pages status: built @@ -88013,8 +88599,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#create-a-apiname-pages-site parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -88069,11 +88655,11 @@ paths: description: Response content: application/json: - schema: *591 + schema: *593 examples: - default: *592 + default: *594 '422': *15 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -88094,8 +88680,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#update-information-about-a-apiname-pages-site parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -88182,7 +88768,7 @@ paths: description: Response '422': *15 '400': *14 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -88203,14 +88789,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#delete-a-apiname-pages-site parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response '422': *15 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -88230,8 +88816,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#list-apiname-pages-builds parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -88241,7 +88827,7 @@ paths: application/json: schema: type: array - items: &593 + items: &595 title: Page Build description: Page Build type: object @@ -88333,8 +88919,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#request-a-apiname-pages-build parameters: - - *368 - - *369 + - *370 + - *371 responses: '201': description: Response @@ -88381,16 +88967,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#get-latest-pages-build parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response content: application/json: - schema: *593 + schema: *595 examples: - default: &594 + default: &596 value: url: https://api.github.com/repos/github/developer.github.com/pages/builds/5472601 status: built @@ -88438,8 +89024,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#get-apiname-pages-build parameters: - - *368 - - *369 + - *370 + - *371 - name: build_id in: path required: true @@ -88450,9 +89036,9 @@ paths: description: Response content: application/json: - schema: *593 + schema: *595 examples: - default: *594 + default: *596 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -88472,8 +89058,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#create-a-github-pages-deployment parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -88581,9 +89167,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#get-the-status-of-a-github-pages-deployment parameters: - - *368 - - *369 - - &595 + - *370 + - *371 + - &597 name: pages_deployment_id description: The ID of the Pages deployment. You can also give the commit SHA of the deployment. @@ -88641,11 +89227,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#cancel-a-github-pages-deployment parameters: - - *368 - - *369 - - *595 + - *370 + - *371 + - *597 responses: - '204': *116 + '204': *119 '404': *6 x-github: githubCloudOnly: false @@ -88670,8 +89256,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#get-a-dns-health-check-for-github-pages parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -88939,7 +89525,7 @@ paths: description: Empty response content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -88966,8 +89552,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#check-if-private-vulnerability-reporting-is-enabled-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Private vulnerability reporting status @@ -89004,10 +89590,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#enable-private-vulnerability-reporting-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: - '204': *116 + '204': *119 '422': *14 x-github: githubCloudOnly: false @@ -89026,10 +89612,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#disable-private-vulnerability-reporting-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: - '204': *116 + '204': *119 '422': *14 x-github: githubCloudOnly: false @@ -89050,8 +89636,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/projects#list-repository-projects parameters: - - *368 - - *369 + - *370 + - *371 - name: state description: Indicates the state of the projects to return. in: query @@ -89072,7 +89658,7 @@ paths: application/json: schema: type: array - items: *315 + items: *317 examples: default: value: @@ -89112,7 +89698,7 @@ paths: '401': *23 '403': *27 '404': *6 - '410': *379 + '410': *381 '422': *7 x-github: githubCloudOnly: false @@ -89135,8 +89721,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/projects#create-a-repository-project parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -89162,13 +89748,13 @@ paths: description: Response content: application/json: - schema: *315 + schema: *317 examples: - default: *378 + default: *380 '401': *23 '403': *27 '404': *6 - '410': *379 + '410': *381 '422': *7 x-github: githubCloudOnly: false @@ -89191,8 +89777,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/custom-properties#get-all-custom-property-values-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -89200,7 +89786,7 @@ paths: application/json: schema: type: array - items: *317 + items: *319 examples: default: value: @@ -89231,8 +89817,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/custom-properties#create-or-update-custom-property-values-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -89244,7 +89830,7 @@ paths: type: array description: A list of custom property names and associated values to apply to the repositories. - items: *317 + items: *319 required: - properties examples: @@ -89294,8 +89880,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#list-pull-requests parameters: - - *368 - - *369 + - *370 + - *371 - name: state description: Either `open`, `closed`, or `all` to filter by state. in: query @@ -89355,9 +89941,9 @@ paths: application/json: schema: type: array - items: *596 + items: *598 examples: - default: *597 + default: *599 headers: Link: *38 '304': *35 @@ -89389,8 +89975,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#create-a-pull-request parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -89457,7 +90043,7 @@ paths: description: Response content: application/json: - schema: &601 + schema: &603 type: object title: Pull Request description: Pull requests let you tell others about changes you've @@ -89586,7 +90172,7 @@ paths: milestone: anyOf: - type: 'null' - - *490 + - *492 active_lock_reason: type: - string @@ -89641,7 +90227,7 @@ paths: type: - array - 'null' - items: *297 + items: *299 head: type: object properties: @@ -89679,14 +90265,14 @@ paths: _links: type: object properties: - comments: *491 - commits: *491 - statuses: *491 - html: *491 - issue: *491 - review_comments: *491 - review_comment: *491 - self: *491 + comments: *493 + commits: *493 + statuses: *493 + html: *493 + issue: *493 + review_comments: *493 + review_comment: *493 + self: *493 required: - comments - commits @@ -89696,8 +90282,8 @@ paths: - review_comments - review_comment - self - author_association: *138 - auto_merge: *598 + author_association: *141 + auto_merge: *600 draft: description: Indicates whether or not the pull request is a draft. type: boolean @@ -89799,7 +90385,7 @@ paths: - merged_by - review_comments examples: - default: &602 + default: &604 value: url: https://api.github.com/repos/octocat/Hello-World/pulls/1347 id: 1 @@ -90326,8 +90912,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/comments#list-review-comments-in-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - name: sort in: query required: false @@ -90346,7 +90932,7 @@ paths: enum: - asc - desc - - *141 + - *144 - *17 - *19 responses: @@ -90356,9 +90942,9 @@ paths: application/json: schema: type: array - items: *599 + items: *601 examples: - default: &604 + default: &606 value: - url: https://api.github.com/repos/octocat/Hello-World/pulls/comments/1 pull_request_review_id: 42 @@ -90435,17 +91021,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/comments#get-a-review-comment-for-a-pull-request parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 responses: '200': description: Response content: application/json: - schema: *599 + schema: *601 examples: - default: &600 + default: &602 value: url: https://api.github.com/repos/octocat/Hello-World/pulls/comments/1 pull_request_review_id: 42 @@ -90520,9 +91106,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/comments#update-a-review-comment-for-a-pull-request parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 requestBody: required: true content: @@ -90544,9 +91130,9 @@ paths: description: Response content: application/json: - schema: *599 + schema: *601 examples: - default: *600 + default: *602 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -90562,9 +91148,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/comments#delete-a-review-comment-for-a-pull-request parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 responses: '204': description: Response @@ -90585,9 +91171,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#list-reactions-for-a-pull-request-review-comment parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 - name: content description: Returns a single [reaction type](https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to a pull request review comment. @@ -90613,9 +91199,9 @@ paths: application/json: schema: type: array - items: *357 + items: *359 examples: - default: *359 + default: *361 headers: Link: *38 '404': *6 @@ -90636,9 +91222,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#create-reaction-for-a-pull-request-review-comment parameters: - - *368 - - *369 - - *150 + - *370 + - *371 + - *153 requestBody: required: true content: @@ -90670,16 +91256,16 @@ paths: description: Reaction exists content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 '201': description: Reaction created content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 '422': *15 x-github: githubCloudOnly: false @@ -90701,10 +91287,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#delete-a-pull-request-comment-reaction parameters: - - *368 - - *369 - - *150 - - *360 + - *370 + - *371 + - *153 + - *362 responses: '204': description: Response @@ -90747,9 +91333,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#get-a-pull-request parameters: - - *368 - - *369 - - &603 + - *370 + - *371 + - &605 name: pull_number description: The number that identifies the pull request. in: path @@ -90762,9 +91348,9 @@ paths: to fetch diff and patch formats. content: application/json: - schema: *601 + schema: *603 examples: - default: *602 + default: *604 '304': *35 '404': *6 '406': @@ -90772,8 +91358,8 @@ paths: content: application/json: schema: *3 - '500': *83 - '503': *130 + '500': *86 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -90799,9 +91385,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#update-a-pull-request parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 requestBody: required: false content: @@ -90843,9 +91429,9 @@ paths: description: Response content: application/json: - schema: *601 + schema: *603 examples: - default: *602 + default: *604 '422': *15 '403': *27 x-github: @@ -90867,9 +91453,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#create-a-codespace-from-a-pull-request parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 requestBody: required: true content: @@ -90930,21 +91516,21 @@ paths: description: Response when the codespace was successfully created content: application/json: - schema: *288 + schema: *290 examples: - default: *477 + default: *479 '202': description: Response when the codespace creation partially failed but is being retried in the background content: application/json: - schema: *288 + schema: *290 examples: - default: *477 + default: *479 '401': *23 '403': *27 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -90970,10 +91556,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/comments#list-review-comments-on-a-pull-request parameters: - - *368 - - *369 - - *603 - - *160 + - *370 + - *371 + - *605 + - *163 - name: direction description: The direction to sort results. Ignored without `sort` parameter. in: query @@ -90983,7 +91569,7 @@ paths: enum: - asc - desc - - *141 + - *144 - *17 - *19 responses: @@ -90993,9 +91579,9 @@ paths: application/json: schema: type: array - items: *599 + items: *601 examples: - default: *604 + default: *606 headers: Link: *38 x-github: @@ -91028,9 +91614,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/comments#create-a-review-comment-for-a-pull-request parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 requestBody: required: true content: @@ -91136,7 +91722,7 @@ paths: description: Response content: application/json: - schema: *599 + schema: *601 examples: example-for-a-multi-line-comment: value: @@ -91224,10 +91810,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/comments#create-a-reply-for-a-review-comment parameters: - - *368 - - *369 - - *603 - - *150 + - *370 + - *371 + - *605 + - *153 requestBody: required: true content: @@ -91249,7 +91835,7 @@ paths: description: Response content: application/json: - schema: *599 + schema: *601 examples: default: value: @@ -91335,9 +91921,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#list-commits-on-a-pull-request parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 - *17 - *19 responses: @@ -91347,9 +91933,9 @@ paths: application/json: schema: type: array - items: *486 + items: *488 examples: - default: *605 + default: *607 headers: Link: *38 x-github: @@ -91379,9 +91965,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#list-pull-requests-files parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 - *17 - *19 responses: @@ -91391,7 +91977,7 @@ paths: application/json: schema: type: array - items: *498 + items: *500 examples: default: value: @@ -91409,8 +91995,8 @@ paths: headers: Link: *38 '422': *15 - '500': *83 - '503': *130 + '500': *86 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -91429,9 +92015,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#check-if-a-pull-request-has-been-merged parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 responses: '204': description: Response if pull request has been merged @@ -91454,9 +92040,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#merge-a-pull-request parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 requestBody: required: false content: @@ -91568,9 +92154,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/review-requests#get-all-requested-reviewers-for-a-pull-request parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 responses: '200': description: Response @@ -91586,7 +92172,7 @@ paths: items: *4 teams: type: array - items: *224 + items: *226 required: - users - teams @@ -91645,9 +92231,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/review-requests#request-reviewers-for-a-pull-request parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 requestBody: required: false content: @@ -91684,7 +92270,7 @@ paths: description: Response content: application/json: - schema: *596 + schema: *598 examples: default: value: @@ -92220,9 +92806,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/review-requests#remove-requested-reviewers-from-a-pull-request parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 requestBody: required: true content: @@ -92256,7 +92842,7 @@ paths: description: Response content: application/json: - schema: *596 + schema: *598 examples: default: value: @@ -92761,9 +93347,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#list-reviews-for-a-pull-request parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 - *17 - *19 responses: @@ -92773,7 +93359,7 @@ paths: application/json: schema: type: array - items: &606 + items: &608 title: Pull Request Review description: Pull Request Reviews are reviews on pull requests. type: object @@ -92847,7 +93433,7 @@ paths: type: string body_text: type: string - author_association: *138 + author_association: *141 required: - id - node_id @@ -92929,9 +93515,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#create-a-review-for-a-pull-request parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 requestBody: required: false content: @@ -93021,9 +93607,9 @@ paths: description: Response content: application/json: - schema: *606 + schema: *608 examples: - default: &608 + default: &610 value: id: 80 node_id: MDE3OlB1bGxSZXF1ZXN0UmV2aWV3ODA= @@ -93086,10 +93672,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#get-a-review-for-a-pull-request parameters: - - *368 - - *369 - - *603 - - &607 + - *370 + - *371 + - *605 + - &609 name: review_id description: The unique identifier of the review. in: path @@ -93101,9 +93687,9 @@ paths: description: Response content: application/json: - schema: *606 + schema: *608 examples: - default: &609 + default: &611 value: id: 80 node_id: MDE3OlB1bGxSZXF1ZXN0UmV2aWV3ODA= @@ -93162,10 +93748,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#update-a-review-for-a-pull-request parameters: - - *368 - - *369 - - *603 - - *607 + - *370 + - *371 + - *605 + - *609 requestBody: required: true content: @@ -93188,7 +93774,7 @@ paths: description: Response content: application/json: - schema: *606 + schema: *608 examples: default: value: @@ -93250,18 +93836,18 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#delete-a-pending-review-for-a-pull-request parameters: - - *368 - - *369 - - *603 - - *607 + - *370 + - *371 + - *605 + - *609 responses: '200': description: Response content: application/json: - schema: *606 + schema: *608 examples: - default: *608 + default: *610 '422': *7 '404': *6 x-github: @@ -93288,10 +93874,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#list-comments-for-a-pull-request-review parameters: - - *368 - - *369 - - *603 - - *607 + - *370 + - *371 + - *605 + - *609 - *17 - *19 responses: @@ -93385,13 +93971,13 @@ paths: format: uri examples: - https://api.github.com/repos/octocat/Hello-World/pulls/1 - author_association: *138 + author_association: *141 _links: type: object properties: - self: *491 - html: *491 - pull_request: *491 + self: *493 + html: *493 + pull_request: *493 required: - self - html @@ -93400,7 +93986,7 @@ paths: type: string body_html: type: string - reactions: *139 + reactions: *142 side: description: The side of the first line of the range for a multi-line comment. @@ -93549,10 +94135,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#dismiss-a-review-for-a-pull-request parameters: - - *368 - - *369 - - *603 - - *607 + - *370 + - *371 + - *605 + - *609 requestBody: required: true content: @@ -93581,7 +94167,7 @@ paths: description: Response content: application/json: - schema: *606 + schema: *608 examples: default: value: @@ -93644,10 +94230,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#submit-a-review-for-a-pull-request parameters: - - *368 - - *369 - - *603 - - *607 + - *370 + - *371 + - *605 + - *609 requestBody: required: true content: @@ -93682,9 +94268,9 @@ paths: description: Response content: application/json: - schema: *606 + schema: *608 examples: - default: *609 + default: *611 '404': *6 '422': *7 '403': *27 @@ -93706,9 +94292,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#update-a-pull-request-branch parameters: - - *368 - - *369 - - *603 + - *370 + - *371 + - *605 requestBody: required: false content: @@ -93772,8 +94358,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/contents#get-a-repository-readme parameters: - - *368 - - *369 + - *370 + - *371 - name: ref description: 'The name of the commit/branch/tag. Default: the repository’s default branch.' @@ -93786,9 +94372,9 @@ paths: description: Response content: application/json: - schema: *610 + schema: *612 examples: - default: &611 + default: &613 value: type: file encoding: base64 @@ -93830,8 +94416,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/contents#get-a-repository-readme-for-a-directory parameters: - - *368 - - *369 + - *370 + - *371 - name: dir description: The alternate path to look for a README file in: path @@ -93851,9 +94437,9 @@ paths: description: Response content: application/json: - schema: *610 + schema: *612 examples: - default: *611 + default: *613 '404': *6 '422': *15 x-github: @@ -93875,8 +94461,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/releases#list-releases parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -93886,7 +94472,7 @@ paths: application/json: schema: type: array - items: &612 + items: &614 title: Release description: A release. type: object @@ -93958,7 +94544,7 @@ paths: author: *4 assets: type: array - items: &613 + items: &615 title: Release Asset description: Data related to a release. type: object @@ -94033,7 +94619,7 @@ paths: description: The URL of the release discussion. type: string format: uri - reactions: *139 + reactions: *142 required: - assets_url - upload_url @@ -94144,8 +94730,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/releases#create-a-release parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -94221,9 +94807,9 @@ paths: description: Response content: application/json: - schema: *612 + schema: *614 examples: - default: &616 + default: &618 value: url: https://api.github.com/repos/octocat/Hello-World/releases/1 html_url: https://github.com/octocat/Hello-World/releases/v1.0.0 @@ -94327,9 +94913,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/assets#get-a-release-asset parameters: - - *368 - - *369 - - &614 + - *370 + - *371 + - &616 name: asset_id description: The unique identifier of the asset. in: path @@ -94341,9 +94927,9 @@ paths: description: Response content: application/json: - schema: *613 + schema: *615 examples: - default: &615 + default: &617 value: url: https://api.github.com/repos/octocat/Hello-World/releases/assets/1 browser_download_url: https://github.com/octocat/Hello-World/releases/download/v1.0.0/example.zip @@ -94378,7 +94964,7 @@ paths: type: User site_admin: false '404': *6 - '302': *500 + '302': *502 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -94394,9 +94980,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/assets#update-a-release-asset parameters: - - *368 - - *369 - - *614 + - *370 + - *371 + - *616 requestBody: required: false content: @@ -94425,9 +95011,9 @@ paths: description: Response content: application/json: - schema: *613 + schema: *615 examples: - default: *615 + default: *617 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -94443,9 +95029,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/assets#delete-a-release-asset parameters: - - *368 - - *369 - - *614 + - *370 + - *371 + - *616 responses: '204': description: Response @@ -94469,8 +95055,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/releases#generate-release-notes-content-for-a-release parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -94556,16 +95142,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/releases#get-the-latest-release parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response content: application/json: - schema: *612 + schema: *614 examples: - default: *616 + default: *618 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -94582,8 +95168,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/releases#get-a-release-by-tag-name parameters: - - *368 - - *369 + - *370 + - *371 - name: tag description: tag parameter in: path @@ -94596,9 +95182,9 @@ paths: description: Response content: application/json: - schema: *612 + schema: *614 examples: - default: *616 + default: *618 '404': *6 x-github: githubCloudOnly: false @@ -94620,9 +95206,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/releases#get-a-release parameters: - - *368 - - *369 - - &617 + - *370 + - *371 + - &619 name: release_id description: The unique identifier of the release. in: path @@ -94636,9 +95222,9 @@ paths: For more information, see "[Getting started with the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/getting-started-with-the-rest-api#hypermedia)."' content: application/json: - schema: *612 + schema: *614 examples: - default: *616 + default: *618 '401': description: Unauthorized x-github: @@ -94656,9 +95242,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/releases#update-a-release parameters: - - *368 - - *369 - - *617 + - *370 + - *371 + - *619 requestBody: required: false content: @@ -94722,9 +95308,9 @@ paths: description: Response content: application/json: - schema: *612 + schema: *614 examples: - default: *616 + default: *618 '404': description: Not Found if the discussion category name is invalid content: @@ -94745,9 +95331,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/releases#delete-a-release parameters: - - *368 - - *369 - - *617 + - *370 + - *371 + - *619 responses: '204': description: Response @@ -94767,9 +95353,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/assets#list-release-assets parameters: - - *368 - - *369 - - *617 + - *370 + - *371 + - *619 - *17 - *19 responses: @@ -94779,7 +95365,7 @@ paths: application/json: schema: type: array - items: *613 + items: *615 examples: default: value: @@ -94861,9 +95447,9 @@ paths: description: The URL origin (protocol + host name + port) is included in `upload_url` returned in the response of the "Create a release" endpoint parameters: - - *368 - - *369 - - *617 + - *370 + - *371 + - *619 - name: name in: query required: true @@ -94889,7 +95475,7 @@ paths: description: Response for successful upload content: application/json: - schema: *613 + schema: *615 examples: response-for-successful-upload: value: @@ -94944,9 +95530,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#list-reactions-for-a-release parameters: - - *368 - - *369 - - *617 + - *370 + - *371 + - *619 - name: content description: Returns a single [reaction type](https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to a release. @@ -94970,9 +95556,9 @@ paths: application/json: schema: type: array - items: *357 + items: *359 examples: - default: *359 + default: *361 headers: Link: *38 '404': *6 @@ -94993,9 +95579,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#create-reaction-for-a-release parameters: - - *368 - - *369 - - *617 + - *370 + - *371 + - *619 requestBody: required: true content: @@ -95025,16 +95611,16 @@ paths: description: Reaction exists content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 '201': description: Reaction created content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 '422': *15 x-github: githubCloudOnly: false @@ -95056,10 +95642,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#delete-a-release-reaction parameters: - - *368 - - *369 - - *617 - - *360 + - *370 + - *371 + - *619 + - *362 responses: '204': description: Response @@ -95083,9 +95669,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/rules#get-rules-for-a-branch parameters: - - *368 - - *369 - - *427 + - *370 + - *371 + - *429 - *17 - *19 responses: @@ -95101,8 +95687,8 @@ paths: description: A repository rule with ruleset details. oneOf: - allOf: - - *618 - - &620 + - *620 + - &622 title: repository ruleset data for rule description: User-defined metadata to store domain-specific information limited to 8 keys with scalar values. @@ -95121,66 +95707,66 @@ paths: ruleset_id: type: integer description: The ID of the ruleset that includes this rule. - - allOf: - - *619 - - *620 - allOf: - *621 - - *620 - - allOf: - *622 - - *620 - allOf: - *623 - - *620 + - *622 - allOf: - *624 - - *620 + - *622 - allOf: - *625 - - *620 + - *622 - allOf: - *626 - - *620 + - *622 - allOf: - *627 - - *620 + - *622 - allOf: - *628 - - *620 + - *622 - allOf: - *629 - - *620 + - *622 - allOf: - *630 - - *620 + - *622 - allOf: - *631 - - *620 + - *622 - allOf: - *632 - - *620 + - *622 - allOf: - *633 - - *620 + - *622 - allOf: - *634 - - *620 + - *622 - allOf: - *635 - - *620 + - *622 - allOf: - *636 - - *620 + - *622 - allOf: - *637 - - *620 + - *622 - allOf: - *638 - - *620 + - *622 - allOf: - *639 - - *620 + - *622 + - allOf: + - *640 + - *622 + - allOf: + - *641 + - *622 examples: default: value: @@ -95219,8 +95805,8 @@ paths: category: repos subcategory: rules parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 - name: includes_parents @@ -95231,7 +95817,7 @@ paths: schema: type: boolean default: true - - *640 + - *642 responses: '200': description: Response @@ -95239,7 +95825,7 @@ paths: application/json: schema: type: array - items: *126 + items: *129 examples: default: value: @@ -95270,7 +95856,7 @@ paths: created_at: '2023-08-15T08:43:03Z' updated_at: '2023-09-23T16:29:47Z' '404': *6 - '500': *83 + '500': *86 post: summary: Create a repository ruleset description: Create a ruleset for a repository. @@ -95286,8 +95872,8 @@ paths: category: repos subcategory: rules parameters: - - *368 - - *369 + - *370 + - *371 requestBody: description: Request body required: true @@ -95307,16 +95893,16 @@ paths: - tag - push default: branch - enforcement: *123 + enforcement: *126 bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: *124 - conditions: *119 + items: *127 + conditions: *122 rules: type: array description: An array of rules within the ruleset. - items: *125 + items: *128 required: - name - enforcement @@ -95347,9 +95933,9 @@ paths: description: Response content: application/json: - schema: *126 + schema: *129 examples: - default: &649 + default: &651 value: id: 42 name: super cool ruleset @@ -95382,7 +95968,7 @@ paths: created_at: '2023-07-15T08:43:03Z' updated_at: '2023-08-23T16:29:47Z' '404': *6 - '500': *83 + '500': *86 "/repos/{owner}/{repo}/rulesets/rule-suites": get: summary: List repository rule suites @@ -95396,12 +95982,12 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/rule-suites#list-repository-rule-suites parameters: - - *368 - - *369 - - *641 - - *218 - - *642 + - *370 + - *371 - *643 + - *220 + - *644 + - *645 - *17 - *19 responses: @@ -95409,11 +95995,11 @@ paths: description: Response content: application/json: - schema: *644 + schema: *646 examples: - default: *645 + default: *647 '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -95432,19 +96018,19 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/rule-suites#get-a-repository-rule-suite parameters: - - *368 - - *369 - - *646 + - *370 + - *371 + - *648 responses: '200': description: Response content: application/json: - schema: *647 + schema: *649 examples: - default: *648 + default: *650 '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -95470,8 +96056,8 @@ paths: category: repos subcategory: rules parameters: - - *368 - - *369 + - *370 + - *371 - name: ruleset_id description: The ID of the ruleset. in: path @@ -95491,11 +96077,11 @@ paths: description: Response content: application/json: - schema: *126 + schema: *129 examples: - default: *649 + default: *651 '404': *6 - '500': *83 + '500': *86 put: summary: Update a repository ruleset description: Update a ruleset for a repository. @@ -95511,8 +96097,8 @@ paths: category: repos subcategory: rules parameters: - - *368 - - *369 + - *370 + - *371 - name: ruleset_id description: The ID of the ruleset. in: path @@ -95537,16 +96123,16 @@ paths: - branch - tag - push - enforcement: *123 + enforcement: *126 bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: *124 - conditions: *119 + items: *127 + conditions: *122 rules: description: An array of rules within the ruleset. type: array - items: *125 + items: *128 examples: default: value: @@ -95574,11 +96160,11 @@ paths: description: Response content: application/json: - schema: *126 + schema: *129 examples: - default: *649 + default: *651 '404': *6 - '500': *83 + '500': *86 delete: summary: Delete a repository ruleset description: Delete a ruleset for a repository. @@ -95594,8 +96180,8 @@ paths: category: repos subcategory: rules parameters: - - *368 - - *369 + - *370 + - *371 - name: ruleset_id description: The ID of the ruleset. in: path @@ -95606,7 +96192,7 @@ paths: '204': description: Response '404': *6 - '500': *83 + '500': *86 "/repos/{owner}/{repo}/rulesets/{ruleset_id}/history": get: summary: Get repository ruleset history @@ -95618,8 +96204,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/rules#get-repository-ruleset-history parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 - name: ruleset_id @@ -95635,11 +96221,11 @@ paths: application/json: schema: type: array - items: *129 + items: *132 examples: - default: *323 + default: *325 '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -95656,8 +96242,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/rules#get-repository-ruleset-version parameters: - - *368 - - *369 + - *370 + - *371 - name: ruleset_id description: The ID of the ruleset. in: path @@ -95675,7 +96261,7 @@ paths: description: Response content: application/json: - schema: *324 + schema: *326 examples: default: value: @@ -95708,7 +96294,7 @@ paths: operator: contains pattern: github '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -95730,21 +96316,21 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/secret-scanning/secret-scanning#list-secret-scanning-alerts-for-a-repository parameters: - - *368 - - *369 - - *325 - - *326 + - *370 + - *371 - *327 - *328 - - *86 - - *19 - - *17 - - *650 - - *651 - *329 - *330 + - *89 + - *19 + - *17 + - *652 + - *653 - *331 - *332 + - *333 + - *334 responses: '200': description: Response @@ -95752,24 +96338,24 @@ paths: application/json: schema: type: array - items: &655 + items: &657 type: object properties: - number: *96 - created_at: *103 + number: *99 + created_at: *106 updated_at: anyOf: - type: 'null' - - *104 - url: *101 - html_url: *102 + - *107 + url: *104 + html_url: *105 locations_url: type: string format: uri description: The REST API URL of the code locations for this alert. - state: *652 - resolution: *653 + state: *654 + resolution: *655 resolved_at: type: - string @@ -95863,7 +96449,7 @@ paths: first_location_detected: anyOf: - type: 'null' - - *654 + - *656 has_more_locations: type: boolean description: A boolean value representing whether or not the @@ -95990,7 +96576,7 @@ paths: '404': description: Repository is public or secret scanning is disabled for the repository - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -96012,16 +96598,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/secret-scanning/secret-scanning#get-a-secret-scanning-alert parameters: - - *368 - - *369 - - *457 - - *332 + - *370 + - *371 + - *459 + - *334 responses: '200': description: Response content: application/json: - schema: *655 + schema: *657 examples: default: value: @@ -96052,7 +96638,7 @@ paths: '404': description: Repository is public, or secret scanning is disabled for the repository, or the resource is not found - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -96073,9 +96659,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/secret-scanning/secret-scanning#update-a-secret-scanning-alert parameters: - - *368 - - *369 - - *457 + - *370 + - *371 + - *459 requestBody: required: true content: @@ -96083,8 +96669,8 @@ paths: schema: type: object properties: - state: *652 - resolution: *653 + state: *654 + resolution: *655 resolution_comment: description: An optional comment when closing or reopening an alert. Cannot be updated or deleted. @@ -96103,7 +96689,7 @@ paths: description: Response content: application/json: - schema: *655 + schema: *657 examples: default: value: @@ -96156,7 +96742,7 @@ paths: repository, or the resource is not found '422': description: State does not match the resolution or resolution comment - '503': *130 + '503': *133 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -96178,9 +96764,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/secret-scanning/secret-scanning#list-locations-for-a-secret-scanning-alert parameters: - - *368 - - *369 - - *457 + - *370 + - *371 + - *459 - *19 - *17 responses: @@ -96191,7 +96777,7 @@ paths: schema: type: array description: List of locations where the secret was detected - items: &827 + items: &829 type: object properties: type: @@ -96218,8 +96804,6 @@ paths: - commit details: oneOf: - - *656 - - *657 - *658 - *659 - *660 @@ -96231,6 +96815,8 @@ paths: - *666 - *667 - *668 + - *669 + - *670 examples: default: value: @@ -96294,7 +96880,7 @@ paths: '404': description: Repository is public, or secret scanning is disabled for the repository, or the resource is not found - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -96316,8 +96902,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/secret-scanning/secret-scanning#create-a-push-protection-bypass parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -96325,14 +96911,14 @@ paths: schema: type: object properties: - reason: &670 + reason: &672 description: The reason for bypassing push protection. type: string enum: - false_positive - used_in_tests - will_fix_later - placeholder_id: *669 + placeholder_id: *671 required: - reason - placeholder_id @@ -96349,7 +96935,7 @@ paths: schema: type: object properties: - reason: *670 + reason: *672 expire_at: type: - string @@ -96373,7 +96959,7 @@ paths: this repository. '422': description: Bad request, input data missing or incorrect. - '503': *130 + '503': *133 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -96393,13 +96979,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/secret-scanning/secret-scanning#get-secret-scanning-scan-history-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '404': description: Repository does not have GitHub Advanced Security or secret scanning enabled - '503': *130 + '503': *133 '200': description: Response content: @@ -96409,7 +96995,7 @@ paths: properties: incremental_scans: type: array - items: &671 + items: &673 description: Information on a single scan performed by secret scanning on the repository type: object @@ -96437,15 +97023,15 @@ paths: the scan is pending pattern_update_scans: type: array - items: *671 + items: *673 backfill_scans: type: array - items: *671 + items: *673 custom_pattern_backfill_scans: type: array items: allOf: - - *671 + - *673 - type: object properties: pattern_name: @@ -96515,9 +97101,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/repository-advisories#list-repository-security-advisories parameters: - - *368 - - *369 - - *86 + - *370 + - *371 + - *89 - name: sort description: The property to sort the results by. in: query @@ -96529,8 +97115,8 @@ paths: - updated - published default: created - - *84 - - *85 + - *87 + - *88 - name: per_page description: The number of advisories to return per page. For more information, see "[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api)." @@ -96560,9 +97146,9 @@ paths: application/json: schema: type: array - items: *672 + items: *674 examples: - default: *673 + default: *675 '400': *14 '404': *6 x-github: @@ -96585,8 +97171,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/repository-advisories#create-a-repository-security-advisory parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -96666,7 +97252,7 @@ paths: login: type: string description: The username of the user credited. - type: *335 + type: *337 required: - login - type @@ -96756,9 +97342,9 @@ paths: description: Response content: application/json: - schema: *672 + schema: *674 examples: - default: &675 + default: &677 value: ghsa_id: GHSA-abcd-1234-efgh cve_id: CVE-2050-00000 @@ -96991,8 +97577,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/repository-advisories#privately-report-a-security-vulnerability parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -97105,7 +97691,7 @@ paths: description: Response content: application/json: - schema: *672 + schema: *674 examples: default: value: @@ -97252,17 +97838,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/repository-advisories#get-a-repository-security-advisory parameters: - - *368 - - *369 - - *674 + - *370 + - *371 + - *676 responses: '200': description: Response content: application/json: - schema: *672 + schema: *674 examples: - default: *675 + default: *677 '403': *27 '404': *6 x-github: @@ -97286,9 +97872,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/repository-advisories#update-a-repository-security-advisory parameters: - - *368 - - *369 - - *674 + - *370 + - *371 + - *676 requestBody: required: true content: @@ -97368,7 +97954,7 @@ paths: login: type: string description: The username of the user credited. - type: *335 + type: *337 required: - login - type @@ -97459,17 +98045,17 @@ paths: description: Response content: application/json: - schema: *672 + schema: *674 examples: - default: *675 - add_credit: *675 + default: *677 + add_credit: *677 '403': *27 '404': *6 '422': description: Validation failed, or the endpoint has been spammed. content: application/json: - schema: *176 + schema: *178 examples: invalid_state_transition: value: @@ -97500,9 +98086,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/repository-advisories#request-a-cve-for-a-repository-security-advisory parameters: - - *368 - - *369 - - *674 + - *370 + - *371 + - *676 responses: '202': *37 '400': *14 @@ -97529,17 +98115,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/repository-advisories#create-a-temporary-private-fork parameters: - - *368 - - *369 - - *674 + - *370 + - *371 + - *676 responses: '202': description: Response content: application/json: - schema: *381 + schema: *383 examples: - default: *383 + default: *385 '400': *14 '422': *15 '403': *27 @@ -97565,8 +98151,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/starring#list-stargazers parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -97662,8 +98248,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/statistics#get-the-weekly-commit-activity parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Returns a weekly aggregate of the number of additions and deletions @@ -97672,7 +98258,7 @@ paths: application/json: schema: type: array - items: &676 + items: &678 title: Code Frequency Stat description: Code Frequency Stat type: array @@ -97685,7 +98271,7 @@ paths: - 1124 - -435 '202': *37 - '204': *116 + '204': *119 '422': description: Repository contains more than 10,000 commits x-github: @@ -97705,8 +98291,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/statistics#get-the-last-year-of-commit-activity parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -97757,7 +98343,7 @@ paths: total: 89 week: 1336280400 '202': *37 - '204': *116 + '204': *119 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -97784,8 +98370,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/statistics#get-all-contributor-commit-activity parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -97857,7 +98443,7 @@ paths: d: 77 c: 10 '202': *37 - '204': *116 + '204': *119 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -97879,8 +98465,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/statistics#get-the-weekly-commit-count parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: The array order is oldest week (index 0) to most recent week. @@ -98034,8 +98620,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/statistics#get-the-hourly-commit-count-for-each-day parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: For example, `[2, 14, 25]` indicates that there were 25 total @@ -98045,7 +98631,7 @@ paths: application/json: schema: type: array - items: *676 + items: *678 examples: default: value: @@ -98058,7 +98644,7 @@ paths: - - 0 - 2 - 21 - '204': *116 + '204': *119 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -98078,8 +98664,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/statuses#create-a-commit-status parameters: - - *368 - - *369 + - *370 + - *371 - name: sha in: path required: true @@ -98135,7 +98721,7 @@ paths: description: Response content: application/json: - schema: *677 + schema: *679 examples: default: value: @@ -98189,8 +98775,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/watching#list-watchers parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -98202,7 +98788,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: *38 x-github: @@ -98222,14 +98808,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/watching#get-a-repository-subscription parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: if you subscribe to the repository content: application/json: - schema: &678 + schema: &680 title: Repository Invitation description: Repository invitations let you manage who you collaborate with. @@ -98302,8 +98888,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/watching#set-a-repository-subscription parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: false content: @@ -98329,7 +98915,7 @@ paths: description: Response content: application/json: - schema: *678 + schema: *680 examples: default: value: @@ -98356,8 +98942,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/watching#delete-a-repository-subscription parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response @@ -98377,8 +98963,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#list-repository-tags parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -98460,8 +99046,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/tags#closing-down---list-tag-protection-states-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -98469,7 +99055,7 @@ paths: application/json: schema: type: array - items: &679 + items: &681 title: Tag protection description: Tag protection type: object @@ -98526,8 +99112,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/tags#closing-down---create-a-tag-protection-state-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -98550,7 +99136,7 @@ paths: description: Response content: application/json: - schema: *679 + schema: *681 examples: default: value: @@ -98581,8 +99167,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/tags#closing-down---delete-a-tag-protection-state-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 - name: tag_protection_id description: The unique identifier of the tag protection. in: path @@ -98619,8 +99205,8 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/repos/contents#download-a-repository-archive-tar operationId: repos/download-tarball-archive parameters: - - *368 - - *369 + - *370 + - *371 - name: ref in: path required: true @@ -98656,8 +99242,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#list-repository-teams parameters: - - *368 - - *369 + - *370 + - *371 - *17 - *19 responses: @@ -98667,9 +99253,9 @@ paths: application/json: schema: type: array - items: *224 + items: *226 examples: - default: *298 + default: *300 headers: Link: *38 '404': *6 @@ -98689,8 +99275,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#get-all-repository-topics parameters: - - *368 - - *369 + - *370 + - *371 - *19 - *17 responses: @@ -98698,7 +99284,7 @@ paths: description: Response content: application/json: - schema: &680 + schema: &682 title: Topic description: A topic aggregates entities that are related to a subject. type: object @@ -98710,7 +99296,7 @@ paths: required: - names examples: - default: &681 + default: &683 value: names: - octocat @@ -98733,8 +99319,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#replace-all-repository-topics parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -98765,9 +99351,9 @@ paths: description: Response content: application/json: - schema: *680 + schema: *682 examples: - default: *681 + default: *683 '404': *6 '422': *7 x-github: @@ -98788,9 +99374,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/traffic#get-repository-clones parameters: - - *368 - - *369 - - &682 + - *370 + - *371 + - &684 name: per description: The time frame to display results for. in: query @@ -98821,7 +99407,7 @@ paths: - 128 clones: type: array - items: &683 + items: &685 title: Traffic type: object properties: @@ -98908,8 +99494,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/traffic#get-top-referral-paths parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -99003,8 +99589,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/traffic#get-top-referral-sources parameters: - - *368 - - *369 + - *370 + - *371 responses: '200': description: Response @@ -99067,9 +99653,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/traffic#get-page-views parameters: - - *368 - - *369 - - *682 + - *370 + - *371 + - *684 responses: '200': description: Response @@ -99090,7 +99676,7 @@ paths: - 3782 views: type: array - items: *683 + items: *685 required: - uniques - count @@ -99167,8 +99753,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#transfer-a-repository parameters: - - *368 - - *369 + - *370 + - *371 requestBody: required: true content: @@ -99204,7 +99790,7 @@ paths: description: Response content: application/json: - schema: *193 + schema: *195 examples: default: value: @@ -99442,8 +100028,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#check-if-vulnerability-alerts-are-enabled-for-a-repository parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response if repository is enabled with vulnerability alerts @@ -99466,8 +100052,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#enable-vulnerability-alerts parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response @@ -99489,8 +100075,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#disable-vulnerability-alerts parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response @@ -99516,8 +100102,8 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/repos/contents#download-a-repository-archive-zip operationId: repos/download-zipball-archive parameters: - - *368 - - *369 + - *370 + - *371 - name: ref in: path required: true @@ -99609,9 +100195,9 @@ paths: description: Response content: application/json: - schema: *381 + schema: *383 examples: - default: *383 + default: *385 headers: Location: example: https://api.github.com/repos/octocat/Hello-World @@ -99652,7 +100238,7 @@ paths: application/json: schema: type: array - items: *193 + items: *195 examples: default: value: @@ -99762,7 +100348,7 @@ paths: value: Engineering externalId: value: 8aa1a0c0-c4c3-4bc0-b4a5-2ef676900159 - - &691 + - &693 name: excludedAttributes description: Excludes the specified attribute from being returned in the results. Using this parameter can speed up response time. @@ -99772,7 +100358,7 @@ paths: type: string examples: - members - - &696 + - &698 name: startIndex description: 'Used for pagination: the starting index of the first result to return when paginating through values.' @@ -99784,7 +100370,7 @@ paths: format: int32 examples: - 1 - - &697 + - &699 name: count description: 'Used for pagination: the number of results to return per page.' in: query @@ -99828,7 +100414,7 @@ paths: Resources: type: array description: Information about each provisioned group. - items: &685 + items: &687 allOf: - type: object required: @@ -99910,7 +100496,7 @@ paths: - value: 0db508eb-91e2-46e4-809c-30dcbda0c685 "$+ref": https://api.github.localhost/scim/v2/Users/0db508eb-91e2-46e4-809c-30dcbda0c685 displayName: User 2 - meta: &698 + meta: &700 type: object description: The metadata associated with the creation/updates to the user. @@ -99975,31 +100561,31 @@ paths: location: https://api.github.localhost/scim/v2/Groups/24b28bbb-5fc4-4686-a153-a020debb1155 startIndex: 1 itemsPerPage: 20 - '400': &686 + '400': &688 description: Bad request content: application/json: - schema: *684 + schema: *686 application/scim+json: - schema: *684 - '401': &687 + schema: *686 + '401': &689 description: Authorization failure - '403': &688 + '403': &690 description: Permission denied - '429': &689 + '429': &691 description: Too many requests content: application/json: - schema: *684 + schema: *686 application/scim+json: - schema: *684 - '500': &690 + schema: *686 + '500': &692 description: Internal server error content: application/json: - schema: *684 + schema: *686 application/scim+json: - schema: *684 + schema: *686 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -100023,7 +100609,7 @@ paths: required: true content: application/json: - schema: &694 + schema: &696 type: object required: - schemas @@ -100083,9 +100669,9 @@ paths: description: Group has been created content: application/scim+json: - schema: *685 + schema: *687 examples: - group: &692 + group: &694 value: schemas: - urn:ietf:params:scim:schemas:core:2.0:Group @@ -100104,13 +100690,13 @@ paths: created: '2012-03-27T19:59:26.000Z' lastModified: '2018-03-27T19:59:26.000Z' location: https://api.github.localhost/scim/v2/Groups/24b28bbb-5fc4-4686-a153-a020debb1155 - '400': *686 - '401': *687 - '403': *688 - '409': &695 + '400': *688 + '401': *689 + '403': *690 + '409': &697 description: Duplicate record detected - '429': *689 - '500': *690 + '429': *691 + '500': *692 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -100127,7 +100713,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/scim#get-scim-provisioning-information-for-an-enterprise-group parameters: - - &693 + - &695 name: scim_group_id description: A unique identifier of the SCIM group. in: path @@ -100136,22 +100722,22 @@ paths: type: string examples: - 7fce0092-d52e-4f76-b727-3955bd72c939 - - *691 + - *693 - *39 responses: '200': description: Success, a group was found content: application/scim+json: - schema: *685 + schema: *687 examples: - default: *692 - '400': *686 - '401': *687 - '403': *688 + default: *694 + '400': *688 + '401': *689 + '403': *690 '404': *6 - '429': *689 - '500': *690 + '429': *691 + '500': *692 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -100170,13 +100756,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/scim#set-scim-information-for-a-provisioned-enterprise-group parameters: - - *693 + - *695 - *39 requestBody: required: true content: application/json: - schema: *694 + schema: *696 examples: group: summary: Group @@ -100202,17 +100788,17 @@ paths: description: Group was updated content: application/scim+json: - schema: *685 + schema: *687 examples: - group: *692 - groupWithMembers: *692 - '400': *686 - '401': *687 - '403': *688 + group: *694 + groupWithMembers: *694 + '400': *688 + '401': *689 + '403': *690 '404': *6 - '409': *695 - '429': *689 - '500': *690 + '409': *697 + '429': *691 + '500': *692 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -100236,13 +100822,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/scim#update-an-attribute-for-a-scim-enterprise-group parameters: - - *693 + - *695 - *39 requestBody: required: true content: application/json: - schema: &705 + schema: &707 type: object required: - Operations @@ -100302,17 +100888,17 @@ paths: description: Success, group was updated content: application/scim+json: - schema: *685 + schema: *687 examples: - updateGroup: *692 - addMembers: *692 - '400': *686 - '401': *687 - '403': *688 + updateGroup: *694 + addMembers: *694 + '400': *688 + '401': *689 + '403': *690 '404': *6 - '409': *695 - '429': *689 - '500': *690 + '409': *697 + '429': *691 + '500': *692 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -100328,17 +100914,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/scim#delete-a-scim-group-from-an-enterprise parameters: - - *693 + - *695 - *39 responses: '204': description: Group was deleted, no content - '400': *686 - '401': *687 - '403': *688 + '400': *688 + '401': *689 + '403': *690 '404': *6 - '429': *689 - '500': *690 + '429': *691 + '500': *692 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -100372,8 +100958,8 @@ paths: value: userName eq 'E012345' externalId: value: externalId eq 'E012345' - - *696 - - *697 + - *698 + - *699 - *39 responses: '200': @@ -100407,7 +100993,7 @@ paths: Resources: type: array description: Information about each provisioned account. - items: &700 + items: &702 allOf: - type: object required: @@ -100499,7 +101085,7 @@ paths: address. examples: - true - roles: &699 + roles: &701 type: array description: The roles assigned to the user. items: @@ -100558,7 +101144,7 @@ paths: type: string description: Provisioned SCIM groups that the user is a member of. - meta: *698 + meta: *700 startIndex: type: integer description: A starting index for the returned page @@ -100597,11 +101183,11 @@ paths: primary: false startIndex: 1 itemsPerPage: 20 - '400': *686 - '401': *687 - '403': *688 - '429': *689 - '500': *690 + '400': *688 + '401': *689 + '403': *690 + '429': *691 + '500': *692 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -100625,7 +101211,7 @@ paths: required: true content: application/json: - schema: &703 + schema: &705 type: object required: - schemas @@ -100718,9 +101304,9 @@ paths: description: Whether this email address is the primary address. examples: - true - roles: *699 + roles: *701 examples: - user: &704 + user: &706 summary: User value: schemas: @@ -100767,9 +101353,9 @@ paths: description: User has been created content: application/scim+json: - schema: *700 + schema: *702 examples: - user: &701 + user: &703 value: schemas: - urn:ietf:params:scim:schemas:core:2.0:User @@ -100795,13 +101381,13 @@ paths: created: '2012-03-27T19:59:26.000Z' lastModified: '2018-03-27T19:59:26.000Z' location: https://api.github.localhost/scim/v2/Users/7fce0092-d52e-4f76-b727-3955bd72c939 - enterpriseOwner: *701 - '400': *686 - '401': *687 - '403': *688 - '409': *695 - '429': *689 - '500': *690 + enterpriseOwner: *703 + '400': *688 + '401': *689 + '403': *690 + '409': *697 + '429': *691 + '500': *692 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -100818,7 +101404,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/scim#get-scim-provisioning-information-for-an-enterprise-user parameters: - - &702 + - &704 name: scim_user_id description: The unique identifier of the SCIM user. in: path @@ -100831,15 +101417,15 @@ paths: description: Success, a user was found content: application/scim+json: - schema: *700 + schema: *702 examples: - default: *701 - '400': *686 - '401': *687 - '403': *688 + default: *703 + '400': *688 + '401': *689 + '403': *690 '404': *6 - '429': *689 - '500': *690 + '429': *691 + '500': *692 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -100861,30 +101447,30 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/scim#set-scim-information-for-a-provisioned-enterprise-user parameters: - - *702 + - *704 - *39 requestBody: required: true content: application/json: - schema: *703 + schema: *705 examples: - user: *704 + user: *706 responses: '200': description: User was updated content: application/scim+json: - schema: *700 + schema: *702 examples: - user: *701 - '400': *686 - '401': *687 - '403': *688 + user: *703 + '400': *688 + '401': *689 + '403': *690 '404': *6 - '409': *695 - '429': *689 - '500': *690 + '409': *697 + '429': *691 + '500': *692 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -100919,13 +101505,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/scim#update-an-attribute-for-a-scim-enterprise-user parameters: - - *702 + - *704 - *39 requestBody: required: true content: application/json: - schema: *705 + schema: *707 examples: userMultiValuedProperties: summary: Multi Valued Property @@ -100965,18 +101551,18 @@ paths: description: Success, user was updated content: application/scim+json: - schema: *700 + schema: *702 examples: - userMultiValuedProperties: *701 - userSingleValuedProperties: *701 - disableUser: *701 - '400': *686 - '401': *687 - '403': *688 + userMultiValuedProperties: *703 + userSingleValuedProperties: *703 + disableUser: *703 + '400': *688 + '401': *689 + '403': *690 '404': *6 - '409': *695 - '429': *689 - '500': *690 + '409': *697 + '429': *691 + '500': *692 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -100996,17 +101582,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/scim#delete-a-scim-user-from-an-enterprise parameters: - - *702 + - *704 - *39 responses: '204': description: User was deleted, no content - '400': *686 - '401': *687 - '403': *688 + '400': *688 + '401': *689 + '403': *690 '404': *6 - '429': *689 - '500': *690 + '429': *691 + '500': *692 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -101039,7 +101625,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/scim/scim#list-scim-provisioned-identities parameters: - - *167 + - *71 - name: startIndex description: 'Used for pagination: the index of the first result to return.' in: query @@ -101097,7 +101683,7 @@ paths: - 1 Resources: type: array - items: &706 + items: &708 title: SCIM /Users description: SCIM /Users provisioning endpoints type: object @@ -101344,22 +101930,22 @@ paths: lastModified: '2017-03-09T16:11:13-05:00' location: https://api.github.com/scim/v2/organizations/octo-org/Users/77563764-eb6-24-0598234-958243 '304': *35 - '404': &707 + '404': &709 description: Resource not found content: application/json: - schema: *684 + schema: *686 application/scim+json: - schema: *684 - '403': &708 + schema: *686 + '403': &710 description: Forbidden content: application/json: - schema: *684 + schema: *686 application/scim+json: - schema: *684 - '400': *686 - '429': *689 + schema: *686 + '400': *688 + '429': *691 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -101379,15 +101965,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/scim/scim#provision-and-invite-a-scim-user parameters: - - *167 + - *71 responses: '201': description: Response content: application/scim+json: - schema: *706 + schema: *708 examples: - default: &709 + default: &711 value: schemas: - urn:ietf:params:scim:schemas:core:2.0:User @@ -101410,17 +101996,17 @@ paths: lastModified: '2017-03-09T16:11:13-05:00' location: https://api.github.com/scim/v2/organizations/octo-org/Users/edefdfedf-050c-11e7-8d32 '304': *35 - '404': *707 - '403': *708 - '500': *690 + '404': *709 + '403': *710 + '500': *692 '409': description: Conflict content: application/json: - schema: *684 + schema: *686 application/scim+json: - schema: *684 - '400': *686 + schema: *686 + '400': *688 requestBody: required: true content: @@ -101519,18 +102105,18 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/scim/scim#get-scim-provisioning-information-for-a-user parameters: - - *167 - - *702 + - *71 + - *704 responses: '200': description: Response content: application/scim+json: - schema: *706 + schema: *708 examples: - default: *709 - '404': *707 - '403': *708 + default: *711 + '404': *709 + '403': *710 '304': *35 x-github: githubCloudOnly: true @@ -101553,19 +102139,19 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/scim/scim#update-a-provisioned-organization-membership parameters: - - *167 - - *702 + - *71 + - *704 responses: '200': description: Response content: application/scim+json: - schema: *706 + schema: *708 examples: - default: *709 + default: *711 '304': *35 - '404': *707 - '403': *708 + '404': *709 + '403': *710 requestBody: required: true content: @@ -101679,20 +102265,20 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/scim/scim#update-an-attribute-for-a-scim-user parameters: - - *167 - - *702 + - *71 + - *704 responses: '200': description: Response content: application/scim+json: - schema: *706 + schema: *708 examples: - default: *709 + default: *711 '304': *35 - '404': *707 - '403': *708 - '400': *686 + '404': *709 + '403': *710 + '400': *688 '429': description: Response content: @@ -101787,13 +102373,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/scim/scim#delete-a-scim-user-from-an-organization parameters: - - *167 - - *702 + - *71 + - *704 responses: '204': description: Response - '404': *707 - '403': *708 + '404': *709 + '403': *710 '304': *35 x-github: githubCloudOnly: true @@ -101908,7 +102494,7 @@ paths: html_url: type: string format: uri - repository: *193 + repository: *195 score: type: number file_size: @@ -101927,7 +102513,7 @@ paths: examples: - 73..77 - 77..78 - text_matches: &710 + text_matches: &712 title: Search Result Text Matches type: array items: @@ -102042,7 +102628,7 @@ paths: releases_url: http://api.github.com/repos/octocat/Hello-World/releases{/id} score: 1 '304': *35 - '503': *130 + '503': *133 '422': *15 '403': *27 x-github: @@ -102091,7 +102677,7 @@ paths: enum: - author-date - committer-date - - &711 + - &713 name: order description: Determines whether the first search result returned is the highest number of matches (`desc`) or lowest number of matches (`asc`). This parameter @@ -102160,7 +102746,7 @@ paths: committer: anyOf: - type: 'null' - - *425 + - *427 comment_count: type: integer message: @@ -102179,7 +102765,7 @@ paths: url: type: string format: uri - verification: *544 + verification: *546 required: - author - committer @@ -102194,7 +102780,7 @@ paths: committer: anyOf: - type: 'null' - - *425 + - *427 parents: type: array items: @@ -102206,12 +102792,12 @@ paths: type: string sha: type: string - repository: *193 + repository: *195 score: type: number node_id: type: string - text_matches: *710 + text_matches: *712 required: - sha - node_id @@ -102394,7 +102980,7 @@ paths: - interactions - created - updated - - *711 + - *713 - *17 - *19 - name: advanced_search @@ -102518,7 +103104,7 @@ paths: milestone: anyOf: - type: 'null' - - *490 + - *492 comments: type: integer created_at: @@ -102532,7 +103118,7 @@ paths: - string - 'null' format: date-time - text_matches: *710 + text_matches: *712 pull_request: type: object properties: @@ -102570,7 +103156,7 @@ paths: type: string score: type: number - author_association: *138 + author_association: *141 draft: type: boolean repository: *62 @@ -102581,12 +103167,12 @@ paths: timeline_url: type: string format: uri - type: *282 + type: *284 performed_via_github_app: anyOf: - type: 'null' - *5 - reactions: *139 + reactions: *142 required: - assignee - closed_at @@ -102702,7 +103288,7 @@ paths: locked: true author_association: COLLABORATOR state_reason: completed - '503': *130 + '503': *133 '422': *15 '304': *35 '403': *27 @@ -102758,7 +103344,7 @@ paths: enum: - created - updated - - *711 + - *713 - *17 - *19 responses: @@ -102803,7 +103389,7 @@ paths: - 'null' score: type: number - text_matches: *710 + text_matches: *712 required: - id - node_id @@ -102889,7 +103475,7 @@ paths: - forks - help-wanted-issues - updated - - *711 + - *713 - *17 - *19 responses: @@ -103108,7 +103694,7 @@ paths: license: anyOf: - type: 'null' - - *152 + - *155 permissions: type: object properties: @@ -103126,7 +103712,7 @@ paths: - admin - pull - push - text_matches: *710 + text_matches: *712 temp_clone_token: type: string allow_merge_commit: @@ -103329,7 +103915,7 @@ paths: spdx_id: MIT node_id: MDc6TGljZW5zZW1pdA== html_url: https://api.github.com/licenses/mit - '503': *130 + '503': *133 '422': *15 '304': *35 x-github: @@ -103435,7 +104021,7 @@ paths: - string - 'null' format: uri - text_matches: *710 + text_matches: *712 related: type: - array @@ -103630,7 +104216,7 @@ paths: - followers - repositories - joined - - *711 + - *713 - *17 - *19 responses: @@ -103740,7 +104326,7 @@ paths: type: - boolean - 'null' - text_matches: *710 + text_matches: *712 blog: type: - string @@ -103802,7 +104388,7 @@ paths: events_url: https://api.github.com/users/mojombo/events{/privacy} site_admin: true '304': *35 - '503': *130 + '503': *133 '422': *15 x-github: githubCloudOnly: false @@ -103822,7 +104408,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#get-a-team-legacy parameters: - - &712 + - &714 name: team_id description: The unique identifier of the team. in: path @@ -103834,9 +104420,9 @@ paths: description: Response content: application/json: - schema: *349 + schema: *351 examples: - default: *350 + default: *352 '404': *6 x-github: githubCloudOnly: false @@ -103863,7 +104449,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#update-a-team-legacy parameters: - - *712 + - *714 requestBody: required: true content: @@ -103927,16 +104513,16 @@ paths: description: Response when the updated information already exists content: application/json: - schema: *349 + schema: *351 examples: - default: *350 + default: *352 '201': description: Response content: application/json: - schema: *349 + schema: *351 examples: - default: *350 + default: *352 '404': *6 '422': *15 '403': *27 @@ -103964,7 +104550,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#delete-a-team-legacy parameters: - - *712 + - *714 responses: '204': description: Response @@ -103995,8 +104581,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussions#list-discussions-legacy parameters: - - *712 - - *86 + - *714 + - *89 - *17 - *19 responses: @@ -104006,9 +104592,9 @@ paths: application/json: schema: type: array - items: *351 + items: *353 examples: - default: *713 + default: *715 headers: Link: *38 x-github: @@ -104037,7 +104623,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussions#create-a-discussion-legacy parameters: - - *712 + - *714 requestBody: required: true content: @@ -104071,9 +104657,9 @@ paths: description: Response content: application/json: - schema: *351 + schema: *353 examples: - default: *352 + default: *354 x-github: triggersNotification: true githubCloudOnly: false @@ -104100,16 +104686,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussions#get-a-discussion-legacy parameters: - - *712 - - *353 + - *714 + - *355 responses: '200': description: Response content: application/json: - schema: *351 + schema: *353 examples: - default: *352 + default: *354 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -104134,8 +104720,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussions#update-a-discussion-legacy parameters: - - *712 - - *353 + - *714 + - *355 requestBody: required: false content: @@ -104158,9 +104744,9 @@ paths: description: Response content: application/json: - schema: *351 + schema: *353 examples: - default: *714 + default: *716 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -104185,8 +104771,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussions#delete-a-discussion-legacy parameters: - - *712 - - *353 + - *714 + - *355 responses: '204': description: Response @@ -104215,9 +104801,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussion-comments#list-discussion-comments-legacy parameters: - - *712 - - *353 - - *86 + - *714 + - *355 + - *89 - *17 - *19 responses: @@ -104227,9 +104813,9 @@ paths: application/json: schema: type: array - items: *354 + items: *356 examples: - default: *715 + default: *717 headers: Link: *38 x-github: @@ -104258,8 +104844,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussion-comments#create-a-discussion-comment-legacy parameters: - - *712 - - *353 + - *714 + - *355 requestBody: required: true content: @@ -104281,9 +104867,9 @@ paths: description: Response content: application/json: - schema: *354 + schema: *356 examples: - default: *355 + default: *357 x-github: triggersNotification: true githubCloudOnly: false @@ -104310,17 +104896,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussion-comments#get-a-discussion-comment-legacy parameters: - - *712 - - *353 - - *356 + - *714 + - *355 + - *358 responses: '200': description: Response content: application/json: - schema: *354 + schema: *356 examples: - default: *355 + default: *357 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -104345,9 +104931,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussion-comments#update-a-discussion-comment-legacy parameters: - - *712 - - *353 - - *356 + - *714 + - *355 + - *358 requestBody: required: true content: @@ -104369,9 +104955,9 @@ paths: description: Response content: application/json: - schema: *354 + schema: *356 examples: - default: *716 + default: *718 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -104396,9 +104982,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/discussion-comments#delete-a-discussion-comment-legacy parameters: - - *712 - - *353 - - *356 + - *714 + - *355 + - *358 responses: '204': description: Response @@ -104427,9 +105013,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#list-reactions-for-a-team-discussion-comment-legacy parameters: - - *712 - - *353 - - *356 + - *714 + - *355 + - *358 - name: content description: Returns a single [reaction type](https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to a team discussion comment. @@ -104455,9 +105041,9 @@ paths: application/json: schema: type: array - items: *357 + items: *359 examples: - default: *359 + default: *361 headers: Link: *38 x-github: @@ -104486,9 +105072,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#create-reaction-for-a-team-discussion-comment-legacy parameters: - - *712 - - *353 - - *356 + - *714 + - *355 + - *358 requestBody: required: true content: @@ -104520,9 +105106,9 @@ paths: description: Response content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -104548,8 +105134,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#list-reactions-for-a-team-discussion-legacy parameters: - - *712 - - *353 + - *714 + - *355 - name: content description: Returns a single [reaction type](https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to a team discussion. @@ -104575,9 +105161,9 @@ paths: application/json: schema: type: array - items: *357 + items: *359 examples: - default: *359 + default: *361 headers: Link: *38 x-github: @@ -104606,8 +105192,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#create-reaction-for-a-team-discussion-legacy parameters: - - *712 - - *353 + - *714 + - *355 requestBody: required: true content: @@ -104639,9 +105225,9 @@ paths: description: Response content: application/json: - schema: *357 + schema: *359 examples: - default: *358 + default: *360 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -104665,7 +105251,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#list-pending-team-invitations-legacy parameters: - - *712 + - *714 - *17 - *19 responses: @@ -104675,9 +105261,9 @@ paths: application/json: schema: type: array - items: *279 + items: *281 examples: - default: *280 + default: *282 headers: Link: *38 x-github: @@ -104703,7 +105289,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#list-team-members-legacy parameters: - - *712 + - *714 - name: role description: Filters members returned by their role in the team. in: query @@ -104726,7 +105312,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: *38 '404': *6 @@ -104754,8 +105340,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#get-team-member-legacy parameters: - - *712 - - *215 + - *714 + - *217 responses: '204': description: if user is a member @@ -104791,8 +105377,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#add-team-member-legacy parameters: - - *712 - - *215 + - *714 + - *217 responses: '204': description: Response @@ -104831,8 +105417,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#remove-team-member-legacy parameters: - - *712 - - *215 + - *714 + - *217 responses: '204': description: Response @@ -104868,16 +105454,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#get-team-membership-for-a-user-legacy parameters: - - *712 - - *215 + - *714 + - *217 responses: '200': description: Response content: application/json: - schema: *365 + schema: *367 examples: - response-if-user-is-a-team-maintainer: *717 + response-if-user-is-a-team-maintainer: *719 '404': *6 x-github: githubCloudOnly: false @@ -104910,8 +105496,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#add-or-update-team-membership-for-a-user-legacy parameters: - - *712 - - *215 + - *714 + - *217 requestBody: required: false content: @@ -104936,9 +105522,9 @@ paths: description: Response content: application/json: - schema: *365 + schema: *367 examples: - response-if-users-membership-with-team-is-now-pending: *718 + response-if-users-membership-with-team-is-now-pending: *720 '403': description: Forbidden if team synchronization is set up '422': @@ -104972,8 +105558,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#remove-team-membership-for-a-user-legacy parameters: - - *712 - - *215 + - *714 + - *217 responses: '204': description: Response @@ -105001,7 +105587,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#list-team-projects-legacy parameters: - - *712 + - *714 - *17 - *19 responses: @@ -105011,9 +105597,9 @@ paths: application/json: schema: type: array - items: *366 + items: *368 examples: - default: *719 + default: *721 headers: Link: *38 '404': *6 @@ -105039,16 +105625,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#check-team-permissions-for-a-project-legacy parameters: - - *712 - - *367 + - *714 + - *369 responses: '200': description: Response content: application/json: - schema: *366 + schema: *368 examples: - default: *720 + default: *722 '404': description: Not Found if project is not managed by this team x-github: @@ -105072,8 +105658,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#add-or-update-team-project-permissions-legacy parameters: - - *712 - - *367 + - *714 + - *369 requestBody: required: false content: @@ -105140,8 +105726,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#remove-a-project-from-a-team-legacy parameters: - - *712 - - *367 + - *714 + - *369 responses: '204': description: Response @@ -105168,7 +105754,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#list-team-repositories-legacy parameters: - - *712 + - *714 - *17 - *19 responses: @@ -105178,9 +105764,9 @@ paths: application/json: schema: type: array - items: *193 + items: *195 examples: - default: *305 + default: *307 headers: Link: *38 '404': *6 @@ -105210,15 +105796,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#check-team-permissions-for-a-repository-legacy parameters: - - *712 - - *368 - - *369 + - *714 + - *370 + - *371 responses: '200': description: Alternative response with extra repository information content: application/json: - schema: *721 + schema: *723 examples: alternative-response-with-extra-repository-information: value: @@ -105369,9 +105955,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#add-or-update-team-repository-permissions-legacy parameters: - - *712 - - *368 - - *369 + - *714 + - *370 + - *371 requestBody: required: false content: @@ -105421,9 +106007,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#remove-a-repository-from-a-team-legacy parameters: - - *712 - - *368 - - *369 + - *714 + - *370 + - *371 responses: '204': description: Response @@ -105452,15 +106038,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/team-sync#list-idp-groups-for-a-team-legacy parameters: - - *712 + - *714 responses: '200': description: Response content: application/json: - schema: *370 + schema: *372 examples: - default: *371 + default: *373 '403': *27 '404': *6 x-github: @@ -105487,7 +106073,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/team-sync#create-or-update-idp-group-connections-legacy parameters: - - *712 + - *714 requestBody: required: true content: @@ -105548,7 +106134,7 @@ paths: description: Response content: application/json: - schema: *370 + schema: *372 examples: default: value: @@ -105579,7 +106165,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#list-child-teams-legacy parameters: - - *712 + - *714 - *17 - *19 responses: @@ -105589,9 +106175,9 @@ paths: application/json: schema: type: array - items: *224 + items: *226 examples: - response-if-child-teams-exist: *722 + response-if-child-teams-exist: *724 headers: Link: *38 '404': *6 @@ -105624,7 +106210,7 @@ paths: application/json: schema: oneOf: - - &724 + - &726 title: Private User description: Private User type: object @@ -105874,7 +106460,7 @@ paths: - private_gists - total_private_repos - two_factor_authentication - - *723 + - *725 examples: response-with-public-and-private-profile-information: summary: Response with public and private profile information @@ -106034,7 +106620,7 @@ paths: description: Response content: application/json: - schema: *724 + schema: *726 examples: default: value: @@ -106113,7 +106699,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 '304': *35 '404': *6 '403': *27 @@ -106136,7 +106722,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/blocking#check-if-a-user-is-blocked-by-the-authenticated-user parameters: - - *215 + - *217 responses: '204': description: If the user is blocked @@ -106164,7 +106750,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/blocking#block-a-user parameters: - - *215 + - *217 responses: '204': description: Response @@ -106188,7 +106774,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/blocking#unblock-a-user parameters: - - *215 + - *217 responses: '204': description: Response @@ -106237,11 +106823,11 @@ paths: type: integer codespaces: type: array - items: *288 + items: *290 examples: - default: *289 + default: *291 '304': *35 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -106378,21 +106964,21 @@ paths: description: Response when the codespace was successfully created content: application/json: - schema: *288 + schema: *290 examples: - default: *477 + default: *479 '202': description: Response when the codespace creation partially failed but is being retried in the background content: application/json: - schema: *288 + schema: *290 examples: - default: *477 + default: *479 '401': *23 '403': *27 '404': *6 - '503': *130 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -106432,7 +107018,7 @@ paths: type: integer secrets: type: array - items: &725 + items: &727 title: Codespaces Secret description: Secrets for a GitHub Codespace. type: object @@ -106474,7 +107060,7 @@ paths: - visibility - selected_repositories_url examples: - default: *479 + default: *481 headers: Link: *38 x-github: @@ -106546,13 +107132,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/secrets#get-a-secret-for-the-authenticated-user parameters: - - *203 + - *205 responses: '200': description: Response content: application/json: - schema: *725 + schema: *727 examples: default: value: @@ -106582,7 +107168,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/secrets#create-or-update-a-secret-for-the-authenticated-user parameters: - - *203 + - *205 requestBody: required: true content: @@ -106627,7 +107213,7 @@ paths: description: Response after successfully creating a secret content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -106655,7 +107241,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/secrets#delete-a-secret-for-the-authenticated-user parameters: - - *203 + - *205 responses: '204': description: Response @@ -106680,7 +107266,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/secrets#list-selected-repositories-for-a-user-secret parameters: - - *203 + - *205 responses: '200': description: Response @@ -106696,13 +107282,13 @@ paths: type: integer repositories: type: array - items: *193 + items: *195 examples: - default: *726 + default: *728 '401': *23 '403': *27 '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -106723,7 +107309,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/secrets#set-selected-repositories-for-a-user-secret parameters: - - *203 + - *205 requestBody: required: true content: @@ -106755,7 +107341,7 @@ paths: '401': *23 '403': *27 '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -106777,7 +107363,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/secrets#add-a-selected-repository-to-a-user-secret parameters: - - *203 + - *205 - name: repository_id in: path required: true @@ -106789,7 +107375,7 @@ paths: '401': *23 '403': *27 '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -106810,7 +107396,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/secrets#remove-a-selected-repository-from-a-user-secret parameters: - - *203 + - *205 - name: repository_id in: path required: true @@ -106822,7 +107408,7 @@ paths: '401': *23 '403': *27 '404': *6 - '500': *83 + '500': *86 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -106842,17 +107428,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#get-a-codespace-for-the-authenticated-user parameters: - - *290 + - *292 responses: '200': description: Response content: application/json: - schema: *288 + schema: *290 examples: - default: *477 + default: *479 '304': *35 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -106876,7 +107462,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#update-a-codespace-for-the-authenticated-user parameters: - - *290 + - *292 requestBody: required: false content: @@ -106906,9 +107492,9 @@ paths: description: Response content: application/json: - schema: *288 + schema: *290 examples: - default: *477 + default: *479 '401': *23 '403': *27 '404': *6 @@ -106930,11 +107516,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#delete-a-codespace-for-the-authenticated-user parameters: - - *290 + - *292 responses: '202': *37 '304': *35 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -106959,13 +107545,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#export-a-codespace-for-the-authenticated-user parameters: - - *290 + - *292 responses: '202': description: Response content: application/json: - schema: &727 + schema: &729 type: object title: Fetches information about an export of a codespace. description: An export of a codespace. Also, latest export details @@ -107018,7 +107604,7 @@ paths: examples: - https://github.com/octocat/hello-world/tree/:branch examples: - default: &728 + default: &730 value: state: succeeded completed_at: '2022-01-01T14:59:22Z' @@ -107026,7 +107612,7 @@ paths: sha: fd95a81ca01e48ede9f39c799ecbcef817b8a3b2 id: latest export_url: https://api.github.com/user/codespaces/:name/exports/latest - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -107050,7 +107636,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#get-details-about-a-codespace-export parameters: - - *290 + - *292 - name: export_id in: path required: true @@ -107063,9 +107649,9 @@ paths: description: Response content: application/json: - schema: *727 + schema: *729 examples: - default: *728 + default: *730 '404': *6 x-github: githubCloudOnly: false @@ -107086,7 +107672,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/machines#list-machine-types-for-a-codespace parameters: - - *290 + - *292 responses: '200': description: Response @@ -107102,11 +107688,11 @@ paths: type: integer machines: type: array - items: *478 + items: *480 examples: - default: *729 + default: *731 '304': *35 - '500': *83 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -107133,7 +107719,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#create-a-repository-from-an-unpublished-codespace parameters: - - *290 + - *292 requestBody: required: true content: @@ -107189,11 +107775,11 @@ paths: - 26a7c758-7299-4a73-b978-5a92a7ae98a0 owner: *4 billable_owner: *4 - repository: *381 + repository: *383 machine: anyOf: - type: 'null' - - *478 + - *480 devcontainer_path: description: Path to devcontainer.json from repo root used to create Codespace. @@ -107990,17 +108576,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#start-a-codespace-for-the-authenticated-user parameters: - - *290 + - *292 responses: '200': description: Response content: application/json: - schema: *288 + schema: *290 examples: - default: *477 + default: *479 '304': *35 - '500': *83 + '500': *86 '400': *14 '401': *23 '402': @@ -108010,7 +108596,7 @@ paths: schema: *3 '403': *27 '404': *6 - '409': *94 + '409': *97 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -108030,16 +108616,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#stop-a-codespace-for-the-authenticated-user parameters: - - *290 + - *292 responses: '200': description: Response content: application/json: - schema: *288 + schema: *290 examples: - default: *477 - '500': *83 + default: *479 + '500': *86 '401': *23 '403': *27 '404': *6 @@ -108068,9 +108654,9 @@ paths: application/json: schema: type: array - items: *299 + items: *301 examples: - default: &742 + default: &744 value: - id: 197 name: hello_docker @@ -108171,7 +108757,7 @@ paths: application/json: schema: type: array - items: &730 + items: &732 title: Email description: Email type: object @@ -108241,9 +108827,9 @@ paths: application/json: schema: type: array - items: *730 + items: *732 examples: - default: &744 + default: &746 value: - email: octocat@github.com verified: true @@ -108320,7 +108906,7 @@ paths: application/json: schema: type: array - items: *730 + items: *732 examples: default: value: @@ -108432,7 +109018,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: *38 '304': *35 @@ -108465,7 +109051,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: *38 '304': *35 @@ -108487,7 +109073,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/followers#check-if-a-person-is-followed-by-the-authenticated-user parameters: - - *215 + - *217 responses: '204': description: if the person is followed by the authenticated user @@ -108517,7 +109103,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/followers#follow-a-user parameters: - - *215 + - *217 responses: '204': description: Response @@ -108542,7 +109128,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/followers#unfollow-a-user parameters: - - *215 + - *217 responses: '204': description: Response @@ -108578,7 +109164,7 @@ paths: application/json: schema: type: array - items: &731 + items: &733 title: GPG Key description: A unique encryption key type: object @@ -108723,7 +109309,7 @@ paths: - subkeys - revoked examples: - default: &758 + default: &760 value: - id: 3 name: Octocat's GPG Key @@ -108808,9 +109394,9 @@ paths: description: Response content: application/json: - schema: *731 + schema: *733 examples: - default: &732 + default: &734 value: id: 3 name: Octocat's GPG Key @@ -108867,7 +109453,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/gpg-keys#get-a-gpg-key-for-the-authenticated-user parameters: - - &733 + - &735 name: gpg_key_id description: The unique identifier of the GPG key. in: path @@ -108879,9 +109465,9 @@ paths: description: Response content: application/json: - schema: *731 + schema: *733 examples: - default: *732 + default: *734 '404': *6 '304': *35 '403': *27 @@ -108904,7 +109490,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/gpg-keys#delete-a-gpg-key-for-the-authenticated-user parameters: - - *733 + - *735 responses: '204': description: Response @@ -109095,7 +109681,7 @@ paths: type: array items: *62 examples: - default: *734 + default: *736 headers: Link: *38 '404': *6 @@ -109120,7 +109706,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/apps/installations#add-a-repository-to-an-app-installation parameters: - *21 - - *188 + - *190 responses: '204': description: Response @@ -109146,7 +109732,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/apps/installations#remove-a-repository-from-an-app-installation parameters: - *21 - - *188 + - *190 responses: '204': description: Response @@ -109180,12 +109766,12 @@ paths: application/json: schema: anyOf: - - *277 + - *279 - type: object properties: {} additionalProperties: false examples: - default: *278 + default: *280 '204': description: Response when there are no restrictions x-github: @@ -109209,7 +109795,7 @@ paths: required: true content: application/json: - schema: *555 + schema: *557 examples: default: value: @@ -109220,7 +109806,7 @@ paths: description: Response content: application/json: - schema: *277 + schema: *279 examples: default: value: @@ -109301,7 +109887,7 @@ paths: - closed - all default: open - - *285 + - *287 - name: sort description: What to sort results by. in: query @@ -109313,8 +109899,8 @@ paths: - updated - comments default: created - - *86 - - *141 + - *89 + - *144 - *17 - *19 responses: @@ -109324,9 +109910,9 @@ paths: application/json: schema: type: array - items: *151 + items: *154 examples: - default: *286 + default: *288 headers: Link: *38 '404': *6 @@ -109359,7 +109945,7 @@ paths: application/json: schema: type: array - items: &735 + items: &737 title: Key description: Key type: object @@ -109457,9 +110043,9 @@ paths: description: Response content: application/json: - schema: *735 + schema: *737 examples: - default: &736 + default: &738 value: key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 id: 2 @@ -109492,15 +110078,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/keys#get-a-public-ssh-key-for-the-authenticated-user parameters: - - *582 + - *584 responses: '200': description: Response content: application/json: - schema: *735 + schema: *737 examples: - default: *736 + default: *738 '404': *6 '304': *35 '403': *27 @@ -109523,7 +110109,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/keys#delete-a-public-ssh-key-for-the-authenticated-user parameters: - - *582 + - *584 responses: '204': description: Response @@ -109556,7 +110142,7 @@ paths: application/json: schema: type: array - items: &737 + items: &739 title: User Marketplace Purchase description: User Marketplace Purchase type: object @@ -109624,7 +110210,7 @@ paths: - id - type - login - plan: *154 + plan: *157 required: - billing_cycle - next_billing_date @@ -109635,7 +110221,7 @@ paths: - account - plan examples: - default: &738 + default: &740 value: - billing_cycle: monthly next_billing_date: '2017-11-11T00:00:00Z' @@ -109697,9 +110283,9 @@ paths: application/json: schema: type: array - items: *737 + items: *739 examples: - default: *738 + default: *740 headers: Link: *38 '304': *35 @@ -109739,7 +110325,7 @@ paths: application/json: schema: type: array - items: *291 + items: *293 examples: default: value: @@ -109841,13 +110427,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#get-an-organization-membership-for-the-authenticated-user parameters: - - *167 + - *71 responses: '200': description: Response content: application/json: - schema: *291 + schema: *293 examples: default: value: @@ -109905,7 +110491,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#update-an-organization-membership-for-the-authenticated-user parameters: - - *167 + - *71 requestBody: required: true content: @@ -109930,7 +110516,7 @@ paths: description: Response content: application/json: - schema: *291 + schema: *293 examples: default: value: @@ -109998,7 +110584,7 @@ paths: application/json: schema: type: array - items: *293 + items: *295 examples: default: value: @@ -110260,7 +110846,7 @@ paths: description: Response content: application/json: - schema: *293 + schema: *295 examples: default: value: @@ -110440,7 +111026,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/users#get-a-user-migration-status parameters: - - *294 + - *296 - name: exclude in: query required: false @@ -110453,7 +111039,7 @@ paths: description: Response content: application/json: - schema: *293 + schema: *295 examples: default: value: @@ -110647,7 +111233,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/users#download-a-user-migration-archive parameters: - - *294 + - *296 responses: '302': description: Response @@ -110673,7 +111259,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/users#delete-a-user-migration-archive parameters: - - *294 + - *296 responses: '204': description: Response @@ -110702,8 +111288,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/users#unlock-a-user-repository parameters: - - *294 - - *739 + - *296 + - *741 responses: '204': description: Response @@ -110727,7 +111313,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/users#list-repositories-for-a-user-migration parameters: - - *294 + - *296 - *17 - *19 responses: @@ -110737,9 +111323,9 @@ paths: application/json: schema: type: array - items: *193 + items: *195 examples: - default: *305 + default: *307 headers: Link: *38 '404': *6 @@ -110776,7 +111362,7 @@ paths: type: array items: *57 examples: - default: *740 + default: *742 headers: Link: *38 '304': *35 @@ -110818,7 +111404,7 @@ paths: - docker - nuget - container - - *741 + - *743 - *19 - *17 responses: @@ -110828,10 +111414,10 @@ paths: application/json: schema: type: array - items: *299 + items: *301 examples: - default: *742 - '400': *743 + default: *744 + '400': *745 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -110851,16 +111437,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#get-a-package-for-the-authenticated-user parameters: - - *301 - - *302 + - *303 + - *304 responses: '200': description: Response content: application/json: - schema: *299 + schema: *301 examples: - default: &759 + default: &761 value: id: 40201 name: octo-name @@ -110973,8 +111559,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#delete-a-package-for-the-authenticated-user parameters: - - *301 - - *302 + - *303 + - *304 responses: '204': description: Response @@ -111004,8 +111590,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#restore-a-package-for-the-authenticated-user parameters: - - *301 - - *302 + - *303 + - *304 - name: token description: package token schema: @@ -111037,8 +111623,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#list-package-versions-for-a-package-owned-by-the-authenticated-user parameters: - - *301 - - *302 + - *303 + - *304 - *19 - *17 - name: state @@ -111058,7 +111644,7 @@ paths: application/json: schema: type: array - items: *303 + items: *305 examples: default: value: @@ -111107,15 +111693,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#get-a-package-version-for-the-authenticated-user parameters: - - *301 - - *302 + - *303 - *304 + - *306 responses: '200': description: Response content: application/json: - schema: *303 + schema: *305 examples: default: value: @@ -111151,9 +111737,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#delete-a-package-version-for-the-authenticated-user parameters: - - *301 - - *302 + - *303 - *304 + - *306 responses: '204': description: Response @@ -111183,9 +111769,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#restore-a-package-version-for-the-authenticated-user parameters: - - *301 - - *302 + - *303 - *304 + - *306 responses: '204': description: Response @@ -111243,7 +111829,7 @@ paths: description: Response content: application/json: - schema: *315 + schema: *317 examples: default: value: @@ -111315,9 +111901,9 @@ paths: application/json: schema: type: array - items: *730 + items: *732 examples: - default: *744 + default: *746 headers: Link: *38 '304': *35 @@ -111430,7 +112016,7 @@ paths: type: array items: *62 examples: - default: &751 + default: &753 summary: Default response value: - id: 1296269 @@ -111748,9 +112334,9 @@ paths: description: Response content: application/json: - schema: *381 + schema: *383 examples: - default: *383 + default: *385 headers: Location: example: https://api.github.com/repos/octocat/Hello-World @@ -111788,9 +112374,9 @@ paths: application/json: schema: type: array - items: *557 + items: *559 examples: - default: *745 + default: *747 headers: Link: *38 '304': *35 @@ -111813,12 +112399,12 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/invitations#accept-a-repository-invitation parameters: - - *281 + - *283 responses: '204': description: Response '403': *27 - '409': *94 + '409': *97 '404': *6 '304': *35 x-github: @@ -111836,11 +112422,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/invitations#decline-a-repository-invitation parameters: - - *281 + - *283 responses: '204': description: Response - '409': *94 + '409': *97 '304': *35 '404': *6 '403': *27 @@ -111869,7 +112455,7 @@ paths: application/json: schema: type: array - items: &746 + items: &748 title: Social account description: Social media account type: object @@ -111886,7 +112472,7 @@ paths: - provider - url examples: - default: &747 + default: &749 value: - provider: twitter url: https://twitter.com/github @@ -111949,9 +112535,9 @@ paths: application/json: schema: type: array - items: *746 + items: *748 examples: - default: *747 + default: *749 '422': *15 '304': *35 '404': *6 @@ -112039,7 +112625,7 @@ paths: application/json: schema: type: array - items: &748 + items: &750 title: SSH Signing Key description: A public SSH key used to sign Git commits type: object @@ -112059,7 +112645,7 @@ paths: - title - created_at examples: - default: &760 + default: &762 value: - key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 id: 2 @@ -112126,9 +112712,9 @@ paths: description: Response content: application/json: - schema: *748 + schema: *750 examples: - default: &749 + default: &751 value: key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 id: 2 @@ -112159,7 +112745,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/ssh-signing-keys#get-an-ssh-signing-key-for-the-authenticated-user parameters: - - &750 + - &752 name: ssh_signing_key_id description: The unique identifier of the SSH signing key. in: path @@ -112171,9 +112757,9 @@ paths: description: Response content: application/json: - schema: *748 + schema: *750 examples: - default: *749 + default: *751 '404': *6 '304': *35 '403': *27 @@ -112196,7 +112782,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/ssh-signing-keys#delete-an-ssh-signing-key-for-the-authenticated-user parameters: - - *750 + - *752 responses: '204': description: Response @@ -112225,7 +112811,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/starring#list-repositories-starred-by-the-authenticated-user parameters: - - &761 + - &763 name: sort description: The property to sort the results by. `created` means when the repository was starred. `updated` means when the repository was last pushed @@ -112238,7 +112824,7 @@ paths: - created - updated default: created - - *86 + - *89 - *17 - *19 responses: @@ -112250,11 +112836,11 @@ paths: type: array items: *62 examples: - default-response: *751 + default-response: *753 application/vnd.github.v3.star+json: schema: type: array - items: &762 + items: &764 title: Starred Repository description: Starred Repository type: object @@ -112410,8 +112996,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/starring#check-if-a-repository-is-starred-by-the-authenticated-user parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response if this repository is starred by you @@ -112439,8 +113025,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/starring#star-a-repository-for-the-authenticated-user parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response @@ -112464,8 +113050,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/starring#unstar-a-repository-for-the-authenticated-user parameters: - - *368 - - *369 + - *370 + - *371 responses: '204': description: Response @@ -112498,9 +113084,9 @@ paths: application/json: schema: type: array - items: *193 + items: *195 examples: - default: *305 + default: *307 headers: Link: *38 '304': *35 @@ -112537,7 +113123,7 @@ paths: application/json: schema: type: array - items: *349 + items: *351 examples: default: value: @@ -112615,7 +113201,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/users#get-a-user-using-their-id parameters: - - *156 + - *159 responses: '200': description: Response @@ -112623,10 +113209,10 @@ paths: application/json: schema: oneOf: - - *724 - - *723 + - *726 + - *725 examples: - default-response: &753 + default-response: &755 summary: Default response value: login: octocat @@ -112661,7 +113247,7 @@ paths: following: 0 created_at: '2008-01-14T04:33:35Z' updated_at: '2008-01-14T04:33:35Z' - response-with-git-hub-plan-information: &754 + response-with-git-hub-plan-information: &756 summary: Response with GitHub plan information value: login: octocat @@ -112721,7 +113307,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/users#list-users parameters: - - *752 + - *754 - *17 responses: '200': @@ -112732,7 +113318,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: example: ; rel="next" @@ -112762,7 +113348,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/users#get-a-user parameters: - - *215 + - *217 responses: '200': description: Response @@ -112770,11 +113356,11 @@ paths: application/json: schema: oneOf: - - *724 - - *723 + - *726 + - *725 examples: - default-response: *753 - response-with-git-hub-plan-information: *754 + default-response: *755 + response-with-git-hub-plan-information: *756 '404': *6 x-github: githubCloudOnly: false @@ -112798,9 +113384,9 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/users/attestations#list-attestations-by-bulk-subject-digests parameters: - *17 - - *84 - - *85 - - *215 + - *87 + - *88 + - *217 requestBody: required: true content: @@ -112823,8 +113409,8 @@ paths: required: - subject_digests examples: - default: *755 - withPredicateType: *756 + default: *757 + withPredicateType: *758 responses: '200': description: Response @@ -112878,7 +113464,7 @@ paths: description: The cursor to the previous page. description: Information about the current page. examples: - default: *757 + default: *759 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -112896,7 +113482,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/attestations#delete-attestations-in-bulk parameters: - - *215 + - *217 requestBody: required: true content: @@ -112961,7 +113547,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/attestations#delete-attestations-by-subject-digest parameters: - - *215 + - *217 - name: subject_digest description: Subject Digest in: path @@ -112992,7 +113578,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/attestations#delete-attestations-by-id parameters: - - *215 + - *217 - name: attestation_id description: Attestation ID in: path @@ -113028,9 +113614,9 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/users/attestations#list-attestations parameters: - *17 - - *84 - - *85 - - *215 + - *87 + - *88 + - *217 - name: subject_digest description: Subject Digest in: path @@ -113080,12 +113666,12 @@ paths: bundle_url: type: string examples: - default: *421 + default: *423 '201': description: Response content: application/json: - schema: *204 + schema: *206 examples: default: value: @@ -113111,7 +113697,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#get-list-of-conflicting-packages-during-docker-migration-for-user parameters: - - *215 + - *217 responses: '200': description: Response @@ -113119,9 +113705,9 @@ paths: application/json: schema: type: array - items: *299 + items: *301 examples: - default: *742 + default: *744 '403': *27 '401': *23 x-github: @@ -113144,7 +113730,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/events#list-events-for-the-authenticated-user parameters: - - *215 + - *217 - *17 - *19 responses: @@ -113154,7 +113740,7 @@ paths: application/json: schema: type: array - items: *162 + items: *165 examples: default: value: @@ -113225,8 +113811,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/events#list-organization-events-for-the-authenticated-user parameters: - - *215 - - *167 + - *217 + - *71 - *17 - *19 responses: @@ -113236,7 +113822,7 @@ paths: application/json: schema: type: array - items: *162 + items: *165 examples: default: value: @@ -113315,7 +113901,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/events#list-public-events-for-a-user parameters: - - *215 + - *217 - *17 - *19 responses: @@ -113325,7 +113911,7 @@ paths: application/json: schema: type: array - items: *162 + items: *165 examples: default: value: @@ -113392,7 +113978,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/followers#list-followers-of-a-user parameters: - - *215 + - *217 - *17 - *19 responses: @@ -113404,7 +113990,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: *38 x-github: @@ -113423,7 +114009,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/followers#list-the-people-a-user-follows parameters: - - *215 + - *217 - *17 - *19 responses: @@ -113435,7 +114021,7 @@ paths: type: array items: *4 examples: - default: *287 + default: *289 headers: Link: *38 x-github: @@ -113454,7 +114040,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/followers#check-if-a-user-follows-another-user parameters: - - *215 + - *217 - name: target_user in: path required: true @@ -113481,8 +114067,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/gists/gists#list-gists-for-a-user parameters: - - *215 - - *141 + - *217 + - *144 - *17 - *19 responses: @@ -113492,9 +114078,9 @@ paths: application/json: schema: type: array - items: *142 + items: *145 examples: - default: *143 + default: *146 headers: Link: *38 '422': *15 @@ -113515,7 +114101,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/gpg-keys#list-gpg-keys-for-a-user parameters: - - *215 + - *217 - *17 - *19 responses: @@ -113525,9 +114111,9 @@ paths: application/json: schema: type: array - items: *731 + items: *733 examples: - default: *758 + default: *760 headers: Link: *38 x-github: @@ -113551,7 +114137,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/users#get-contextual-information-for-a-user parameters: - - *215 + - *217 - name: subject_type description: Identifies which additional information you'd like to receive about the person's hovercard. Can be `organization`, `repository`, `issue`, @@ -113623,7 +114209,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#get-a-user-installation-for-the-authenticated-app parameters: - - *215 + - *217 responses: '200': description: Response @@ -113631,7 +114217,7 @@ paths: application/json: schema: *20 examples: - default: *554 + default: *556 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -113649,7 +114235,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/keys#list-public-keys-for-a-user parameters: - - *215 + - *217 - *17 - *19 responses: @@ -113700,7 +114286,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/orgs#list-organizations-for-a-user parameters: - - *215 + - *217 - *17 - *19 responses: @@ -113712,7 +114298,7 @@ paths: type: array items: *57 examples: - default: *740 + default: *742 headers: Link: *38 x-github: @@ -113751,8 +114337,8 @@ paths: - docker - nuget - container - - *741 - - *215 + - *743 + - *217 - *19 - *17 responses: @@ -113762,12 +114348,12 @@ paths: application/json: schema: type: array - items: *299 + items: *301 examples: - default: *742 + default: *744 '403': *27 '401': *23 - '400': *743 + '400': *745 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -113787,17 +114373,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#get-a-package-for-a-user parameters: - - *301 - - *302 - - *215 + - *303 + - *304 + - *217 responses: '200': description: Response content: application/json: - schema: *299 + schema: *301 examples: - default: *759 + default: *761 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -113818,9 +114404,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#delete-a-package-for-a-user parameters: - - *301 - - *302 - - *215 + - *303 + - *304 + - *217 responses: '204': description: Response @@ -113852,9 +114438,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#restore-a-package-for-a-user parameters: - - *301 - - *302 - - *215 + - *303 + - *304 + - *217 - name: token description: package token schema: @@ -113886,9 +114472,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#list-package-versions-for-a-package-owned-by-a-user parameters: - - *301 - - *302 - - *215 + - *303 + - *304 + - *217 responses: '200': description: Response @@ -113896,7 +114482,7 @@ paths: application/json: schema: type: array - items: *303 + items: *305 examples: default: value: @@ -113954,16 +114540,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#get-a-package-version-for-a-user parameters: - - *301 - - *302 + - *303 - *304 - - *215 + - *306 + - *217 responses: '200': description: Response content: application/json: - schema: *303 + schema: *305 examples: default: value: @@ -113998,10 +114584,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#delete-package-version-for-a-user parameters: - - *301 - - *302 - - *215 + - *303 - *304 + - *217 + - *306 responses: '204': description: Response @@ -114033,10 +114619,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#restore-package-version-for-a-user parameters: - - *301 - - *302 - - *215 + - *303 - *304 + - *217 + - *306 responses: '204': description: Response @@ -114062,7 +114648,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/projects#list-user-projects parameters: - - *215 + - *217 - name: state description: Indicates the state of the projects to return. in: query @@ -114083,7 +114669,7 @@ paths: application/json: schema: type: array - items: *315 + items: *317 examples: default: value: @@ -114145,7 +114731,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/events#list-events-received-by-the-authenticated-user parameters: - - *215 + - *217 - *17 - *19 responses: @@ -114155,7 +114741,7 @@ paths: application/json: schema: type: array - items: *162 + items: *165 examples: default: value: @@ -114234,7 +114820,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/events#list-public-events-received-by-a-user parameters: - - *215 + - *217 - *17 - *19 responses: @@ -114244,7 +114830,7 @@ paths: application/json: schema: type: array - items: *162 + items: *165 examples: default: value: @@ -114321,7 +114907,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#list-repositories-for-a-user parameters: - - *215 + - *217 - name: type description: Limit results to repositories of the specified type. in: query @@ -114364,9 +114950,9 @@ paths: application/json: schema: type: array - items: *193 + items: *195 examples: - default: *305 + default: *307 headers: Link: *38 x-github: @@ -114390,15 +114976,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/billing/billing#get-github-actions-billing-for-a-user parameters: - - *215 + - *217 responses: '200': description: Response content: application/json: - schema: *336 + schema: *338 examples: - default: *337 + default: *339 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -114420,15 +115006,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/billing/billing#get-github-packages-billing-for-a-user parameters: - - *215 + - *217 responses: '200': description: Response content: application/json: - schema: *341 + schema: *343 examples: - default: *342 + default: *344 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -114450,15 +115036,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/billing/billing#get-shared-storage-billing-for-a-user parameters: - - *215 + - *217 responses: '200': description: Response content: application/json: - schema: *343 + schema: *345 examples: - default: *344 + default: *346 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -114478,11 +115064,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/billing/enhanced-billing#get-billing-usage-report-for-a-user parameters: - - *215 - - *168 - - *169 + - *217 - *170 - *171 + - *172 + - *173 responses: '200': description: Response when getting a billing usage report @@ -114552,8 +115138,8 @@ paths: repositoryName: user/example '400': *14 '403': *27 - '500': *83 - '503': *130 + '500': *86 + '503': *133 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -114571,7 +115157,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/social-accounts#list-social-accounts-for-a-user parameters: - - *215 + - *217 - *17 - *19 responses: @@ -114581,9 +115167,9 @@ paths: application/json: schema: type: array - items: *746 + items: *748 examples: - default: *747 + default: *749 headers: Link: *38 x-github: @@ -114603,7 +115189,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/ssh-signing-keys#list-ssh-signing-keys-for-a-user parameters: - - *215 + - *217 - *17 - *19 responses: @@ -114613,9 +115199,9 @@ paths: application/json: schema: type: array - items: *748 + items: *750 examples: - default: *760 + default: *762 headers: Link: *38 x-github: @@ -114639,9 +115225,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/starring#list-repositories-starred-by-a-user parameters: - - *215 - - *761 - - *86 + - *217 + - *763 + - *89 - *17 - *19 responses: @@ -114652,11 +115238,11 @@ paths: schema: anyOf: - type: array - items: *762 + items: *764 - type: array items: *62 examples: - default-response: *751 + default-response: *753 headers: Link: *38 x-github: @@ -114675,7 +115261,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/watching#list-repositories-watched-by-a-user parameters: - - *215 + - *217 - *17 - *19 responses: @@ -114685,9 +115271,9 @@ paths: application/json: schema: type: array - items: *193 + items: *195 examples: - default: *305 + default: *307 headers: Link: *38 x-github: @@ -114816,7 +115402,7 @@ webhooks: type: string enum: - disabled - enterprise: &763 + enterprise: &765 title: Enterprise description: |- An enterprise on GitHub. Webhook payloads contain the `enterprise` property when the webhook is configured @@ -114885,7 +115471,7 @@ webhooks: - created_at - updated_at - avatar_url - installation: &764 + installation: &766 title: Simple Installation description: |- The GitHub App installation. Webhook payloads contain the `installation` property when the event is configured @@ -114906,7 +115492,7 @@ webhooks: required: - id - node_id - organization: &765 + organization: &767 title: Organization Simple description: |- A GitHub organization. Webhook payloads contain the `organization` property when the webhook is configured for an @@ -114979,7 +115565,7 @@ webhooks: - public_members_url - avatar_url - description - repository: &766 + repository: &768 title: Repository description: |- The repository on GitHub where the event occurred. Webhook payloads contain the `repository` property @@ -115008,7 +115594,7 @@ webhooks: license: anyOf: - type: 'null' - - *152 + - *155 organization: anyOf: - type: 'null' @@ -115892,10 +116478,10 @@ webhooks: type: string enum: - enabled - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -115971,11 +116557,11 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - rule: &767 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + rule: &769 title: branch protection rule description: The branch protection rule. Includes a `name` and all the [branch protection settings](https://docs.github.com/enterprise-cloud@latest//github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches#about-branch-protection-settings) @@ -116198,11 +116784,11 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - rule: *767 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + rule: *769 sender: *4 required: - action @@ -116390,11 +116976,11 @@ webhooks: - everyone required: - from - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - rule: *767 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + rule: *769 sender: *4 required: - action @@ -116465,7 +117051,7 @@ webhooks: required: true content: application/json: - schema: &770 + schema: &772 title: Exemption request cancellation event type: object properties: @@ -116473,11 +117059,11 @@ webhooks: type: string enum: - cancelled - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - exemption_request: &768 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + exemption_request: &770 title: Exemption Request description: A request from a user to be exempted from a set of rules. @@ -116715,7 +117301,7 @@ webhooks: - array - 'null' description: The responses to the exemption request. - items: &769 + items: &771 title: Exemption response description: A response to an exemption request by a delegated bypasser. @@ -116825,7 +117411,7 @@ webhooks: required: true content: application/json: - schema: &771 + schema: &773 title: Exemption request completed event type: object properties: @@ -116833,11 +117419,11 @@ webhooks: type: string enum: - completed - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - exemption_request: *768 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + exemption_request: *770 sender: *4 required: - action @@ -116907,7 +117493,7 @@ webhooks: required: true content: application/json: - schema: &772 + schema: &774 title: Exemption request created event type: object properties: @@ -116915,11 +117501,11 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - exemption_request: *768 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + exemption_request: *770 sender: *4 required: - action @@ -116989,7 +117575,7 @@ webhooks: required: true content: application/json: - schema: &773 + schema: &775 title: Exemption response dismissed event type: object properties: @@ -116997,12 +117583,12 @@ webhooks: type: string enum: - response_dismissed - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - exemption_request: *768 - exemption_response: *769 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + exemption_request: *770 + exemption_response: *771 sender: *4 required: - action @@ -117074,7 +117660,7 @@ webhooks: required: true content: application/json: - schema: &774 + schema: &776 title: Exemption response submitted event type: object properties: @@ -117082,12 +117668,12 @@ webhooks: type: string enum: - response_submitted - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - exemption_request: *768 - exemption_response: *769 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + exemption_request: *770 + exemption_response: *771 sender: *4 required: - action @@ -117160,7 +117746,7 @@ webhooks: required: true content: application/json: - schema: *770 + schema: *772 responses: '200': description: Return a 200 status to indicate that the data was received @@ -117227,7 +117813,7 @@ webhooks: required: true content: application/json: - schema: *771 + schema: *773 responses: '200': description: Return a 200 status to indicate that the data was received @@ -117294,7 +117880,7 @@ webhooks: required: true content: application/json: - schema: *772 + schema: *774 responses: '200': description: Return a 200 status to indicate that the data was received @@ -117361,7 +117947,7 @@ webhooks: required: true content: application/json: - schema: *773 + schema: *775 responses: '200': description: Return a 200 status to indicate that the data was received @@ -117429,7 +118015,7 @@ webhooks: required: true content: application/json: - schema: *774 + schema: *776 responses: '200': description: Return a 200 status to indicate that the data was received @@ -117507,7 +118093,7 @@ webhooks: type: string enum: - completed - check_run: &776 + check_run: &778 title: CheckRun description: A check performed on the code of a given code change type: object @@ -117572,8 +118158,8 @@ webhooks: - MDEwOkNoZWNrU3VpdGU1 pull_requests: type: array - items: *440 - repository: *193 + items: *442 + repository: *195 status: type: string enum: @@ -117617,7 +118203,7 @@ webhooks: - examples: - neutral - deployment: *775 + deployment: *777 details_url: type: string examples: @@ -117677,7 +118263,7 @@ webhooks: - annotations_url pull_requests: type: array - items: *440 + items: *442 started_at: type: string format: date-time @@ -117715,9 +118301,9 @@ webhooks: - output - app - pull_requests - installation: *764 - organization: *765 - repository: *766 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - check_run @@ -118110,10 +118696,10 @@ webhooks: type: string enum: - created - check_run: *776 - installation: *764 - organization: *765 - repository: *766 + check_run: *778 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - check_run @@ -118509,10 +119095,10 @@ webhooks: type: string enum: - requested_action - check_run: *776 - installation: *764 - organization: *765 - repository: *766 + check_run: *778 + installation: *766 + organization: *767 + repository: *768 requested_action: description: The action requested by the user. type: object @@ -118917,10 +119503,10 @@ webhooks: type: string enum: - rerequested - check_run: *776 - installation: *764 - organization: *765 - repository: *766 + check_run: *778 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - check_run @@ -119912,10 +120498,10 @@ webhooks: - latest_check_runs_count - check_runs_url - head_commit - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -120600,10 +121186,10 @@ webhooks: - latest_check_runs_count - check_runs_url - head_commit - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -121282,10 +121868,10 @@ webhooks: - latest_check_runs_count - check_runs_url - head_commit - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -121451,7 +122037,7 @@ webhooks: required: - login - id - dismissed_comment: *452 + dismissed_comment: *454 dismissed_reason: description: The reason for dismissing or closing the alert. type: @@ -121603,20 +122189,20 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: &777 + commit_oid: &779 description: The commit SHA of the code scanning alert. When the action is `reopened_by_user` or `closed_by_user`, the event was triggered by the `sender` and this value will be empty. type: string - enterprise: *763 - installation: *764 - organization: *765 - ref: &778 + enterprise: *765 + installation: *766 + organization: *767 + ref: &780 description: The Git reference of the code scanning alert. When the action is `reopened_by_user` or `closed_by_user`, the event was triggered by the `sender` and this value will be empty. type: string - repository: *766 + repository: *768 sender: *4 required: - action @@ -121780,7 +122366,7 @@ webhooks: required: - login - id - dismissed_comment: *452 + dismissed_comment: *454 dismissed_reason: description: The reason for dismissing or closing the alert. type: @@ -122021,12 +122607,12 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: *777 - enterprise: *763 - installation: *764 - organization: *765 - ref: *778 - repository: *766 + commit_oid: *779 + enterprise: *765 + installation: *766 + organization: *767 + ref: *780 + repository: *768 sender: *4 required: - action @@ -122124,7 +122710,7 @@ webhooks: dismissed_by: type: - 'null' - dismissed_comment: *452 + dismissed_comment: *454 dismissed_reason: description: 'The reason for dismissing or closing the alert. Can be one of: `false positive`, `won''t fix`, and `used in @@ -122306,12 +122892,12 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: *777 - enterprise: *763 - installation: *764 - organization: *765 - ref: *778 - repository: *766 + commit_oid: *779 + enterprise: *765 + installation: *766 + organization: *767 + ref: *780 + repository: *768 sender: *4 required: - action @@ -122477,7 +123063,7 @@ webhooks: required: - login - id - dismissed_comment: *452 + dismissed_comment: *454 dismissed_reason: description: The reason for dismissing or closing the alert. type: @@ -122654,12 +123240,12 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: *777 - enterprise: *763 - installation: *764 - organization: *765 - ref: *778 - repository: *766 + commit_oid: *779 + enterprise: *765 + installation: *766 + organization: *767 + ref: *780 + repository: *768 sender: *4 required: - action @@ -122759,7 +123345,7 @@ webhooks: type: - object - 'null' - dismissed_comment: *452 + dismissed_comment: *454 dismissed_reason: description: 'The reason for dismissing or closing the alert. Can be one of: `false positive`, `won''t fix`, and `used in @@ -122939,9 +123525,9 @@ webhooks: type: - string - 'null' - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 ref: description: The Git reference of the code scanning alert. When the action is `reopened_by_user` or `closed_by_user`, the event @@ -122949,7 +123535,7 @@ webhooks: type: - string - 'null' - repository: *766 + repository: *768 sender: *4 required: - action @@ -123045,7 +123631,7 @@ webhooks: dismissed_by: type: - 'null' - dismissed_comment: *452 + dismissed_comment: *454 dismissed_reason: description: 'The reason for dismissing or closing the alert. Can be one of: `false positive`, `won''t fix`, and `used in @@ -123192,12 +123778,12 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: *777 - enterprise: *763 - installation: *764 - organization: *765 - ref: *778 - repository: *766 + commit_oid: *779 + enterprise: *765 + installation: *766 + organization: *767 + ref: *780 + repository: *768 sender: *4 required: - action @@ -123459,10 +124045,10 @@ webhooks: - updated_at - author_association - body - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -123543,18 +124129,18 @@ webhooks: type: - string - 'null' - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 master_branch: description: The name of the repository's default branch (usually `main`). type: string - organization: *765 - pusher_type: &779 + organization: *767 + pusher_type: &781 description: The pusher type for the event. Can be either `user` or a deploy key. type: string - ref: &780 + ref: &782 description: The [`git ref`](https://docs.github.com/enterprise-cloud@latest//rest/git/refs#get-a-reference) resource. type: string @@ -123564,7 +124150,7 @@ webhooks: enum: - tag - branch - repository: *766 + repository: *768 sender: *4 required: - ref @@ -123646,10 +124232,10 @@ webhooks: type: string enum: - created - definition: *112 - enterprise: *763 - installation: *764 - organization: *765 + definition: *115 + enterprise: *765 + installation: *766 + organization: *767 sender: *4 required: - action @@ -123734,9 +124320,9 @@ webhooks: description: The name of the property that was deleted. required: - property_name - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 sender: *4 required: - action @@ -123813,10 +124399,10 @@ webhooks: type: string enum: - promote_to_enterprise - definition: *112 - enterprise: *763 - installation: *764 - organization: *765 + definition: *115 + enterprise: *765 + installation: *766 + organization: *767 sender: *4 required: - action @@ -123893,10 +124479,10 @@ webhooks: type: string enum: - updated - definition: *112 - enterprise: *763 - installation: *764 - organization: *765 + definition: *115 + enterprise: *765 + installation: *766 + organization: *767 sender: *4 required: - action @@ -123973,19 +124559,19 @@ webhooks: type: string enum: - updated - enterprise: *763 - installation: *764 - repository: *766 - organization: *765 + enterprise: *765 + installation: *766 + repository: *768 + organization: *767 sender: *4 new_property_values: type: array description: The new custom property values for the repository. - items: *317 + items: *319 old_property_values: type: array description: The old custom property values for the repository. - items: *317 + items: *319 required: - action - repository @@ -124061,18 +124647,18 @@ webhooks: title: delete event type: object properties: - enterprise: *763 - installation: *764 - organization: *765 - pusher_type: *779 - ref: *780 + enterprise: *765 + installation: *766 + organization: *767 + pusher_type: *781 + ref: *782 ref_type: description: The type of Git ref object deleted in the repository. type: string enum: - tag - branch - repository: *766 + repository: *768 sender: *4 required: - ref @@ -124156,11 +124742,11 @@ webhooks: type: string enum: - auto_dismissed - alert: *504 - installation: *764 - organization: *765 - enterprise: *763 - repository: *766 + alert: *506 + installation: *766 + organization: *767 + enterprise: *765 + repository: *768 sender: *4 required: - action @@ -124244,11 +124830,11 @@ webhooks: type: string enum: - auto_reopened - alert: *504 - installation: *764 - organization: *765 - enterprise: *763 - repository: *766 + alert: *506 + installation: *766 + organization: *767 + enterprise: *765 + repository: *768 sender: *4 required: - action @@ -124332,11 +124918,11 @@ webhooks: type: string enum: - created - alert: *504 - installation: *764 - organization: *765 - enterprise: *763 - repository: *766 + alert: *506 + installation: *766 + organization: *767 + enterprise: *765 + repository: *768 sender: *4 required: - action @@ -124418,11 +125004,11 @@ webhooks: type: string enum: - dismissed - alert: *504 - installation: *764 - organization: *765 - enterprise: *763 - repository: *766 + alert: *506 + installation: *766 + organization: *767 + enterprise: *765 + repository: *768 sender: *4 required: - action @@ -124504,11 +125090,11 @@ webhooks: type: string enum: - fixed - alert: *504 - installation: *764 - organization: *765 - enterprise: *763 - repository: *766 + alert: *506 + installation: *766 + organization: *767 + enterprise: *765 + repository: *768 sender: *4 required: - action @@ -124591,11 +125177,11 @@ webhooks: type: string enum: - reintroduced - alert: *504 - installation: *764 - organization: *765 - enterprise: *763 - repository: *766 + alert: *506 + installation: *766 + organization: *767 + enterprise: *765 + repository: *768 sender: *4 required: - action @@ -124677,11 +125263,11 @@ webhooks: type: string enum: - reopened - alert: *504 - installation: *764 - organization: *765 - enterprise: *763 - repository: *766 + alert: *506 + installation: *766 + organization: *767 + enterprise: *765 + repository: *768 sender: *4 required: - action @@ -124758,9 +125344,9 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - key: &781 + enterprise: *765 + installation: *766 + key: &783 description: The [`deploy key`](https://docs.github.com/enterprise-cloud@latest//rest/deploy-keys/deploy-keys#get-a-deploy-key) resource. type: object @@ -124798,8 +125384,8 @@ webhooks: - verified - created_at - read_only - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -124876,11 +125462,11 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - key: *781 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + key: *783 + organization: *767 + repository: *768 sender: *4 required: - action @@ -125452,12 +126038,12 @@ webhooks: - updated_at - statuses_url - repository_url - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 - workflow: &785 + workflow: &787 title: Workflow type: - object @@ -126195,13 +126781,13 @@ webhooks: description: The URL to review the deployment protection rule. type: string format: uri - deployment: *510 + deployment: *512 pull_requests: type: array - items: *601 - repository: *766 - organization: *765 - installation: *764 + items: *603 + repository: *768 + organization: *767 + installation: *766 sender: *4 responses: '200': @@ -126272,7 +126858,7 @@ webhooks: type: string enum: - approved - approver: &782 + approver: &784 type: object properties: avatar_url: @@ -126315,11 +126901,11 @@ webhooks: type: string comment: type: string - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - reviewers: &783 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + reviewers: &785 type: array items: type: object @@ -126400,7 +126986,7 @@ webhooks: sender: *4 since: type: string - workflow_job_run: &784 + workflow_job_run: &786 type: object properties: conclusion: @@ -127146,18 +127732,18 @@ webhooks: type: string enum: - rejected - approver: *782 + approver: *784 comment: type: string - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - reviewers: *783 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + reviewers: *785 sender: *4 since: type: string - workflow_job_run: *784 + workflow_job_run: *786 workflow_job_runs: type: array items: @@ -127874,13 +128460,13 @@ webhooks: type: string enum: - requested - enterprise: *763 + enterprise: *765 environment: type: string - installation: *764 - organization: *765 - repository: *766 - requestor: &790 + installation: *766 + organization: *767 + repository: *768 + requestor: &792 title: User type: - object @@ -129823,12 +130409,12 @@ webhooks: - updated_at - deployment_url - repository_url - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 - workflow: *785 + workflow: *787 workflow_run: title: Deployment Workflow Run type: @@ -130519,7 +131105,7 @@ webhooks: type: string enum: - answered - answer: &788 + answer: &790 type: object properties: author_association: @@ -130679,7 +131265,7 @@ webhooks: - created_at - updated_at - body - discussion: &786 + discussion: &788 title: Discussion description: A Discussion in a repository. type: object @@ -130975,7 +131561,7 @@ webhooks: - id labels: type: array - items: *564 + items: *566 required: - repository_url - category @@ -130997,10 +131583,10 @@ webhooks: - author_association - active_lock_reason - body - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -131127,11 +131713,11 @@ webhooks: - from required: - category - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -131214,11 +131800,11 @@ webhooks: type: string enum: - closed - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -131300,7 +131886,7 @@ webhooks: type: string enum: - created - comment: &787 + comment: &789 type: object properties: author_association: @@ -131460,11 +132046,11 @@ webhooks: - updated_at - body - reactions - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -131547,12 +132133,12 @@ webhooks: type: string enum: - deleted - comment: *787 - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + comment: *789 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -131647,12 +132233,12 @@ webhooks: - from required: - body - comment: *787 - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + comment: *789 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -131736,11 +132322,11 @@ webhooks: type: string enum: - created - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -131822,11 +132408,11 @@ webhooks: type: string enum: - deleted - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -131926,11 +132512,11 @@ webhooks: type: string required: - from - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -132012,10 +132598,10 @@ webhooks: type: string enum: - labeled - discussion: *786 - enterprise: *763 - installation: *764 - label: &789 + discussion: *788 + enterprise: *765 + installation: *766 + label: &791 title: Label type: object properties: @@ -132048,8 +132634,8 @@ webhooks: - color - default - description - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -132132,11 +132718,11 @@ webhooks: type: string enum: - locked - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -132218,11 +132804,11 @@ webhooks: type: string enum: - pinned - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -132304,11 +132890,11 @@ webhooks: type: string enum: - reopened - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -132393,16 +132979,16 @@ webhooks: changes: type: object properties: - new_discussion: *786 - new_repository: *766 + new_discussion: *788 + new_repository: *768 required: - new_discussion - new_repository - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -132485,10 +133071,10 @@ webhooks: type: string enum: - unanswered - discussion: *786 - old_answer: *788 - organization: *765 - repository: *766 + discussion: *788 + old_answer: *790 + organization: *767 + repository: *768 sender: *4 required: - action @@ -132570,12 +133156,12 @@ webhooks: type: string enum: - unlabeled - discussion: *786 - enterprise: *763 - installation: *764 - label: *789 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + label: *791 + organization: *767 + repository: *768 sender: *4 required: - action @@ -132658,11 +133244,11 @@ webhooks: type: string enum: - unlocked - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -132744,11 +133330,11 @@ webhooks: type: string enum: - unpinned - discussion: *786 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + discussion: *788 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -132817,7 +133403,7 @@ webhooks: required: true content: application/json: - schema: *772 + schema: *774 responses: '200': description: Return a 200 status to indicate that the data was received @@ -132880,7 +133466,7 @@ webhooks: required: true content: application/json: - schema: *774 + schema: *776 responses: '200': description: Return a 200 status to indicate that the data was received @@ -132946,7 +133532,7 @@ webhooks: required: true content: application/json: - schema: *770 + schema: *772 responses: '200': description: Return a 200 status to indicate that the data was received @@ -133012,7 +133598,7 @@ webhooks: required: true content: application/json: - schema: *771 + schema: *773 responses: '200': description: Return a 200 status to indicate that the data was received @@ -133078,7 +133664,7 @@ webhooks: required: true content: application/json: - schema: *772 + schema: *774 responses: '200': description: Return a 200 status to indicate that the data was received @@ -133144,7 +133730,7 @@ webhooks: required: true content: application/json: - schema: *773 + schema: *775 responses: '200': description: Return a 200 status to indicate that the data was received @@ -133210,7 +133796,7 @@ webhooks: required: true content: application/json: - schema: *774 + schema: *776 responses: '200': description: Return a 200 status to indicate that the data was received @@ -133277,7 +133863,7 @@ webhooks: description: A user forks a repository. type: object properties: - enterprise: *763 + enterprise: *765 forkee: description: The created [`repository`](https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#get-a-repository) resource. @@ -133955,9 +134541,9 @@ webhooks: type: integer watchers_count: type: integer - installation: *764 - organization: *765 - repository: *766 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - forkee @@ -134103,9 +134689,9 @@ webhooks: title: gollum event type: object properties: - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 pages: description: The pages that were updated. type: array @@ -134143,7 +134729,7 @@ webhooks: - action - sha - html_url - repository: *766 + repository: *768 sender: *4 required: - pages @@ -134219,10 +134805,10 @@ webhooks: type: string enum: - created - enterprise: *763 + enterprise: *765 installation: *20 - organization: *765 - repositories: &791 + organization: *767 + repositories: &793 description: An array of repository objects that the installation can access. type: array @@ -134248,8 +134834,8 @@ webhooks: - name - full_name - private - repository: *766 - requester: *790 + repository: *768 + requester: *792 sender: *4 required: - action @@ -134324,11 +134910,11 @@ webhooks: type: string enum: - deleted - enterprise: *763 + enterprise: *765 installation: *20 - organization: *765 - repositories: *791 - repository: *766 + organization: *767 + repositories: *793 + repository: *768 requester: type: - 'null' @@ -134405,11 +134991,11 @@ webhooks: type: string enum: - new_permissions_accepted - enterprise: *763 + enterprise: *765 installation: *20 - organization: *765 - repositories: *791 - repository: *766 + organization: *767 + repositories: *793 + repository: *768 requester: type: - 'null' @@ -134486,10 +135072,10 @@ webhooks: type: string enum: - added - enterprise: *763 + enterprise: *765 installation: *20 - organization: *765 - repositories_added: &792 + organization: *767 + repositories_added: &794 description: An array of repository objects, which were added to the installation. type: array @@ -134535,15 +135121,15 @@ webhooks: private: description: Whether the repository is private or public. type: boolean - repository: *766 - repository_selection: &793 + repository: *768 + repository_selection: &795 description: Describe whether all repositories have been selected or there's a selection involved type: string enum: - all - selected - requester: *790 + requester: *792 sender: *4 required: - action @@ -134622,10 +135208,10 @@ webhooks: type: string enum: - removed - enterprise: *763 + enterprise: *765 installation: *20 - organization: *765 - repositories_added: *792 + organization: *767 + repositories_added: *794 repositories_removed: description: An array of repository objects, which were removed from the installation. @@ -134652,9 +135238,9 @@ webhooks: - name - full_name - private - repository: *766 - repository_selection: *793 - requester: *790 + repository: *768 + repository_selection: *795 + requester: *792 sender: *4 required: - action @@ -134733,11 +135319,11 @@ webhooks: type: string enum: - suspend - enterprise: *763 + enterprise: *765 installation: *20 - organization: *765 - repositories: *791 - repository: *766 + organization: *767 + repositories: *793 + repository: *768 requester: type: - 'null' @@ -134920,10 +135506,10 @@ webhooks: type: string required: - from - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 target_type: type: string @@ -135002,11 +135588,11 @@ webhooks: type: string enum: - unsuspend - enterprise: *763 + enterprise: *765 installation: *20 - organization: *765 - repositories: *791 - repository: *766 + organization: *767 + repositories: *793 + repository: *768 requester: type: - 'null' @@ -135254,8 +135840,8 @@ webhooks: - performed_via_github_app - body - reactions - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 issue: description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) the comment belongs to. @@ -136102,7 +136688,7 @@ webhooks: title: description: Title of the issue type: string - type: *282 + type: *284 updated_at: type: string format: date-time @@ -136446,8 +137032,8 @@ webhooks: - state - locked - assignee - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -136527,7 +137113,7 @@ webhooks: type: string enum: - deleted - comment: &794 + comment: &796 title: issue comment description: The [comment](https://docs.github.com/enterprise-cloud@latest//rest/issues/comments#get-an-issue-comment) itself. @@ -136694,8 +137280,8 @@ webhooks: - performed_via_github_app - body - reactions - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 issue: description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) the comment belongs to. @@ -137538,7 +138124,7 @@ webhooks: title: description: Title of the issue type: string - type: *282 + type: *284 updated_at: type: string format: date-time @@ -137884,8 +138470,8 @@ webhooks: - state - locked - assignee - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -137965,7 +138551,7 @@ webhooks: type: string enum: - edited - changes: &819 + changes: &821 description: The changes to the comment. type: object properties: @@ -137977,9 +138563,9 @@ webhooks: type: string required: - from - comment: *794 - enterprise: *763 - installation: *764 + comment: *796 + enterprise: *765 + installation: *766 issue: description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) the comment belongs to. @@ -138825,7 +139411,7 @@ webhooks: title: description: Title of the issue type: string - type: *282 + type: *284 updated_at: type: string format: date-time @@ -139169,8 +139755,8 @@ webhooks: - state - locked - assignee - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -139252,10 +139838,10 @@ webhooks: type: string enum: - assigned - assignee: *790 - enterprise: *763 - installation: *764 - issue: &797 + assignee: *792 + enterprise: *765 + installation: *766 + issue: &799 title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) itself. @@ -140097,7 +140683,7 @@ webhooks: title: description: Title of the issue type: string - type: *282 + type: *284 updated_at: type: string format: date-time @@ -140200,8 +140786,8 @@ webhooks: - active_lock_reason - body - reactions - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -140281,8 +140867,8 @@ webhooks: type: string enum: - closed - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 issue: description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) itself. @@ -141129,7 +141715,7 @@ webhooks: title: description: Title of the issue type: string - type: *282 + type: *284 updated_at: type: string format: date-time @@ -141375,8 +141961,8 @@ webhooks: required: - state - closed_at - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -141455,8 +142041,8 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -142294,7 +142880,7 @@ webhooks: title: description: Title of the issue type: string - type: *282 + type: *284 updated_at: type: string format: date-time @@ -142396,8 +142982,8 @@ webhooks: - active_lock_reason - body - reactions - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -142476,8 +143062,8 @@ webhooks: type: string enum: - demilestoned - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -143338,7 +143924,7 @@ webhooks: title: description: Title of the issue type: string - type: *282 + type: *284 updated_at: type: string format: date-time @@ -143419,7 +144005,7 @@ webhooks: format: uri user_view_type: type: string - milestone: &795 + milestone: &797 title: Milestone description: A collection of related issues and pull requests. type: object @@ -143562,8 +144148,8 @@ webhooks: - updated_at - due_on - closed_at - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -143662,8 +144248,8 @@ webhooks: type: string required: - from - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -144502,7 +145088,7 @@ webhooks: timeline_url: type: string format: uri - type: *282 + type: *284 title: description: Title of the issue type: string @@ -144608,9 +145194,9 @@ webhooks: - active_lock_reason - body - reactions - label: *789 - organization: *765 - repository: *766 + label: *791 + organization: *767 + repository: *768 sender: *4 required: - action @@ -144690,8 +145276,8 @@ webhooks: type: string enum: - labeled - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -145529,7 +146115,7 @@ webhooks: timeline_url: type: string format: uri - type: *282 + type: *284 title: description: Title of the issue type: string @@ -145635,9 +146221,9 @@ webhooks: - active_lock_reason - body - reactions - label: *789 - organization: *765 - repository: *766 + label: *791 + organization: *767 + repository: *768 sender: *4 required: - action @@ -145717,8 +146303,8 @@ webhooks: type: string enum: - locked - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -146581,7 +147167,7 @@ webhooks: timeline_url: type: string format: uri - type: *282 + type: *284 title: description: Title of the issue type: string @@ -146664,8 +147250,8 @@ webhooks: format: uri user_view_type: type: string - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -146744,8 +147330,8 @@ webhooks: type: string enum: - milestoned - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -147605,7 +148191,7 @@ webhooks: title: description: Title of the issue type: string - type: *282 + type: *284 updated_at: type: string format: date-time @@ -147685,9 +148271,9 @@ webhooks: format: uri user_view_type: type: string - milestone: *795 - organization: *765 - repository: *766 + milestone: *797 + organization: *767 + repository: *768 sender: *4 required: - action @@ -148688,7 +149274,7 @@ webhooks: required: - login - id - type: *282 + type: *284 required: - id - number @@ -149169,8 +149755,8 @@ webhooks: required: - old_issue - old_repository - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -150012,7 +150598,7 @@ webhooks: title: description: Title of the issue type: string - type: *282 + type: *284 updated_at: type: string format: date-time @@ -150114,8 +150700,8 @@ webhooks: - active_lock_reason - body - reactions - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -150195,9 +150781,9 @@ webhooks: type: string enum: - pinned - enterprise: *763 - installation: *764 - issue: &796 + enterprise: *765 + installation: *766 + issue: &798 title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) itself. @@ -151033,7 +151619,7 @@ webhooks: title: description: Title of the issue type: string - type: *282 + type: *284 updated_at: type: string format: date-time @@ -151135,8 +151721,8 @@ webhooks: - active_lock_reason - body - reactions - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -151215,8 +151801,8 @@ webhooks: type: string enum: - reopened - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -152160,9 +152746,9 @@ webhooks: format: uri user_view_type: type: string - type: *282 - organization: *765 - repository: *766 + type: *284 + organization: *767 + repository: *768 sender: *4 required: - action @@ -153081,7 +153667,7 @@ webhooks: title: description: Title of the issue type: string - type: *282 + type: *284 updated_at: type: string format: date-time @@ -153663,11 +154249,11 @@ webhooks: required: - new_issue - new_repository - enterprise: *763 - installation: *764 - issue: *796 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + issue: *798 + organization: *767 + repository: *768 sender: *4 required: - action @@ -153747,12 +154333,12 @@ webhooks: type: string enum: - typed - enterprise: *763 - installation: *764 - issue: *797 - type: *282 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + issue: *799 + type: *284 + organization: *767 + repository: *768 sender: *4 required: - action @@ -153833,7 +154419,7 @@ webhooks: type: string enum: - unassigned - assignee: &822 + assignee: &824 title: User type: - object @@ -153905,11 +154491,11 @@ webhooks: required: - login - id - enterprise: *763 - installation: *764 - issue: *797 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + issue: *799 + organization: *767 + repository: *768 sender: *4 required: - action @@ -153988,12 +154574,12 @@ webhooks: type: string enum: - unlabeled - enterprise: *763 - installation: *764 - issue: *797 - label: *789 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + issue: *799 + label: *791 + organization: *767 + repository: *768 sender: *4 required: - action @@ -154073,8 +154659,8 @@ webhooks: type: string enum: - unlocked - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -154938,7 +155524,7 @@ webhooks: title: description: Title of the issue type: string - type: *282 + type: *284 updated_at: type: string format: date-time @@ -155018,8 +155604,8 @@ webhooks: format: uri user_view_type: type: string - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -155099,11 +155685,11 @@ webhooks: type: string enum: - unpinned - enterprise: *763 - installation: *764 - issue: *796 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + issue: *798 + organization: *767 + repository: *768 sender: *4 required: - action @@ -155182,12 +155768,12 @@ webhooks: type: string enum: - untyped - enterprise: *763 - installation: *764 - issue: *797 - type: *282 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + issue: *799 + type: *284 + organization: *767 + repository: *768 sender: *4 required: - action @@ -155267,11 +155853,11 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - label: *789 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + label: *791 + organization: *767 + repository: *768 sender: *4 required: - action @@ -155349,11 +155935,11 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - label: *789 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + label: *791 + organization: *767 + repository: *768 sender: *4 required: - action @@ -155463,11 +156049,11 @@ webhooks: type: string required: - from - enterprise: *763 - installation: *764 - label: *789 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + label: *791 + organization: *767 + repository: *768 sender: *4 required: - action @@ -155549,9 +156135,9 @@ webhooks: - cancelled effective_date: type: string - enterprise: *763 - installation: *764 - marketplace_purchase: &798 + enterprise: *765 + installation: *766 + marketplace_purchase: &800 title: Marketplace Purchase type: object required: @@ -155639,8 +156225,8 @@ webhooks: type: integer unit_count: type: integer - organization: *765 - previous_marketplace_purchase: &799 + organization: *767 + previous_marketplace_purchase: &801 title: Marketplace Purchase type: object properties: @@ -155724,7 +156310,7 @@ webhooks: - on_free_trial - free_trial_ends_on - plan - repository: *766 + repository: *768 sender: *4 required: - action @@ -155804,10 +156390,10 @@ webhooks: - changed effective_date: type: string - enterprise: *763 - installation: *764 - marketplace_purchase: *798 - organization: *765 + enterprise: *765 + installation: *766 + marketplace_purchase: *800 + organization: *767 previous_marketplace_purchase: title: Marketplace Purchase type: object @@ -155895,7 +156481,7 @@ webhooks: - on_free_trial - free_trial_ends_on - plan - repository: *766 + repository: *768 sender: *4 required: - action @@ -155977,10 +156563,10 @@ webhooks: - pending_change effective_date: type: string - enterprise: *763 - installation: *764 - marketplace_purchase: *798 - organization: *765 + enterprise: *765 + installation: *766 + marketplace_purchase: *800 + organization: *767 previous_marketplace_purchase: title: Marketplace Purchase type: object @@ -156066,7 +156652,7 @@ webhooks: - on_free_trial - free_trial_ends_on - plan - repository: *766 + repository: *768 sender: *4 required: - action @@ -156147,8 +156733,8 @@ webhooks: - pending_change_cancelled effective_date: type: string - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 marketplace_purchase: title: Marketplace Purchase type: object @@ -156234,9 +156820,9 @@ webhooks: type: integer unit_count: type: integer - organization: *765 - previous_marketplace_purchase: *799 - repository: *766 + organization: *767 + previous_marketplace_purchase: *801 + repository: *768 sender: *4 required: - action @@ -156316,12 +156902,12 @@ webhooks: - purchased effective_date: type: string - enterprise: *763 - installation: *764 - marketplace_purchase: *798 - organization: *765 - previous_marketplace_purchase: *799 - repository: *766 + enterprise: *765 + installation: *766 + marketplace_purchase: *800 + organization: *767 + previous_marketplace_purchase: *801 + repository: *768 sender: *4 required: - action @@ -156423,11 +157009,11 @@ webhooks: type: string required: - to - enterprise: *763 - installation: *764 - member: *790 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + member: *792 + organization: *767 + repository: *768 sender: *4 required: - action @@ -156529,11 +157115,11 @@ webhooks: type: - string - 'null' - enterprise: *763 - installation: *764 - member: *790 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + member: *792 + organization: *767 + repository: *768 sender: *4 required: - action @@ -156612,11 +157198,11 @@ webhooks: type: string enum: - removed - enterprise: *763 - installation: *764 - member: *790 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + member: *792 + organization: *767 + repository: *768 sender: *4 required: - action @@ -156694,11 +157280,11 @@ webhooks: type: string enum: - added - enterprise: *763 - installation: *764 - member: *790 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + member: *792 + organization: *767 + repository: *768 scope: description: The scope of the membership. Currently, can only be `team`. @@ -156776,7 +157362,7 @@ webhooks: required: - login - id - team: &800 + team: &802 title: Team description: Groups of organization members that gives permissions on specified repositories. @@ -156969,11 +157555,11 @@ webhooks: type: string enum: - removed - enterprise: *763 - installation: *764 - member: *790 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + member: *792 + organization: *767 + repository: *768 scope: description: The scope of the membership. Currently, can only be `team`. @@ -157052,7 +157638,7 @@ webhooks: required: - login - id - team: *800 + team: *802 required: - action - scope @@ -157134,8 +157720,8 @@ webhooks: type: string enum: - checks_requested - installation: *764 - merge_group: &801 + installation: *766 + merge_group: &803 type: object title: Merge Group description: A group of pull requests that the merge queue has grouped @@ -157154,15 +157740,15 @@ webhooks: description: The full ref of the branch the merge group will be merged into. type: string - head_commit: *444 + head_commit: *446 required: - head_sha - head_ref - base_sha - base_ref - head_commit - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -157248,10 +157834,10 @@ webhooks: - merged - invalidated - dequeued - installation: *764 - merge_group: *801 - organization: *765 - repository: *766 + installation: *766 + merge_group: *803 + organization: *767 + repository: *768 sender: *4 required: - action @@ -157324,7 +157910,7 @@ webhooks: type: string enum: - deleted - enterprise: *763 + enterprise: *765 hook: description: 'The deleted webhook. This will contain different keys based on the type of webhook it is: repository, organization, @@ -157433,12 +158019,12 @@ webhooks: hook_id: description: The id of the modified webhook. type: integer - installation: *764 - organization: *765 + installation: *766 + organization: *767 repository: anyOf: - type: 'null' - - *766 + - *768 sender: *4 required: - action @@ -157518,11 +158104,11 @@ webhooks: type: string enum: - closed - enterprise: *763 - installation: *764 - milestone: *795 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + milestone: *797 + organization: *767 + repository: *768 sender: *4 required: - action @@ -157601,9 +158187,9 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - milestone: &802 + enterprise: *765 + installation: *766 + milestone: &804 title: Milestone description: A collection of related issues and pull requests. type: object @@ -157745,8 +158331,8 @@ webhooks: - updated_at - due_on - closed_at - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -157825,11 +158411,11 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - milestone: *795 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + milestone: *797 + organization: *767 + repository: *768 sender: *4 required: - action @@ -157939,11 +158525,11 @@ webhooks: type: string required: - from - enterprise: *763 - installation: *764 - milestone: *795 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + milestone: *797 + organization: *767 + repository: *768 sender: *4 required: - action @@ -158023,11 +158609,11 @@ webhooks: type: string enum: - opened - enterprise: *763 - installation: *764 - milestone: *802 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + milestone: *804 + organization: *767 + repository: *768 sender: *4 required: - action @@ -158106,11 +158692,11 @@ webhooks: type: string enum: - blocked - blocked_user: *790 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + blocked_user: *792 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -158189,11 +158775,11 @@ webhooks: type: string enum: - unblocked - blocked_user: *790 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + blocked_user: *792 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -158272,9 +158858,9 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - membership: &803 + enterprise: *765 + installation: *766 + membership: &805 title: Membership description: The membership between the user and the organization. Not present when the action is `member_invited`. @@ -158368,8 +158954,8 @@ webhooks: - role - organization_url - user - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -158447,11 +159033,11 @@ webhooks: type: string enum: - member_added - enterprise: *763 - installation: *764 - membership: *803 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + membership: *805 + organization: *767 + repository: *768 sender: *4 required: - action @@ -158530,8 +159116,8 @@ webhooks: type: string enum: - member_invited - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 invitation: description: The invitation for the user or email if the action is `member_invited`. @@ -158653,10 +159239,10 @@ webhooks: - inviter - team_count - invitation_teams_url - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 - user: *790 + user: *792 required: - action - invitation @@ -158734,11 +159320,11 @@ webhooks: type: string enum: - member_removed - enterprise: *763 - installation: *764 - membership: *803 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + membership: *805 + organization: *767 + repository: *768 sender: *4 required: - action @@ -158825,11 +159411,11 @@ webhooks: properties: from: type: string - enterprise: *763 - installation: *764 - membership: *803 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + membership: *805 + organization: *767 + repository: *768 sender: *4 required: - action @@ -158905,9 +159491,9 @@ webhooks: type: string enum: - published - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 package: description: Information about the package. type: object @@ -159430,7 +160016,7 @@ webhooks: - published_at rubygems_metadata: type: array - items: &804 + items: &806 title: Ruby Gems metadata type: object properties: @@ -159527,7 +160113,7 @@ webhooks: - owner - package_version - registry - repository: *766 + repository: *768 sender: *4 required: - action @@ -159603,9 +160189,9 @@ webhooks: type: string enum: - updated - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 package: description: Information about the package. type: object @@ -159967,7 +160553,7 @@ webhooks: - published_at rubygems_metadata: type: array - items: *804 + items: *806 source_url: type: string format: uri @@ -160038,7 +160624,7 @@ webhooks: - owner - package_version - registry - repository: *766 + repository: *768 sender: *4 required: - action @@ -160219,12 +160805,12 @@ webhooks: - duration - created_at - updated_at - enterprise: *763 + enterprise: *765 id: type: integer - installation: *764 - organization: *765 - repository: *766 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - id @@ -160301,7 +160887,7 @@ webhooks: type: string enum: - approved - personal_access_token_request: &805 + personal_access_token_request: &807 title: Personal Access Token Request description: Details of a Personal Access Token Request. type: object @@ -160451,10 +161037,10 @@ webhooks: - token_expired - token_expires_at - token_last_used_at - enterprise: *763 - organization: *765 + enterprise: *765 + organization: *767 sender: *4 - installation: *764 + installation: *766 required: - action - personal_access_token_request @@ -160531,11 +161117,11 @@ webhooks: type: string enum: - cancelled - personal_access_token_request: *805 - enterprise: *763 - organization: *765 + personal_access_token_request: *807 + enterprise: *765 + organization: *767 sender: *4 - installation: *764 + installation: *766 required: - action - personal_access_token_request @@ -160611,11 +161197,11 @@ webhooks: type: string enum: - created - personal_access_token_request: *805 - enterprise: *763 - organization: *765 + personal_access_token_request: *807 + enterprise: *765 + organization: *767 sender: *4 - installation: *764 + installation: *766 required: - action - personal_access_token_request @@ -160690,11 +161276,11 @@ webhooks: type: string enum: - denied - personal_access_token_request: *805 - organization: *765 - enterprise: *763 + personal_access_token_request: *807 + organization: *767 + enterprise: *765 sender: *4 - installation: *764 + installation: *766 required: - action - personal_access_token_request @@ -160799,7 +161385,7 @@ webhooks: id: description: Unique identifier of the webhook. type: integer - last_response: *806 + last_response: *808 name: description: The type of webhook. The only valid value is 'web'. type: string @@ -160831,8 +161417,8 @@ webhooks: hook_id: description: The ID of the webhook that triggered the ping. type: integer - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 zen: description: Random string of GitHub zen. @@ -161077,10 +161663,10 @@ webhooks: - from required: - note - enterprise: *763 - installation: *764 - organization: *765 - project_card: &807 + enterprise: *765 + installation: *766 + organization: *767 + project_card: &809 title: Project Card type: object properties: @@ -161203,7 +161789,7 @@ webhooks: - creator - created_at - updated_at - repository: *766 + repository: *768 sender: *4 required: - action @@ -161284,11 +161870,11 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - organization: *765 - project_card: *807 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + project_card: *809 + repository: *768 sender: *4 required: - action @@ -161368,9 +161954,9 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 project_card: title: Project Card type: object @@ -161500,7 +162086,7 @@ webhooks: repository: anyOf: - type: 'null' - - *766 + - *768 sender: *4 required: - action @@ -161594,11 +162180,11 @@ webhooks: - from required: - note - enterprise: *763 - installation: *764 - organization: *765 - project_card: *807 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + project_card: *809 + repository: *768 sender: *4 required: - action @@ -161692,9 +162278,9 @@ webhooks: - from required: - column_id - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 project_card: allOf: - title: Project Card @@ -161891,7 +162477,7 @@ webhooks: type: string required: - after_id - repository: *766 + repository: *768 sender: *4 required: - action @@ -161971,10 +162557,10 @@ webhooks: type: string enum: - closed - enterprise: *763 - installation: *764 - organization: *765 - project: &809 + enterprise: *765 + installation: *766 + organization: *767 + project: &811 title: Project type: object properties: @@ -162101,7 +162687,7 @@ webhooks: - creator - created_at - updated_at - repository: *766 + repository: *768 sender: *4 required: - action @@ -162181,10 +162767,10 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - organization: *765 - project_column: &808 + enterprise: *765 + installation: *766 + organization: *767 + project_column: &810 title: Project Column type: object properties: @@ -162224,7 +162810,7 @@ webhooks: - name - created_at - updated_at - repository: *766 + repository: *768 sender: *4 required: - action @@ -162303,14 +162889,14 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - organization: *765 - project_column: *808 + enterprise: *765 + installation: *766 + organization: *767 + project_column: *810 repository: anyOf: - type: 'null' - - *766 + - *768 sender: *4 required: - action @@ -162399,11 +162985,11 @@ webhooks: type: string required: - from - enterprise: *763 - installation: *764 - organization: *765 - project_column: *808 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + project_column: *810 + repository: *768 sender: *4 required: - action @@ -162483,11 +163069,11 @@ webhooks: type: string enum: - moved - enterprise: *763 - installation: *764 - organization: *765 - project_column: *808 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + project_column: *810 + repository: *768 sender: *4 required: - action @@ -162567,11 +163153,11 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - organization: *765 - project: *809 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + project: *811 + repository: *768 sender: *4 required: - action @@ -162651,14 +163237,14 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - organization: *765 - project: *809 + enterprise: *765 + installation: *766 + organization: *767 + project: *811 repository: anyOf: - type: 'null' - - *766 + - *768 sender: *4 required: - action @@ -162759,11 +163345,11 @@ webhooks: type: string required: - from - enterprise: *763 - installation: *764 - organization: *765 - project: *809 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + project: *811 + repository: *768 sender: *4 required: - action @@ -162842,11 +163428,11 @@ webhooks: type: string enum: - reopened - enterprise: *763 - installation: *764 - organization: *765 - project: *809 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + project: *811 + repository: *768 sender: *4 required: - action @@ -162927,9 +163513,9 @@ webhooks: type: string enum: - closed - installation: *764 - organization: *765 - projects_v2: &810 + installation: *766 + organization: *767 + projects_v2: &812 title: Projects v2 Project description: A projects v2 project type: object @@ -163077,9 +163663,9 @@ webhooks: type: string enum: - created - installation: *764 - organization: *765 - projects_v2: *810 + installation: *766 + organization: *767 + projects_v2: *812 sender: *4 required: - action @@ -163160,9 +163746,9 @@ webhooks: type: string enum: - deleted - installation: *764 - organization: *765 - projects_v2: *810 + installation: *766 + organization: *767 + projects_v2: *812 sender: *4 required: - action @@ -163283,9 +163869,9 @@ webhooks: type: string to: type: string - installation: *764 - organization: *765 - projects_v2: *810 + installation: *766 + organization: *767 + projects_v2: *812 sender: *4 required: - action @@ -163368,7 +163954,7 @@ webhooks: type: string enum: - archived - changes: &814 + changes: &816 type: object properties: archived_at: @@ -163384,9 +163970,9 @@ webhooks: - string - 'null' format: date-time - installation: *764 - organization: *765 - projects_v2_item: &811 + installation: *766 + organization: *767 + projects_v2_item: &813 title: Projects v2 Item description: An item belonging to a project type: object @@ -163525,9 +164111,9 @@ webhooks: - 'null' to: type: string - installation: *764 - organization: *765 - projects_v2_item: *811 + installation: *766 + organization: *767 + projects_v2_item: *813 sender: *4 required: - action @@ -163609,9 +164195,9 @@ webhooks: type: string enum: - created - installation: *764 - organization: *765 - projects_v2_item: *811 + installation: *766 + organization: *767 + projects_v2_item: *813 sender: *4 required: - action @@ -163692,9 +164278,9 @@ webhooks: type: string enum: - deleted - installation: *764 - organization: *765 - projects_v2_item: *811 + installation: *766 + organization: *767 + projects_v2_item: *813 sender: *4 required: - action @@ -163799,7 +164385,7 @@ webhooks: oneOf: - type: string - type: integer - - &812 + - &814 title: Projects v2 Single Select Option description: An option for a single select field type: object @@ -163819,7 +164405,7 @@ webhooks: required: - id - name - - &813 + - &815 title: Projects v2 Iteration Setting description: An iteration setting for an iteration field type: object @@ -163848,8 +164434,8 @@ webhooks: oneOf: - type: string - type: integer - - *812 - - *813 + - *814 + - *815 type: - 'null' - string @@ -163872,9 +164458,9 @@ webhooks: - 'null' required: - body - installation: *764 - organization: *765 - projects_v2_item: *811 + installation: *766 + organization: *767 + projects_v2_item: *813 sender: *4 required: - action @@ -163971,9 +164557,9 @@ webhooks: type: - string - 'null' - installation: *764 - organization: *765 - projects_v2_item: *811 + installation: *766 + organization: *767 + projects_v2_item: *813 sender: *4 required: - action @@ -164056,10 +164642,10 @@ webhooks: type: string enum: - restored - changes: *814 - installation: *764 - organization: *765 - projects_v2_item: *811 + changes: *816 + installation: *766 + organization: *767 + projects_v2_item: *813 sender: *4 required: - action @@ -164141,9 +164727,9 @@ webhooks: type: string enum: - reopened - installation: *764 - organization: *765 - projects_v2: *810 + installation: *766 + organization: *767 + projects_v2: *812 sender: *4 required: - action @@ -164224,9 +164810,9 @@ webhooks: type: string enum: - created - installation: *764 - organization: *765 - projects_v2_status_update: &815 + installation: *766 + organization: *767 + projects_v2_status_update: &817 title: Projects v2 Status Update description: An status update belonging to a project type: object @@ -164361,9 +164947,9 @@ webhooks: type: string enum: - deleted - installation: *764 - organization: *765 - projects_v2_status_update: *815 + installation: *766 + organization: *767 + projects_v2_status_update: *817 sender: *4 required: - action @@ -164509,9 +165095,9 @@ webhooks: - string - 'null' format: date - installation: *764 - organization: *765 - projects_v2_status_update: *815 + installation: *766 + organization: *767 + projects_v2_status_update: *817 sender: *4 required: - action @@ -164582,10 +165168,10 @@ webhooks: title: public event type: object properties: - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - repository @@ -164662,13 +165248,13 @@ webhooks: type: string enum: - assigned - assignee: *790 - enterprise: *763 - installation: *764 - number: &816 + assignee: *792 + enterprise: *765 + installation: *766 + number: &818 description: The pull request number. type: integer - organization: *765 + organization: *767 pull_request: title: Pull Request type: object @@ -167017,7 +167603,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 sender: *4 required: - action @@ -167099,11 +167685,11 @@ webhooks: type: string enum: - auto_merge_disabled - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 number: type: integer - organization: *765 + organization: *767 pull_request: title: Pull Request type: object @@ -169445,7 +170031,7 @@ webhooks: - draft reason: type: string - repository: *766 + repository: *768 sender: *4 required: - action @@ -169527,11 +170113,11 @@ webhooks: type: string enum: - auto_merge_enabled - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 number: type: integer - organization: *765 + organization: *767 pull_request: title: Pull Request type: object @@ -171873,7 +172459,7 @@ webhooks: - draft reason: type: string - repository: *766 + repository: *768 sender: *4 required: - action @@ -171955,13 +172541,13 @@ webhooks: type: string enum: - closed - enterprise: *763 - installation: *764 - number: *816 - organization: *765 - pull_request: &817 + enterprise: *765 + installation: *766 + number: *818 + organization: *767 + pull_request: &819 allOf: - - *601 + - *603 - type: object properties: allow_auto_merge: @@ -172023,7 +172609,7 @@ webhooks: Please use `squash_merge_commit_title` instead.** type: boolean default: false - repository: *766 + repository: *768 sender: *4 required: - action @@ -172104,12 +172690,12 @@ webhooks: type: string enum: - converted_to_draft - enterprise: *763 - installation: *764 - number: *816 - organization: *765 - pull_request: *817 - repository: *766 + enterprise: *765 + installation: *766 + number: *818 + organization: *767 + pull_request: *819 + repository: *768 sender: *4 required: - action @@ -172189,11 +172775,11 @@ webhooks: type: string enum: - demilestoned - enterprise: *763 - milestone: *490 - number: *816 - organization: *765 - pull_request: &818 + enterprise: *765 + milestone: *492 + number: *818 + organization: *767 + pull_request: &820 title: Pull Request type: object properties: @@ -174520,7 +175106,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 sender: *4 required: - action @@ -174599,11 +175185,11 @@ webhooks: type: string enum: - dequeued - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 number: type: integer - organization: *765 + organization: *767 pull_request: title: Pull Request type: object @@ -176949,7 +177535,7 @@ webhooks: - BRANCH_PROTECTIONS - GIT_TREE_INVALID - INVALID_MERGE_COMMIT - repository: *766 + repository: *768 sender: *4 required: - action @@ -177073,12 +177659,12 @@ webhooks: type: string required: - from - enterprise: *763 - installation: *764 - number: *816 - organization: *765 - pull_request: *817 - repository: *766 + enterprise: *765 + installation: *766 + number: *818 + organization: *767 + pull_request: *819 + repository: *768 sender: *4 required: - action @@ -177158,11 +177744,11 @@ webhooks: type: string enum: - enqueued - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 number: type: integer - organization: *765 + organization: *767 pull_request: title: Pull Request type: object @@ -179493,7 +180079,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 sender: *4 required: - action @@ -179573,11 +180159,11 @@ webhooks: type: string enum: - labeled - enterprise: *763 - installation: *764 - label: *789 - number: *816 - organization: *765 + enterprise: *765 + installation: *766 + label: *791 + number: *818 + organization: *767 pull_request: title: Pull Request type: object @@ -181925,7 +182511,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 sender: *4 required: - action @@ -182006,10 +182592,10 @@ webhooks: type: string enum: - locked - enterprise: *763 - installation: *764 - number: *816 - organization: *765 + enterprise: *765 + installation: *766 + number: *818 + organization: *767 pull_request: title: Pull Request type: object @@ -184355,7 +184941,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 sender: *4 required: - action @@ -184435,12 +185021,12 @@ webhooks: type: string enum: - milestoned - enterprise: *763 - milestone: *490 - number: *816 - organization: *765 - pull_request: *818 - repository: *766 + enterprise: *765 + milestone: *492 + number: *818 + organization: *767 + pull_request: *820 + repository: *768 sender: *4 required: - action @@ -184519,12 +185105,12 @@ webhooks: type: string enum: - opened - enterprise: *763 - installation: *764 - number: *816 - organization: *765 - pull_request: *817 - repository: *766 + enterprise: *765 + installation: *766 + number: *818 + organization: *767 + pull_request: *819 + repository: *768 sender: *4 required: - action @@ -184605,12 +185191,12 @@ webhooks: type: string enum: - ready_for_review - enterprise: *763 - installation: *764 - number: *816 - organization: *765 - pull_request: *817 - repository: *766 + enterprise: *765 + installation: *766 + number: *818 + organization: *767 + pull_request: *819 + repository: *768 sender: *4 required: - action @@ -184690,12 +185276,12 @@ webhooks: type: string enum: - reopened - enterprise: *763 - installation: *764 - number: *816 - organization: *765 - pull_request: *817 - repository: *766 + enterprise: *765 + installation: *766 + number: *818 + organization: *767 + pull_request: *819 + repository: *768 sender: *4 required: - action @@ -185070,9 +185656,9 @@ webhooks: - start_side - side - reactions - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 pull_request: type: object properties: @@ -187302,7 +187888,7 @@ webhooks: - _links - author_association - active_lock_reason - repository: *766 + repository: *768 sender: *4 required: - action @@ -187382,7 +187968,7 @@ webhooks: type: string enum: - deleted - comment: &820 + comment: &822 title: Pull Request Review Comment description: The [comment](https://docs.github.com/enterprise-cloud@latest//rest/pulls/comments#get-a-review-comment-for-a-pull-request) itself. @@ -187675,9 +188261,9 @@ webhooks: - start_side - side - reactions - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 pull_request: type: object properties: @@ -189895,7 +190481,7 @@ webhooks: - _links - author_association - active_lock_reason - repository: *766 + repository: *768 sender: *4 required: - action @@ -189975,11 +190561,11 @@ webhooks: type: string enum: - edited - changes: *819 - comment: *820 - enterprise: *763 - installation: *764 - organization: *765 + changes: *821 + comment: *822 + enterprise: *765 + installation: *766 + organization: *767 pull_request: type: object properties: @@ -192200,7 +192786,7 @@ webhooks: - _links - author_association - active_lock_reason - repository: *766 + repository: *768 sender: *4 required: - action @@ -192281,9 +192867,9 @@ webhooks: type: string enum: - dismissed - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 pull_request: title: Simple Pull Request type: object @@ -194516,7 +195102,7 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *766 + repository: *768 review: description: The review that was affected. type: object @@ -194762,9 +195348,9 @@ webhooks: type: string required: - from - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 pull_request: title: Simple Pull Request type: object @@ -196878,8 +197464,8 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *766 - review: &821 + repository: *768 + review: &823 description: The review that was affected. type: object properties: @@ -197112,12 +197698,12 @@ webhooks: type: string enum: - review_request_removed - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 number: description: The pull request number. type: integer - organization: *765 + organization: *767 pull_request: title: Pull Request type: object @@ -199464,7 +200050,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 requested_reviewer: title: User type: @@ -199550,12 +200136,12 @@ webhooks: type: string enum: - review_request_removed - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 number: description: The pull request number. type: integer - organization: *765 + organization: *767 pull_request: title: Pull Request type: object @@ -201909,7 +202495,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 requested_team: title: Team description: Groups of organization members that gives permissions @@ -202104,12 +202690,12 @@ webhooks: type: string enum: - review_requested - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 number: description: The pull request number. type: integer - organization: *765 + organization: *767 pull_request: title: Pull Request type: object @@ -204458,7 +205044,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 requested_reviewer: title: User type: @@ -204545,12 +205131,12 @@ webhooks: type: string enum: - review_requested - enterprise: *763 - installation: *764 + enterprise: *765 + installation: *766 number: description: The pull request number. type: integer - organization: *765 + organization: *767 pull_request: title: Pull Request type: object @@ -206890,7 +207476,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 requested_team: title: Team description: Groups of organization members that gives permissions @@ -207074,9 +207660,9 @@ webhooks: type: string enum: - submitted - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 pull_request: title: Simple Pull Request type: object @@ -209312,8 +209898,8 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *766 - review: *821 + repository: *768 + review: *823 sender: *4 required: - action @@ -209393,9 +209979,9 @@ webhooks: type: string enum: - resolved - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 pull_request: title: Simple Pull Request type: object @@ -211526,7 +212112,7 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *766 + repository: *768 sender: *4 thread: type: object @@ -211918,9 +212504,9 @@ webhooks: type: string enum: - unresolved - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 pull_request: title: Simple Pull Request type: object @@ -214034,7 +214620,7 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *766 + repository: *768 sender: *4 thread: type: object @@ -214428,10 +215014,10 @@ webhooks: type: string before: type: string - enterprise: *763 - installation: *764 - number: *816 - organization: *765 + enterprise: *765 + installation: *766 + number: *818 + organization: *767 pull_request: title: Pull Request type: object @@ -216766,7 +217352,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 sender: *4 required: - action @@ -216848,11 +217434,11 @@ webhooks: type: string enum: - unassigned - assignee: *822 - enterprise: *763 - installation: *764 - number: *816 - organization: *765 + assignee: *824 + enterprise: *765 + installation: *766 + number: *818 + organization: *767 pull_request: title: Pull Request type: object @@ -219202,7 +219788,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 sender: *4 required: - action @@ -219281,11 +219867,11 @@ webhooks: type: string enum: - unlabeled - enterprise: *763 - installation: *764 - label: *789 - number: *816 - organization: *765 + enterprise: *765 + installation: *766 + label: *791 + number: *818 + organization: *767 pull_request: title: Pull Request type: object @@ -221624,7 +222210,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 sender: *4 required: - action @@ -221705,10 +222291,10 @@ webhooks: type: string enum: - unlocked - enterprise: *763 - installation: *764 - number: *816 - organization: *765 + enterprise: *765 + installation: *766 + number: *818 + organization: *767 pull_request: title: Pull Request type: object @@ -224037,7 +224623,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *766 + repository: *768 sender: *4 required: - action @@ -224240,7 +224826,7 @@ webhooks: deleted: description: Whether this push deleted the `ref`. type: boolean - enterprise: *763 + enterprise: *765 forced: description: Whether this push was a force push of the `ref`. type: boolean @@ -224335,8 +224921,8 @@ webhooks: - url - author - committer - installation: *764 - organization: *765 + installation: *766 + organization: *767 pusher: title: Committer description: Metaproperties for Git author/committer information. @@ -224924,9 +225510,9 @@ webhooks: type: string enum: - published - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 registry_package: type: object properties: @@ -225403,7 +225989,7 @@ webhooks: type: string rubygems_metadata: type: array - items: *804 + items: *806 summary: type: string tag_name: @@ -225459,7 +226045,7 @@ webhooks: - owner - package_version - registry - repository: *766 + repository: *768 sender: *4 required: - action @@ -225537,9 +226123,9 @@ webhooks: type: string enum: - updated - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 registry_package: type: object properties: @@ -225851,7 +226437,7 @@ webhooks: - published_at rubygems_metadata: type: array - items: *804 + items: *806 summary: type: string tag_name: @@ -225901,7 +226487,7 @@ webhooks: - owner - package_version - registry - repository: *766 + repository: *768 sender: *4 required: - action @@ -225978,10 +226564,10 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - organization: *765 - release: &823 + enterprise: *765 + installation: *766 + organization: *767 + release: &825 title: Release description: The [release](https://docs.github.com/enterprise-cloud@latest//rest/releases/releases/#get-a-release) object. @@ -226302,7 +226888,7 @@ webhooks: - tarball_url - zipball_url - body - repository: *766 + repository: *768 sender: *4 required: - action @@ -226379,11 +226965,11 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - organization: *765 - release: *823 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + release: *825 + repository: *768 sender: *4 required: - action @@ -226500,11 +227086,11 @@ webhooks: type: boolean required: - to - enterprise: *763 - installation: *764 - organization: *765 - release: *823 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + release: *825 + repository: *768 sender: *4 required: - action @@ -226582,9 +227168,9 @@ webhooks: type: string enum: - prereleased - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 release: title: Release description: The [release](https://docs.github.com/enterprise-cloud@latest//rest/releases/releases/#get-a-release) @@ -226910,7 +227496,7 @@ webhooks: - string - 'null' format: uri - repository: *766 + repository: *768 sender: *4 required: - action @@ -226986,10 +227572,10 @@ webhooks: type: string enum: - published - enterprise: *763 - installation: *764 - organization: *765 - release: &824 + enterprise: *765 + installation: *766 + organization: *767 + release: &826 title: Release description: The [release](https://docs.github.com/enterprise-cloud@latest//rest/releases/releases/#get-a-release) object. @@ -227312,7 +227898,7 @@ webhooks: - string - 'null' format: uri - repository: *766 + repository: *768 sender: *4 required: - action @@ -227388,11 +227974,11 @@ webhooks: type: string enum: - released - enterprise: *763 - installation: *764 - organization: *765 - release: *823 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + release: *825 + repository: *768 sender: *4 required: - action @@ -227468,11 +228054,11 @@ webhooks: type: string enum: - unpublished - enterprise: *763 - installation: *764 - organization: *765 - release: *824 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + release: *826 + repository: *768 sender: *4 required: - action @@ -227548,11 +228134,11 @@ webhooks: type: string enum: - published - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - repository_advisory: *672 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + repository_advisory: *674 sender: *4 required: - action @@ -227628,11 +228214,11 @@ webhooks: type: string enum: - reported - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - repository_advisory: *672 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + repository_advisory: *674 sender: *4 required: - action @@ -227708,10 +228294,10 @@ webhooks: type: string enum: - archived - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -227788,10 +228374,10 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -227869,10 +228455,10 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -227957,10 +228543,10 @@ webhooks: additionalProperties: true description: The `client_payload` that was specified in the `POST /repos/{owner}/{repo}/dispatches` request body. - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -228075,10 +228661,10 @@ webhooks: - 'null' items: type: string - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -228150,10 +228736,10 @@ webhooks: title: repository_import event type: object properties: - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 status: type: string @@ -228234,10 +228820,10 @@ webhooks: type: string enum: - privatized - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -228314,10 +228900,10 @@ webhooks: type: string enum: - publicized - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -228411,10 +228997,10 @@ webhooks: - name required: - repository - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -228494,11 +229080,11 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - repository_ruleset: *126 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + repository_ruleset: *129 sender: *4 required: - action @@ -228576,11 +229162,11 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - repository_ruleset: *126 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + repository_ruleset: *129 sender: *4 required: - action @@ -228658,11 +229244,11 @@ webhooks: type: string enum: - edited - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - repository_ruleset: *126 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + repository_ruleset: *129 changes: type: object properties: @@ -228681,16 +229267,16 @@ webhooks: properties: added: type: array - items: *119 + items: *122 deleted: type: array - items: *119 + items: *122 updated: type: array items: type: object properties: - condition: *119 + condition: *122 changes: type: object properties: @@ -228723,16 +229309,16 @@ webhooks: properties: added: type: array - items: *125 + items: *128 deleted: type: array - items: *125 + items: *128 updated: type: array items: type: object properties: - rule: *125 + rule: *128 changes: type: object properties: @@ -228969,10 +229555,10 @@ webhooks: - from required: - owner - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -229050,10 +229636,10 @@ webhooks: type: string enum: - unarchived - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -229131,7 +229717,7 @@ webhooks: type: string enum: - create - alert: &825 + alert: &827 title: Repository Vulnerability Alert Alert description: The security alert of the vulnerable dependency. type: object @@ -229255,10 +229841,10 @@ webhooks: type: string enum: - open - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -229468,10 +230054,10 @@ webhooks: type: string enum: - dismissed - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -229549,11 +230135,11 @@ webhooks: type: string enum: - reopen - alert: *825 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + alert: *827 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -229755,10 +230341,10 @@ webhooks: enum: - fixed - open - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -229836,17 +230422,17 @@ webhooks: type: string enum: - created - alert: &826 + alert: &828 type: object properties: - number: *96 - created_at: *103 + number: *99 + created_at: *106 updated_at: anyOf: - type: 'null' - - *104 - url: *101 - html_url: *102 + - *107 + url: *104 + html_url: *105 locations_url: type: string format: uri @@ -229946,10 +230532,10 @@ webhooks: - 'null' description: Whether the detected secret was found in multiple repositories in the same organization or business. - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -230030,11 +230616,11 @@ webhooks: type: string enum: - created - alert: *826 - installation: *764 - location: *827 - organization: *765 - repository: *766 + alert: *828 + installation: *766 + location: *829 + organization: *767 + repository: *768 sender: *4 required: - location @@ -230272,11 +230858,11 @@ webhooks: type: string enum: - publicly_leaked - alert: *826 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + alert: *828 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -230354,11 +230940,11 @@ webhooks: type: string enum: - reopened - alert: *826 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + alert: *828 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -230436,11 +231022,11 @@ webhooks: type: string enum: - resolved - alert: *826 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + alert: *828 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -230518,11 +231104,11 @@ webhooks: type: string enum: - validated - alert: *826 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + alert: *828 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -230652,10 +231238,10 @@ webhooks: - organization - enterprise - - repository: *766 - enterprise: *763 - installation: *764 - organization: *765 + repository: *768 + enterprise: *765 + installation: *766 + organization: *767 sender: *4 required: - action @@ -230733,11 +231319,11 @@ webhooks: type: string enum: - published - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - security_advisory: &828 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + security_advisory: &830 description: The details of the security advisory, including summary, description, and severity. type: object @@ -230754,7 +231340,7 @@ webhooks: required: - vector_string - score - cvss_severities: *98 + cvss_severities: *101 cwes: type: array items: @@ -230923,11 +231509,11 @@ webhooks: type: string enum: - updated - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 - security_advisory: *828 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 + security_advisory: *830 sender: *4 required: - action @@ -231000,10 +231586,10 @@ webhooks: type: string enum: - withdrawn - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 security_advisory: description: The details of the security advisory, including summary, description, and severity. @@ -231021,7 +231607,7 @@ webhooks: required: - vector_string - score - cvss_severities: *98 + cvss_severities: *101 cwes: type: array items: @@ -231189,11 +231775,11 @@ webhooks: from: type: object properties: - security_and_analysis: *318 - enterprise: *763 - installation: *764 - organization: *765 - repository: *381 + security_and_analysis: *320 + enterprise: *765 + installation: *766 + organization: *767 + repository: *383 sender: *4 required: - changes @@ -231271,12 +231857,12 @@ webhooks: type: string enum: - cancelled - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 - sponsorship: &829 + sponsorship: &831 type: object properties: created_at: @@ -231581,12 +232167,12 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 - sponsorship: *829 + sponsorship: *831 required: - action - sponsorship @@ -231674,12 +232260,12 @@ webhooks: type: string required: - from - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 - sponsorship: *829 + sponsorship: *831 required: - action - changes @@ -231756,17 +232342,17 @@ webhooks: type: string enum: - pending_cancellation - effective_date: &830 + effective_date: &832 description: The `pending_cancellation` and `pending_tier_change` event types will include the date the cancellation or tier change will take effect. type: string - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 - sponsorship: *829 + sponsorship: *831 required: - action - sponsorship @@ -231840,7 +232426,7 @@ webhooks: type: string enum: - pending_tier_change - changes: &831 + changes: &833 type: object properties: tier: @@ -231884,13 +232470,13 @@ webhooks: - from required: - tier - effective_date: *830 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + effective_date: *832 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 - sponsorship: *829 + sponsorship: *831 required: - action - changes @@ -231967,13 +232553,13 @@ webhooks: type: string enum: - tier_changed - changes: *831 - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + changes: *833 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 - sponsorship: *829 + sponsorship: *831 required: - action - changes @@ -232047,10 +232633,10 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 starred_at: description: 'The time the star was created. This is a timestamp @@ -232134,10 +232720,10 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 starred_at: description: 'The time the star was created. This is a timestamp @@ -232571,15 +233157,15 @@ webhooks: type: - string - 'null' - enterprise: *763 + enterprise: *765 id: description: The unique identifier of the status. type: integer - installation: *764 + installation: *766 name: type: string - organization: *765 - repository: *766 + organization: *767 + repository: *768 sender: *4 sha: description: The Commit SHA. @@ -232689,15 +233275,15 @@ webhooks: parent_issue_id: description: The ID of the parent issue. type: number - parent_issue: *151 + parent_issue: *154 parent_issue_repo: *62 sub_issue_id: description: The ID of the sub-issue. type: number - sub_issue: *151 - installation: *764 - organization: *765 - repository: *766 + sub_issue: *154 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -232781,15 +233367,15 @@ webhooks: parent_issue_id: description: The ID of the parent issue. type: number - parent_issue: *151 + parent_issue: *154 parent_issue_repo: *62 sub_issue_id: description: The ID of the sub-issue. type: number - sub_issue: *151 - installation: *764 - organization: *765 - repository: *766 + sub_issue: *154 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -232873,15 +233459,15 @@ webhooks: sub_issue_id: description: The ID of the sub-issue. type: number - sub_issue: *151 + sub_issue: *154 sub_issue_repo: *62 parent_issue_id: description: The ID of the parent issue. type: number - parent_issue: *151 - installation: *764 - organization: *765 - repository: *766 + parent_issue: *154 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -232965,15 +233551,15 @@ webhooks: sub_issue_id: description: The ID of the sub-issue. type: number - sub_issue: *151 + sub_issue: *154 sub_issue_repo: *62 parent_issue_id: description: The ID of the parent issue. type: number - parent_issue: *151 - installation: *764 - organization: *765 - repository: *766 + parent_issue: *154 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -233050,12 +233636,12 @@ webhooks: title: team_add event type: object properties: - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 - team: &832 + team: &834 title: Team description: Groups of organization members that gives permissions on specified repositories. @@ -233248,9 +233834,9 @@ webhooks: type: string enum: - added_to_repository - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 repository: title: Repository description: A git repository @@ -233720,7 +234306,7 @@ webhooks: - topics - visibility sender: *4 - team: *832 + team: *834 required: - action - team @@ -233796,9 +234382,9 @@ webhooks: type: string enum: - created - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 repository: title: Repository description: A git repository @@ -234268,7 +234854,7 @@ webhooks: - topics - visibility sender: *4 - team: *832 + team: *834 required: - action - team @@ -234345,9 +234931,9 @@ webhooks: type: string enum: - deleted - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 repository: title: Repository description: A git repository @@ -234817,7 +235403,7 @@ webhooks: - topics - visibility sender: *4 - team: *832 + team: *834 required: - action - team @@ -234961,9 +235547,9 @@ webhooks: - from required: - permissions - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 repository: title: Repository description: A git repository @@ -235433,7 +236019,7 @@ webhooks: - topics - visibility sender: *4 - team: *832 + team: *834 required: - action - changes @@ -235511,9 +236097,9 @@ webhooks: type: string enum: - removed_from_repository - enterprise: *763 - installation: *764 - organization: *765 + enterprise: *765 + installation: *766 + organization: *767 repository: title: Repository description: A git repository @@ -235983,7 +236569,7 @@ webhooks: - topics - visibility sender: *4 - team: *832 + team: *834 required: - action - team @@ -236059,10 +236645,10 @@ webhooks: type: string enum: - started - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 required: - action @@ -236135,17 +236721,17 @@ webhooks: title: workflow_dispatch event type: object properties: - enterprise: *763 + enterprise: *765 inputs: type: - object - 'null' additionalProperties: true - installation: *764 - organization: *765 + installation: *766 + organization: *767 ref: type: string - repository: *766 + repository: *768 sender: *4 workflow: type: string @@ -236227,10 +236813,10 @@ webhooks: type: string enum: - completed - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 workflow_job: allOf: @@ -236486,7 +237072,7 @@ webhooks: type: string required: - conclusion - deployment: *510 + deployment: *512 required: - action - repository @@ -236565,10 +237151,10 @@ webhooks: type: string enum: - in_progress - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 workflow_job: allOf: @@ -236850,7 +237436,7 @@ webhooks: required: - status - steps - deployment: *510 + deployment: *512 required: - action - repository @@ -236929,10 +237515,10 @@ webhooks: type: string enum: - queued - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 workflow_job: type: object @@ -237078,7 +237664,7 @@ webhooks: - workflow_name - head_branch - created_at - deployment: *510 + deployment: *512 required: - action - repository @@ -237157,10 +237743,10 @@ webhooks: type: string enum: - waiting - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 workflow_job: type: object @@ -237307,7 +237893,7 @@ webhooks: - workflow_name - head_branch - created_at - deployment: *510 + deployment: *512 required: - action - repository @@ -237387,12 +237973,12 @@ webhooks: type: string enum: - completed - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 - workflow: *785 + workflow: *787 workflow_run: title: Workflow Run type: object @@ -238411,12 +238997,12 @@ webhooks: type: string enum: - in_progress - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 - workflow: *785 + workflow: *787 workflow_run: title: Workflow Run type: object @@ -239420,12 +240006,12 @@ webhooks: type: string enum: - requested - enterprise: *763 - installation: *764 - organization: *765 - repository: *766 + enterprise: *765 + installation: *766 + organization: *767 + repository: *768 sender: *4 - workflow: *785 + workflow: *787 workflow_run: title: Workflow Run type: object diff --git a/descriptions-next/ghec/ghec.2022-11-28.json b/descriptions-next/ghec/ghec.2022-11-28.json index fe1140d7b1..d42d467ac7 100644 --- a/descriptions-next/ghec/ghec.2022-11-28.json +++ b/descriptions-next/ghec/ghec.2022-11-28.json @@ -1056,7 +1056,7 @@ }, "delete": { "summary": "Delete an installation for the authenticated app", - "description": "Uninstalls a GitHub App on a user, organization, or business account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the \"[Suspend an app installation](https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#suspend-an-app-installation)\" endpoint.\n\nYou must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", + "description": "Uninstalls a GitHub App on a user, organization, or enterprise account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the \"[Suspend an app installation](https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#suspend-an-app-installation)\" endpoint.\n\nYou must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", "tags": [ "apps" ], @@ -1089,7 +1089,7 @@ "/app/installations/{installation_id}/access_tokens": { "post": { "summary": "Create an installation access token for an app", - "description": "Creates an installation access token that enables a GitHub App to make authenticated API requests for the app's installation on an organization or individual account. Installation tokens expire one hour from the time you create them. Using an expired token produces a status code of `401 - Unauthorized`, and requires creating a new installation token. By default the installation token has access to all repositories that the installation can access.\n\nOptionally, you can use the `repositories` or `repository_ids` body parameters to specify individual repositories that the installation access token can access. If you don't use `repositories` or `repository_ids` to grant access to specific repositories, the installation access token will have access to all repositories that the installation was granted access to. The installation access token cannot be granted access to repositories that the installation was not granted access to. Up to 500 repositories can be listed in this manner.\n\nOptionally, use the `permissions` body parameter to specify the permissions that the installation access token should have. If `permissions` is not specified, the installation access token will have all of the permissions that were granted to the app. The installation access token cannot be granted permissions that the app was not granted.\n\nYou must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", + "description": "Creates an installation access token that enables a GitHub App to make authenticated API requests for the app's installation on an enterprise, organization, or individual account. Installation tokens expire one hour from the time you create them. Using an expired token produces a status code of `401 - Unauthorized`, and requires creating a new installation token. By default the installation token has access to all repositories that the installation can access.\n\nOptionally, you can use the `repositories` or `repository_ids` body parameters to specify individual repositories that the installation access token can access. If you don't use `repositories` or `repository_ids` to grant access to specific repositories, the installation access token will have access to all repositories that the installation was granted access to. The installation access token cannot be granted access to repositories that the installation was not granted access to. Up to 500 repositories can be listed in this manner.\n\nOptionally, use the `permissions` body parameter to specify the permissions that the installation access token should have. If `permissions` is not specified, the installation access token will have all of the permissions that were granted to the app. The installation access token cannot be granted permissions that the app was not granted.\n\nEnterprise account installations do not have access to repositories and cannot be scoped down using the `permissions` parameter.\n\nYou must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", "tags": [ "apps" ], @@ -1191,7 +1191,7 @@ "/app/installations/{installation_id}/suspended": { "put": { "summary": "Suspend an app installation", - "description": "Suspends a GitHub App on a user, organization, or business account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub Enterprise Cloud API or webhook events is blocked for that account.\n\nYou must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", + "description": "Suspends a GitHub App on a user, organization, or enterprise account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub Enterprise Cloud API or webhook events is blocked for that account.\n\nYou must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", "tags": [ "apps" ], @@ -4944,6 +4944,717 @@ } } }, + "/enterprises/{enterprise}/apps/installable_organizations": { + "get": { + "summary": "Get enterprise-owned organizations that can have GitHub Apps installed", + "description": "List the organizations owned by the enterprise, intended for use by GitHub Apps that are managing applications across the enterprise.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/installable-organizations", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#get-enterprise-owned-organizations-that-can-have-github-apps-installed" + }, + "parameters": [ + { + "$ref": "#/components/parameters/enterprise" + }, + { + "$ref": "#/components/parameters/per-page" + }, + { + "$ref": "#/components/parameters/page" + } + ], + "responses": { + "200": { + "description": "A list of organizations owned by the enterprise on which the authenticated GitHub App is installed.", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/installable-organization" + } + }, + "examples": { + "default": { + "value": [ + { + "id": 1, + "login": "github" + }, + { + "id": 2, + "login": "microsoft" + } + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + } + }, + "/enterprises/{enterprise}/apps/installable_organizations/{org}/accessible_repositories": { + "get": { + "summary": "Get repositories belonging to an enterprise-owned organization", + "description": "List the repositories belonging to an enterprise-owned organization that can be made accessible to a GitHub App installed on that organization. This API provides a shallow list of repositories in the organization, allowing the caller to then add or remove those repositories to an installation in that organization.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/installable-organization-accessible-repositories", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#get-repositories-belonging-to-an-enterprise-owned-organization" + }, + "parameters": [ + { + "$ref": "#/components/parameters/enterprise" + }, + { + "$ref": "#/components/parameters/org" + }, + { + "$ref": "#/components/parameters/per-page" + }, + { + "$ref": "#/components/parameters/page" + } + ], + "responses": { + "200": { + "description": "A list of repositories owned by the enterprise organization on which the authenticated GitHub App is installed.", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/accessible-repository" + } + }, + "examples": { + "default": { + "value": [ + { + "id": 1, + "name": "Hello World", + "full_name": "octocat/Hello-World" + }, + { + "id": 2, + "login": "Goodbye World", + "full_name": "octocat/Goodbye-World" + } + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + } + }, + "/enterprises/{enterprise}/apps/organizations/{org}/installations": { + "get": { + "summary": "List GitHub Apps installed on an enterprise-owned organization", + "description": "Lists the GitHub App installations associated with the given enterprise-owned organization. This lists all GitHub Apps that have been installed on the organization, regardless of who owns the application.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/organization-installations", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#list-github-apps-installed-on-an-enterprise-owned-organization" + }, + "parameters": [ + { + "$ref": "#/components/parameters/enterprise" + }, + { + "$ref": "#/components/parameters/org" + }, + { + "$ref": "#/components/parameters/per-page" + }, + { + "$ref": "#/components/parameters/page" + } + ], + "responses": { + "200": { + "description": "A list of GitHub App installations that have been granted access to the organization", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/enterprise-organization-installation" + } + }, + "examples": { + "default": { + "value": [ + { + "$ref": "#/components/examples/enterprise-organization-installation" + } + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + }, + "post": { + "summary": "Install a GitHub App on an enterprise-owned organization", + "description": "Installs any valid GitHub App on the specified organization owned by the enterprise. If the app is already installed on the organization, and is suspended, it will be unsuspended.\nIf the app has a pending installation request, they will all be approved.\n\nIf the app is already installed and has a pending update request, it will be updated to the latest version. If the app is now requesting repository permissions, it will be given access to the repositories listed in the request or fail if no `repository_selection` is provided.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/create-installation", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#install-a-github-app-on-an-enterprise-owned-organization" + }, + "parameters": [ + { + "$ref": "#/components/parameters/enterprise" + }, + { + "$ref": "#/components/parameters/org" + } + ], + "responses": { + "200": { + "description": "A GitHub App installation that was installed previously.", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/installation" + }, + "examples": { + "default": { + "$ref": "#/components/examples/base-installation" + } + } + } + } + }, + "201": { + "description": "A GitHub App installation.", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/installation" + }, + "examples": { + "default": { + "$ref": "#/components/examples/base-installation" + } + } + } + } + } + }, + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "client_id": { + "type": "string", + "description": "The Client ID of the GitHub App to install." + }, + "repository_selection": { + "type": "string", + "description": "The repository selection for the GitHub App. Must be one of:\n* `all` - the installation can access all repositories in the organization.\n* `selected` - the installation can access only the listed repositories.\n* `none` - no repository permissions are requested. Only use when the app does not request repository permissions.", + "enum": [ + "all", + "selected", + "none" + ] + }, + "repositories": { + "type": "array", + "description": "The names of the repositories to which the installation will be granted access. This is the simple name of the repository, not the full name (e.g., `hello-world` not `octocat/hello-world`). This is only required when `repository_selection` is `selected`.", + "items": { + "type": "string" + }, + "maxItems": 50 + } + }, + "required": [ + "client_id", + "repository_selection" + ] + }, + "examples": { + "default": { + "summary": "Example of installing a GitHub App on an organization and granting access to all of its repositories.", + "value": { + "client_id": "Iv2abc123aabbcc", + "repository_selection": "all" + } + }, + "repository_selection_selected": { + "value": { + "client_id": "Iv2abc123aabbcc", + "repository_selection": "selected", + "repositories": [ + "hello-world", + "hello-world-2" + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + } + }, + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}": { + "delete": { + "summary": "Uninstall a GitHub App from an enterprise-owned organization", + "description": "Uninstall a GitHub App from an organization. Any app installed on the organization can be removed.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/delete-installation", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#uninstall-a-github-app-from-an-enterprise-owned-organization" + }, + "parameters": [ + { + "$ref": "#/components/parameters/enterprise" + }, + { + "$ref": "#/components/parameters/org" + }, + { + "$ref": "#/components/parameters/installation-id" + } + ], + "responses": { + "204": { + "description": "An empty response indicates that the installation was successfully removed." + }, + "404": { + "$ref": "#/components/responses/not_found" + }, + "403": { + "$ref": "#/components/responses/forbidden" + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + } + }, + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}/repositories": { + "get": { + "summary": "Get the repositories accessible to a given GitHub App installation", + "description": "Lists the repositories accessible to a given GitHub App installation on an enterprise-owned organization.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/organization-installation-repositories", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#get-the-repositories-accessible-to-a-given-github-app-installation" + }, + "parameters": [ + { + "$ref": "#/components/parameters/enterprise" + }, + { + "$ref": "#/components/parameters/org" + }, + { + "$ref": "#/components/parameters/installation-id" + }, + { + "$ref": "#/components/parameters/per-page" + }, + { + "$ref": "#/components/parameters/page" + } + ], + "responses": { + "200": { + "description": "A list of repositories owned by the enterprise organization to which the installation has access.", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/accessible-repository" + } + }, + "examples": { + "default": { + "value": [ + { + "id": 1, + "name": "Hello World", + "full_name": "octocat/Hello-World" + }, + { + "id": 2, + "login": "Goodbye World", + "full_name": "octocat/Goodbye-World" + } + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + }, + "patch": { + "summary": "Toggle installation repository access between selected and all repositories", + "description": "Toggle repository access for a GitHub App installation between all repositories and selected repositories. You must provide at least one repository when changing the access to 'selected'. If you change the access to 'all', the repositories list must not be provided.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/change-installation-repository-access-selection", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#toggle-installation-repository-access-between-selected-and-all-repositories" + }, + "parameters": [ + { + "$ref": "#/components/parameters/enterprise" + }, + { + "$ref": "#/components/parameters/org" + }, + { + "$ref": "#/components/parameters/installation-id" + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "repository_selection": { + "type": "string", + "description": "One of either 'all' or 'selected'", + "enum": [ + "all", + "selected" + ] + }, + "repositories": { + "type": "array", + "description": "The repository names to add to the installation. Only required when repository_selection is 'selected'", + "items": { + "type": "string" + }, + "maxItems": 50 + } + }, + "required": [ + "repository_selection" + ] + }, + "examples": { + "default": { + "summary": "Change the repositories accessible to a GitHub App from 'all repositories' to a specified subset.", + "value": { + "repository_selection": "selected", + "repositories": [ + "hello-world", + "hello-world-2" + ] + } + } + } + } + } + }, + "responses": { + "200": { + "description": "The GitHub App installation that was updated.", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/installation" + }, + "examples": { + "default": { + "$ref": "#/components/examples/base-installation" + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + } + }, + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}/repositories/add": { + "patch": { + "summary": "Grant repository access to an organization installation", + "description": "Grant repository access to an organization installation. You can add up to 50 repositories at a time. If the installation already has access to the repository, it will not be added again.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/grant-repository-access-to-installation", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#grant-repository-access-to-an-organization-installation" + }, + "parameters": [ + { + "$ref": "#/components/parameters/enterprise" + }, + { + "$ref": "#/components/parameters/org" + }, + { + "$ref": "#/components/parameters/installation-id" + } + ], + "responses": { + "200": { + "description": "A list of repositories which the authenticated GitHub App should be granted access to.", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/accessible-repository" + } + }, + "examples": { + "default": { + "value": [ + { + "id": 1, + "name": "Hello World", + "full_name": "octocat/Hello-World" + }, + { + "id": 2, + "login": "Goodbye World", + "full_name": "octocat/Goodbye-World" + } + ] + } + } + } + } + } + }, + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "repositories": { + "type": "array", + "description": "The repository names to add to the installation.", + "items": { + "type": "string" + }, + "maxItems": 50 + } + }, + "required": [ + "repositories" + ] + }, + "examples": { + "repositories": { + "value": { + "repositories": [ + "hello-world", + "hello-world-2" + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + } + }, + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}/repositories/remove": { + "patch": { + "summary": "Remove repository access from an organization installation", + "description": "Remove repository access from a GitHub App installed on an organization. You can remove up to 50 repositories at a time. You cannot remove repositories from an app installed on `all` repositories, nor can you remove the last repository for an app. If you attempt to do so, the API will return a 422 Unprocessable Entity error.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/remove-repository-access-to-installation", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#remove-repository-access-from-an-organization-installation" + }, + "parameters": [ + { + "$ref": "#/components/parameters/enterprise" + }, + { + "$ref": "#/components/parameters/org" + }, + { + "$ref": "#/components/parameters/installation-id" + } + ], + "responses": { + "200": { + "description": "A list of repositories which the authenticated GitHub App has lost access to.", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/accessible-repository" + } + }, + "examples": { + "default": { + "value": [ + { + "id": 1, + "name": "Hello World", + "full_name": "octocat/Hello-World" + }, + { + "id": 2, + "login": "Goodbye World", + "full_name": "octocat/Goodbye-World" + } + ] + } + } + } + } + }, + "422": { + "description": "The request was well-formed but was unable to be followed due to semantic errors. This can happen if you attempt to remove a repository from an installation that has access to `all` repositories, or if you attempt to remove the last repository from an installation.", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/basic-error" + }, + "examples": { + "default": { + "value": [ + { + "message": "Cannot remove the last repository from this installation. Uninstall this application instead." + }, + { + "documentation_url": "https://docs.github.com/rest/enterprise-admin/organization-installations#remove-repository-access-to-an-organization-installation" + }, + { + "status": 422 + } + ] + } + } + } + } + } + }, + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "repositories": { + "type": "array", + "description": "The repository names to remove from the installation.", + "items": { + "type": "string" + }, + "maxItems": 50 + } + }, + "required": [ + "repositories" + ] + }, + "examples": { + "repositories": { + "value": { + "repositories": [ + "hello-world", + "hello-world-2" + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + } + }, "/enterprises/{enterprise}/audit-log": { "get": { "summary": "Get the audit log for an enterprise", @@ -24841,7 +25552,7 @@ }, "delete": { "summary": "Remove an organization member", - "description": "Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories.", + "description": "Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories.\n\n> [!NOTE]\n> If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team.", "tags": [ "orgs" ], @@ -25259,7 +25970,7 @@ }, "delete": { "summary": "Remove organization membership for a user", - "description": "In order to remove a user's membership with an organization, the authenticated user must be an organization owner.\n\nIf the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases.", + "description": "In order to remove a user's membership with an organization, the authenticated user must be an organization owner.\n\nIf the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases.\n\n> [!NOTE]\n> If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team.", "tags": [ "orgs" ], @@ -110596,7 +111307,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -110630,6 +111341,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -111524,7 +112241,7 @@ }, "installation-token": { "title": "Installation Token", - "description": "Authentication token for a GitHub App installed on a user or org.", + "description": "Authentication token for a GitHub App installed on a user, org, or enterprise.", "type": "object", "properties": { "token": { @@ -113650,6 +114367,136 @@ "announcement" ] }, + "installable-organization": { + "title": "Installable Organization", + "description": "A GitHub organization on which a GitHub App can be installed.", + "type": "object", + "properties": { + "id": { + "type": "integer", + "examples": [ + 1 + ] + }, + "login": { + "type": "string", + "examples": [ + "github" + ] + }, + "accessible_repositories_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/enterprises/biz-name/apps/organizations/org-login/accessible_repositories" + ] + } + }, + "required": [ + "id", + "login" + ] + }, + "accessible-repository": { + "title": "Accessible Repository", + "description": "A repository that may be made accessible to a GitHub App.", + "type": "object", + "properties": { + "id": { + "description": "Unique identifier of the repository", + "type": "integer", + "format": "int64", + "examples": [ + 1 + ] + }, + "name": { + "description": "The name of the repository.", + "type": "string", + "examples": [ + "Team Environment" + ] + }, + "full_name": { + "type": "string", + "examples": [ + "octocat/Hello-World" + ] + } + }, + "required": [ + "full_name", + "id", + "name" + ] + }, + "enterprise-organization-installation": { + "title": "Enterprise Organization Installation", + "description": "A GitHub App Installation on an enterprise-owned organization", + "type": "object", + "properties": { + "id": { + "description": "The ID of the installation.", + "type": "integer", + "examples": [ + 1 + ] + }, + "app_slug": { + "type": "string", + "examples": [ + "github/github-actions" + ] + }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, + "repository_selection": { + "description": "Describe whether all repositories have been selected or there's a selection involved", + "type": "string", + "enum": [ + "all", + "selected" + ] + }, + "repositories_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/enterprises/acme-corp/apps/organizations/some-org/installations/1/repositories" + ] + }, + "permissions": { + "$ref": "#/components/schemas/app-permissions" + }, + "events": { + "type": "array", + "items": { + "type": "string" + } + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" + } + }, + "required": [ + "id", + "client_id", + "repository_selection", + "repositories_url", + "permissions", + "created_at", + "updated_at" + ] + }, "audit-log-event": { "type": "object", "properties": { @@ -298472,6 +299319,25 @@ "user_dismissible": false } }, + "enterprise-organization-installation": { + "value": { + "id": 1, + "app_slug": "monalisa/orbit", + "repository_selection": "selected", + "repositories_url": "https://api.github.com/enterprises/acme-corp/apps/organizations/some-org/installations/1/repositories", + "permissions": { + "checks": "write", + "metadata": "read", + "contents": "read" + }, + "events": [ + "push", + "pull_request" + ], + "created_at": "2017-07-08T16:18:44-04:00", + "updated_at": "2017-07-08T16:18:44-04:00" + } + }, "audit-log": { "value": [ { @@ -328628,6 +329494,15 @@ "type": "string" } }, + "org": { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, "audit-log-enterprise-phrase": { "name": "phrase", "description": "A search phrase. For more information, see [Searching the audit log](https://docs.github.com/enterprise-cloud@latest//admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/searching-the-audit-log-for-your-enterprise#searching-the-audit-log).", @@ -328917,15 +329792,6 @@ "type": "string" } }, - "org": { - "name": "org", - "description": "The organization name. The name is not case sensitive.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, "custom-property-name": { "name": "custom_property_name", "description": "The custom property name", diff --git a/descriptions-next/ghec/ghec.2022-11-28.yaml b/descriptions-next/ghec/ghec.2022-11-28.yaml index 4c3cfbd7e0..d1b581a289 100644 --- a/descriptions-next/ghec/ghec.2022-11-28.yaml +++ b/descriptions-next/ghec/ghec.2022-11-28.yaml @@ -714,7 +714,7 @@ paths: delete: summary: Delete an installation for the authenticated app description: |- - Uninstalls a GitHub App on a user, organization, or business account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the "[Suspend an app installation](https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#suspend-an-app-installation)" endpoint. + Uninstalls a GitHub App on a user, organization, or enterprise account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the "[Suspend an app installation](https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#suspend-an-app-installation)" endpoint. You must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. tags: @@ -739,12 +739,14 @@ paths: post: summary: Create an installation access token for an app description: |- - Creates an installation access token that enables a GitHub App to make authenticated API requests for the app's installation on an organization or individual account. Installation tokens expire one hour from the time you create them. Using an expired token produces a status code of `401 - Unauthorized`, and requires creating a new installation token. By default the installation token has access to all repositories that the installation can access. + Creates an installation access token that enables a GitHub App to make authenticated API requests for the app's installation on an enterprise, organization, or individual account. Installation tokens expire one hour from the time you create them. Using an expired token produces a status code of `401 - Unauthorized`, and requires creating a new installation token. By default the installation token has access to all repositories that the installation can access. Optionally, you can use the `repositories` or `repository_ids` body parameters to specify individual repositories that the installation access token can access. If you don't use `repositories` or `repository_ids` to grant access to specific repositories, the installation access token will have access to all repositories that the installation was granted access to. The installation access token cannot be granted access to repositories that the installation was not granted access to. Up to 500 repositories can be listed in this manner. Optionally, use the `permissions` body parameter to specify the permissions that the installation access token should have. If `permissions` is not specified, the installation access token will have all of the permissions that were granted to the app. The installation access token cannot be granted permissions that the app was not granted. + Enterprise account installations do not have access to repositories and cannot be scoped down using the `permissions` parameter. + You must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. tags: - apps @@ -814,7 +816,7 @@ paths: put: summary: Suspend an app installation description: |- - Suspends a GitHub App on a user, organization, or business account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub Enterprise Cloud API or webhook events is blocked for that account. + Suspends a GitHub App on a user, organization, or enterprise account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub Enterprise Cloud API or webhook events is blocked for that account. You must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. tags: @@ -3484,6 +3486,488 @@ paths: enabledForGitHubApps: false category: announcement-banners subcategory: enterprises + "/enterprises/{enterprise}/apps/installable_organizations": + get: + summary: Get enterprise-owned organizations that can have GitHub Apps installed + description: |- + List the organizations owned by the enterprise, intended for use by GitHub Apps that are managing applications across the enterprise. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/installable-organizations + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#get-enterprise-owned-organizations-that-can-have-github-apps-installed + parameters: + - "$ref": "#/components/parameters/enterprise" + - "$ref": "#/components/parameters/per-page" + - "$ref": "#/components/parameters/page" + responses: + '200': + description: A list of organizations owned by the enterprise on which the + authenticated GitHub App is installed. + content: + application/json: + schema: + type: array + items: + "$ref": "#/components/schemas/installable-organization" + examples: + default: + value: + - id: 1 + login: github + - id: 2 + login: microsoft + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + "/enterprises/{enterprise}/apps/installable_organizations/{org}/accessible_repositories": + get: + summary: Get repositories belonging to an enterprise-owned organization + description: |- + List the repositories belonging to an enterprise-owned organization that can be made accessible to a GitHub App installed on that organization. This API provides a shallow list of repositories in the organization, allowing the caller to then add or remove those repositories to an installation in that organization. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/installable-organization-accessible-repositories + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#get-repositories-belonging-to-an-enterprise-owned-organization + parameters: + - "$ref": "#/components/parameters/enterprise" + - "$ref": "#/components/parameters/org" + - "$ref": "#/components/parameters/per-page" + - "$ref": "#/components/parameters/page" + responses: + '200': + description: A list of repositories owned by the enterprise organization + on which the authenticated GitHub App is installed. + content: + application/json: + schema: + type: array + items: + "$ref": "#/components/schemas/accessible-repository" + examples: + default: + value: + - id: 1 + name: Hello World + full_name: octocat/Hello-World + - id: 2 + login: Goodbye World + full_name: octocat/Goodbye-World + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + "/enterprises/{enterprise}/apps/organizations/{org}/installations": + get: + summary: List GitHub Apps installed on an enterprise-owned organization + description: |- + Lists the GitHub App installations associated with the given enterprise-owned organization. This lists all GitHub Apps that have been installed on the organization, regardless of who owns the application. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/organization-installations + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#list-github-apps-installed-on-an-enterprise-owned-organization + parameters: + - "$ref": "#/components/parameters/enterprise" + - "$ref": "#/components/parameters/org" + - "$ref": "#/components/parameters/per-page" + - "$ref": "#/components/parameters/page" + responses: + '200': + description: A list of GitHub App installations that have been granted access + to the organization + content: + application/json: + schema: + type: array + items: + "$ref": "#/components/schemas/enterprise-organization-installation" + examples: + default: + value: + - "$ref": "#/components/examples/enterprise-organization-installation" + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + post: + summary: Install a GitHub App on an enterprise-owned organization + description: |- + Installs any valid GitHub App on the specified organization owned by the enterprise. If the app is already installed on the organization, and is suspended, it will be unsuspended. + If the app has a pending installation request, they will all be approved. + + If the app is already installed and has a pending update request, it will be updated to the latest version. If the app is now requesting repository permissions, it will be given access to the repositories listed in the request or fail if no `repository_selection` is provided. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/create-installation + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#install-a-github-app-on-an-enterprise-owned-organization + parameters: + - "$ref": "#/components/parameters/enterprise" + - "$ref": "#/components/parameters/org" + responses: + '200': + description: A GitHub App installation that was installed previously. + content: + application/json: + schema: + "$ref": "#/components/schemas/installation" + examples: + default: + "$ref": "#/components/examples/base-installation" + '201': + description: A GitHub App installation. + content: + application/json: + schema: + "$ref": "#/components/schemas/installation" + examples: + default: + "$ref": "#/components/examples/base-installation" + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + client_id: + type: string + description: The Client ID of the GitHub App to install. + repository_selection: + type: string + description: |- + The repository selection for the GitHub App. Must be one of: + * `all` - the installation can access all repositories in the organization. + * `selected` - the installation can access only the listed repositories. + * `none` - no repository permissions are requested. Only use when the app does not request repository permissions. + enum: + - all + - selected + - none + repositories: + type: array + description: The names of the repositories to which the installation + will be granted access. This is the simple name of the repository, + not the full name (e.g., `hello-world` not `octocat/hello-world`). + This is only required when `repository_selection` is `selected`. + items: + type: string + maxItems: 50 + required: + - client_id + - repository_selection + examples: + default: + summary: Example of installing a GitHub App on an organization and + granting access to all of its repositories. + value: + client_id: Iv2abc123aabbcc + repository_selection: all + repository_selection_selected: + value: + client_id: Iv2abc123aabbcc + repository_selection: selected + repositories: + - hello-world + - hello-world-2 + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}": + delete: + summary: Uninstall a GitHub App from an enterprise-owned organization + description: |- + Uninstall a GitHub App from an organization. Any app installed on the organization can be removed. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/delete-installation + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#uninstall-a-github-app-from-an-enterprise-owned-organization + parameters: + - "$ref": "#/components/parameters/enterprise" + - "$ref": "#/components/parameters/org" + - "$ref": "#/components/parameters/installation-id" + responses: + '204': + description: An empty response indicates that the installation was successfully + removed. + '404': + "$ref": "#/components/responses/not_found" + '403': + "$ref": "#/components/responses/forbidden" + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}/repositories": + get: + summary: Get the repositories accessible to a given GitHub App installation + description: |- + Lists the repositories accessible to a given GitHub App installation on an enterprise-owned organization. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/organization-installation-repositories + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#get-the-repositories-accessible-to-a-given-github-app-installation + parameters: + - "$ref": "#/components/parameters/enterprise" + - "$ref": "#/components/parameters/org" + - "$ref": "#/components/parameters/installation-id" + - "$ref": "#/components/parameters/per-page" + - "$ref": "#/components/parameters/page" + responses: + '200': + description: A list of repositories owned by the enterprise organization + to which the installation has access. + content: + application/json: + schema: + type: array + items: + "$ref": "#/components/schemas/accessible-repository" + examples: + default: + value: + - id: 1 + name: Hello World + full_name: octocat/Hello-World + - id: 2 + login: Goodbye World + full_name: octocat/Goodbye-World + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + patch: + summary: Toggle installation repository access between selected and all repositories + description: |- + Toggle repository access for a GitHub App installation between all repositories and selected repositories. You must provide at least one repository when changing the access to 'selected'. If you change the access to 'all', the repositories list must not be provided. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/change-installation-repository-access-selection + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#toggle-installation-repository-access-between-selected-and-all-repositories + parameters: + - "$ref": "#/components/parameters/enterprise" + - "$ref": "#/components/parameters/org" + - "$ref": "#/components/parameters/installation-id" + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + repository_selection: + type: string + description: One of either 'all' or 'selected' + enum: + - all + - selected + repositories: + type: array + description: The repository names to add to the installation. Only + required when repository_selection is 'selected' + items: + type: string + maxItems: 50 + required: + - repository_selection + examples: + default: + summary: Change the repositories accessible to a GitHub App from 'all + repositories' to a specified subset. + value: + repository_selection: selected + repositories: + - hello-world + - hello-world-2 + responses: + '200': + description: The GitHub App installation that was updated. + content: + application/json: + schema: + "$ref": "#/components/schemas/installation" + examples: + default: + "$ref": "#/components/examples/base-installation" + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}/repositories/add": + patch: + summary: Grant repository access to an organization installation + description: |- + Grant repository access to an organization installation. You can add up to 50 repositories at a time. If the installation already has access to the repository, it will not be added again. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/grant-repository-access-to-installation + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#grant-repository-access-to-an-organization-installation + parameters: + - "$ref": "#/components/parameters/enterprise" + - "$ref": "#/components/parameters/org" + - "$ref": "#/components/parameters/installation-id" + responses: + '200': + description: A list of repositories which the authenticated GitHub App should + be granted access to. + content: + application/json: + schema: + type: array + items: + "$ref": "#/components/schemas/accessible-repository" + examples: + default: + value: + - id: 1 + name: Hello World + full_name: octocat/Hello-World + - id: 2 + login: Goodbye World + full_name: octocat/Goodbye-World + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + repositories: + type: array + description: The repository names to add to the installation. + items: + type: string + maxItems: 50 + required: + - repositories + examples: + repositories: + value: + repositories: + - hello-world + - hello-world-2 + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}/repositories/remove": + patch: + summary: Remove repository access from an organization installation + description: |- + Remove repository access from a GitHub App installed on an organization. You can remove up to 50 repositories at a time. You cannot remove repositories from an app installed on `all` repositories, nor can you remove the last repository for an app. If you attempt to do so, the API will return a 422 Unprocessable Entity error. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/remove-repository-access-to-installation + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#remove-repository-access-from-an-organization-installation + parameters: + - "$ref": "#/components/parameters/enterprise" + - "$ref": "#/components/parameters/org" + - "$ref": "#/components/parameters/installation-id" + responses: + '200': + description: A list of repositories which the authenticated GitHub App has + lost access to. + content: + application/json: + schema: + type: array + items: + "$ref": "#/components/schemas/accessible-repository" + examples: + default: + value: + - id: 1 + name: Hello World + full_name: octocat/Hello-World + - id: 2 + login: Goodbye World + full_name: octocat/Goodbye-World + '422': + description: The request was well-formed but was unable to be followed due + to semantic errors. This can happen if you attempt to remove a repository + from an installation that has access to `all` repositories, or if you + attempt to remove the last repository from an installation. + content: + application/json: + schema: + "$ref": "#/components/schemas/basic-error" + examples: + default: + value: + - message: Cannot remove the last repository from this installation. + Uninstall this application instead. + - documentation_url: https://docs.github.com/rest/enterprise-admin/organization-installations#remove-repository-access-to-an-organization-installation + - status: 422 + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + repositories: + type: array + description: The repository names to remove from the installation. + items: + type: string + maxItems: 50 + required: + - repositories + examples: + repositories: + value: + repositories: + - hello-world + - hello-world-2 + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations "/enterprises/{enterprise}/audit-log": get: summary: Get the audit log for an enterprise @@ -17923,8 +18407,11 @@ paths: subcategory: members delete: summary: Remove an organization member - description: Removing a user from this list will remove them from all teams - and they will no longer have any access to the organization's repositories. + description: |- + Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories. + + > [!NOTE] + > If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team. tags: - orgs operationId: orgs/remove-member @@ -18229,6 +18716,9 @@ paths: In order to remove a user's membership with an organization, the authenticated user must be an organization owner. If the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases. + + > [!NOTE] + > If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team. tags: - orgs operationId: orgs/remove-membership-for-user @@ -79840,7 +80330,7 @@ components: - object repository_selection: description: Describe whether all repositories have been selected or there's - a selection involved + a selection involved. For enterprise installations this is `selected`. type: string enum: - all @@ -79864,6 +80354,10 @@ components: type: integer examples: - 1 + client_id: + type: string + examples: + - Iv1.ab1112223334445c target_id: description: The ID of the user or organization this token is being scoped to. @@ -80538,7 +81032,8 @@ components: - updated_at installation-token: title: Installation Token - description: Authentication token for a GitHub App installed on a user or org. + description: Authentication token for a GitHub App installed on a user, org, + or enterprise. type: object properties: token: @@ -82166,6 +82661,101 @@ components: "$ref": "#/components/schemas/announcement-user-dismissible" required: - announcement + installable-organization: + title: Installable Organization + description: A GitHub organization on which a GitHub App can be installed. + type: object + properties: + id: + type: integer + examples: + - 1 + login: + type: string + examples: + - github + accessible_repositories_url: + type: string + format: uri + examples: + - https://api.github.com/enterprises/biz-name/apps/organizations/org-login/accessible_repositories + required: + - id + - login + accessible-repository: + title: Accessible Repository + description: A repository that may be made accessible to a GitHub App. + type: object + properties: + id: + description: Unique identifier of the repository + type: integer + format: int64 + examples: + - 1 + name: + description: The name of the repository. + type: string + examples: + - Team Environment + full_name: + type: string + examples: + - octocat/Hello-World + required: + - full_name + - id + - name + enterprise-organization-installation: + title: Enterprise Organization Installation + description: A GitHub App Installation on an enterprise-owned organization + type: object + properties: + id: + description: The ID of the installation. + type: integer + examples: + - 1 + app_slug: + type: string + examples: + - github/github-actions + client_id: + type: string + examples: + - Iv1.ab1112223334445c + repository_selection: + description: Describe whether all repositories have been selected or there's + a selection involved + type: string + enum: + - all + - selected + repositories_url: + type: string + format: uri + examples: + - https://api.github.com/enterprises/acme-corp/apps/organizations/some-org/installations/1/repositories + permissions: + "$ref": "#/components/schemas/app-permissions" + events: + type: array + items: + type: string + created_at: + type: string + format: date-time + updated_at: + type: string + format: date-time + required: + - id + - client_id + - repository_selection + - repositories_url + - permissions + - created_at + - updated_at audit-log-event: type: object properties: @@ -219613,6 +220203,21 @@ components: announcement: Very **important** announcement about _something_. expires_at: '2021-01-01T00:00:00.000+00:00' user_dismissible: false + enterprise-organization-installation: + value: + id: 1 + app_slug: monalisa/orbit + repository_selection: selected + repositories_url: https://api.github.com/enterprises/acme-corp/apps/organizations/some-org/installations/1/repositories + permissions: + checks: write + metadata: read + contents: read + events: + - push + - pull_request + created_at: '2017-07-08T16:18:44-04:00' + updated_at: '2017-07-08T16:18:44-04:00' audit-log: value: - "@timestamp": 1606929874512 @@ -245415,6 +246020,13 @@ components: required: true schema: type: string + org: + name: org + description: The organization name. The name is not case sensitive. + in: path + required: true + schema: + type: string audit-log-enterprise-phrase: name: phrase description: A search phrase. For more information, see [Searching the audit @@ -245690,13 +246302,6 @@ components: required: true schema: type: string - org: - name: org - description: The organization name. The name is not case sensitive. - in: path - required: true - schema: - type: string custom-property-name: name: custom_property_name description: The custom property name diff --git a/descriptions-next/ghec/ghec.json b/descriptions-next/ghec/ghec.json index fe1140d7b1..d42d467ac7 100644 --- a/descriptions-next/ghec/ghec.json +++ b/descriptions-next/ghec/ghec.json @@ -1056,7 +1056,7 @@ }, "delete": { "summary": "Delete an installation for the authenticated app", - "description": "Uninstalls a GitHub App on a user, organization, or business account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the \"[Suspend an app installation](https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#suspend-an-app-installation)\" endpoint.\n\nYou must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", + "description": "Uninstalls a GitHub App on a user, organization, or enterprise account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the \"[Suspend an app installation](https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#suspend-an-app-installation)\" endpoint.\n\nYou must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", "tags": [ "apps" ], @@ -1089,7 +1089,7 @@ "/app/installations/{installation_id}/access_tokens": { "post": { "summary": "Create an installation access token for an app", - "description": "Creates an installation access token that enables a GitHub App to make authenticated API requests for the app's installation on an organization or individual account. Installation tokens expire one hour from the time you create them. Using an expired token produces a status code of `401 - Unauthorized`, and requires creating a new installation token. By default the installation token has access to all repositories that the installation can access.\n\nOptionally, you can use the `repositories` or `repository_ids` body parameters to specify individual repositories that the installation access token can access. If you don't use `repositories` or `repository_ids` to grant access to specific repositories, the installation access token will have access to all repositories that the installation was granted access to. The installation access token cannot be granted access to repositories that the installation was not granted access to. Up to 500 repositories can be listed in this manner.\n\nOptionally, use the `permissions` body parameter to specify the permissions that the installation access token should have. If `permissions` is not specified, the installation access token will have all of the permissions that were granted to the app. The installation access token cannot be granted permissions that the app was not granted.\n\nYou must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", + "description": "Creates an installation access token that enables a GitHub App to make authenticated API requests for the app's installation on an enterprise, organization, or individual account. Installation tokens expire one hour from the time you create them. Using an expired token produces a status code of `401 - Unauthorized`, and requires creating a new installation token. By default the installation token has access to all repositories that the installation can access.\n\nOptionally, you can use the `repositories` or `repository_ids` body parameters to specify individual repositories that the installation access token can access. If you don't use `repositories` or `repository_ids` to grant access to specific repositories, the installation access token will have access to all repositories that the installation was granted access to. The installation access token cannot be granted access to repositories that the installation was not granted access to. Up to 500 repositories can be listed in this manner.\n\nOptionally, use the `permissions` body parameter to specify the permissions that the installation access token should have. If `permissions` is not specified, the installation access token will have all of the permissions that were granted to the app. The installation access token cannot be granted permissions that the app was not granted.\n\nEnterprise account installations do not have access to repositories and cannot be scoped down using the `permissions` parameter.\n\nYou must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", "tags": [ "apps" ], @@ -1191,7 +1191,7 @@ "/app/installations/{installation_id}/suspended": { "put": { "summary": "Suspend an app installation", - "description": "Suspends a GitHub App on a user, organization, or business account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub Enterprise Cloud API or webhook events is blocked for that account.\n\nYou must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", + "description": "Suspends a GitHub App on a user, organization, or enterprise account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub Enterprise Cloud API or webhook events is blocked for that account.\n\nYou must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", "tags": [ "apps" ], @@ -4944,6 +4944,717 @@ } } }, + "/enterprises/{enterprise}/apps/installable_organizations": { + "get": { + "summary": "Get enterprise-owned organizations that can have GitHub Apps installed", + "description": "List the organizations owned by the enterprise, intended for use by GitHub Apps that are managing applications across the enterprise.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/installable-organizations", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#get-enterprise-owned-organizations-that-can-have-github-apps-installed" + }, + "parameters": [ + { + "$ref": "#/components/parameters/enterprise" + }, + { + "$ref": "#/components/parameters/per-page" + }, + { + "$ref": "#/components/parameters/page" + } + ], + "responses": { + "200": { + "description": "A list of organizations owned by the enterprise on which the authenticated GitHub App is installed.", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/installable-organization" + } + }, + "examples": { + "default": { + "value": [ + { + "id": 1, + "login": "github" + }, + { + "id": 2, + "login": "microsoft" + } + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + } + }, + "/enterprises/{enterprise}/apps/installable_organizations/{org}/accessible_repositories": { + "get": { + "summary": "Get repositories belonging to an enterprise-owned organization", + "description": "List the repositories belonging to an enterprise-owned organization that can be made accessible to a GitHub App installed on that organization. This API provides a shallow list of repositories in the organization, allowing the caller to then add or remove those repositories to an installation in that organization.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/installable-organization-accessible-repositories", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#get-repositories-belonging-to-an-enterprise-owned-organization" + }, + "parameters": [ + { + "$ref": "#/components/parameters/enterprise" + }, + { + "$ref": "#/components/parameters/org" + }, + { + "$ref": "#/components/parameters/per-page" + }, + { + "$ref": "#/components/parameters/page" + } + ], + "responses": { + "200": { + "description": "A list of repositories owned by the enterprise organization on which the authenticated GitHub App is installed.", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/accessible-repository" + } + }, + "examples": { + "default": { + "value": [ + { + "id": 1, + "name": "Hello World", + "full_name": "octocat/Hello-World" + }, + { + "id": 2, + "login": "Goodbye World", + "full_name": "octocat/Goodbye-World" + } + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + } + }, + "/enterprises/{enterprise}/apps/organizations/{org}/installations": { + "get": { + "summary": "List GitHub Apps installed on an enterprise-owned organization", + "description": "Lists the GitHub App installations associated with the given enterprise-owned organization. This lists all GitHub Apps that have been installed on the organization, regardless of who owns the application.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/organization-installations", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#list-github-apps-installed-on-an-enterprise-owned-organization" + }, + "parameters": [ + { + "$ref": "#/components/parameters/enterprise" + }, + { + "$ref": "#/components/parameters/org" + }, + { + "$ref": "#/components/parameters/per-page" + }, + { + "$ref": "#/components/parameters/page" + } + ], + "responses": { + "200": { + "description": "A list of GitHub App installations that have been granted access to the organization", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/enterprise-organization-installation" + } + }, + "examples": { + "default": { + "value": [ + { + "$ref": "#/components/examples/enterprise-organization-installation" + } + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + }, + "post": { + "summary": "Install a GitHub App on an enterprise-owned organization", + "description": "Installs any valid GitHub App on the specified organization owned by the enterprise. If the app is already installed on the organization, and is suspended, it will be unsuspended.\nIf the app has a pending installation request, they will all be approved.\n\nIf the app is already installed and has a pending update request, it will be updated to the latest version. If the app is now requesting repository permissions, it will be given access to the repositories listed in the request or fail if no `repository_selection` is provided.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/create-installation", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#install-a-github-app-on-an-enterprise-owned-organization" + }, + "parameters": [ + { + "$ref": "#/components/parameters/enterprise" + }, + { + "$ref": "#/components/parameters/org" + } + ], + "responses": { + "200": { + "description": "A GitHub App installation that was installed previously.", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/installation" + }, + "examples": { + "default": { + "$ref": "#/components/examples/base-installation" + } + } + } + } + }, + "201": { + "description": "A GitHub App installation.", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/installation" + }, + "examples": { + "default": { + "$ref": "#/components/examples/base-installation" + } + } + } + } + } + }, + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "client_id": { + "type": "string", + "description": "The Client ID of the GitHub App to install." + }, + "repository_selection": { + "type": "string", + "description": "The repository selection for the GitHub App. Must be one of:\n* `all` - the installation can access all repositories in the organization.\n* `selected` - the installation can access only the listed repositories.\n* `none` - no repository permissions are requested. Only use when the app does not request repository permissions.", + "enum": [ + "all", + "selected", + "none" + ] + }, + "repositories": { + "type": "array", + "description": "The names of the repositories to which the installation will be granted access. This is the simple name of the repository, not the full name (e.g., `hello-world` not `octocat/hello-world`). This is only required when `repository_selection` is `selected`.", + "items": { + "type": "string" + }, + "maxItems": 50 + } + }, + "required": [ + "client_id", + "repository_selection" + ] + }, + "examples": { + "default": { + "summary": "Example of installing a GitHub App on an organization and granting access to all of its repositories.", + "value": { + "client_id": "Iv2abc123aabbcc", + "repository_selection": "all" + } + }, + "repository_selection_selected": { + "value": { + "client_id": "Iv2abc123aabbcc", + "repository_selection": "selected", + "repositories": [ + "hello-world", + "hello-world-2" + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + } + }, + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}": { + "delete": { + "summary": "Uninstall a GitHub App from an enterprise-owned organization", + "description": "Uninstall a GitHub App from an organization. Any app installed on the organization can be removed.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/delete-installation", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#uninstall-a-github-app-from-an-enterprise-owned-organization" + }, + "parameters": [ + { + "$ref": "#/components/parameters/enterprise" + }, + { + "$ref": "#/components/parameters/org" + }, + { + "$ref": "#/components/parameters/installation-id" + } + ], + "responses": { + "204": { + "description": "An empty response indicates that the installation was successfully removed." + }, + "404": { + "$ref": "#/components/responses/not_found" + }, + "403": { + "$ref": "#/components/responses/forbidden" + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + } + }, + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}/repositories": { + "get": { + "summary": "Get the repositories accessible to a given GitHub App installation", + "description": "Lists the repositories accessible to a given GitHub App installation on an enterprise-owned organization.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/organization-installation-repositories", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#get-the-repositories-accessible-to-a-given-github-app-installation" + }, + "parameters": [ + { + "$ref": "#/components/parameters/enterprise" + }, + { + "$ref": "#/components/parameters/org" + }, + { + "$ref": "#/components/parameters/installation-id" + }, + { + "$ref": "#/components/parameters/per-page" + }, + { + "$ref": "#/components/parameters/page" + } + ], + "responses": { + "200": { + "description": "A list of repositories owned by the enterprise organization to which the installation has access.", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/accessible-repository" + } + }, + "examples": { + "default": { + "value": [ + { + "id": 1, + "name": "Hello World", + "full_name": "octocat/Hello-World" + }, + { + "id": 2, + "login": "Goodbye World", + "full_name": "octocat/Goodbye-World" + } + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + }, + "patch": { + "summary": "Toggle installation repository access between selected and all repositories", + "description": "Toggle repository access for a GitHub App installation between all repositories and selected repositories. You must provide at least one repository when changing the access to 'selected'. If you change the access to 'all', the repositories list must not be provided.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/change-installation-repository-access-selection", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#toggle-installation-repository-access-between-selected-and-all-repositories" + }, + "parameters": [ + { + "$ref": "#/components/parameters/enterprise" + }, + { + "$ref": "#/components/parameters/org" + }, + { + "$ref": "#/components/parameters/installation-id" + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "repository_selection": { + "type": "string", + "description": "One of either 'all' or 'selected'", + "enum": [ + "all", + "selected" + ] + }, + "repositories": { + "type": "array", + "description": "The repository names to add to the installation. Only required when repository_selection is 'selected'", + "items": { + "type": "string" + }, + "maxItems": 50 + } + }, + "required": [ + "repository_selection" + ] + }, + "examples": { + "default": { + "summary": "Change the repositories accessible to a GitHub App from 'all repositories' to a specified subset.", + "value": { + "repository_selection": "selected", + "repositories": [ + "hello-world", + "hello-world-2" + ] + } + } + } + } + } + }, + "responses": { + "200": { + "description": "The GitHub App installation that was updated.", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/installation" + }, + "examples": { + "default": { + "$ref": "#/components/examples/base-installation" + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + } + }, + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}/repositories/add": { + "patch": { + "summary": "Grant repository access to an organization installation", + "description": "Grant repository access to an organization installation. You can add up to 50 repositories at a time. If the installation already has access to the repository, it will not be added again.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/grant-repository-access-to-installation", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#grant-repository-access-to-an-organization-installation" + }, + "parameters": [ + { + "$ref": "#/components/parameters/enterprise" + }, + { + "$ref": "#/components/parameters/org" + }, + { + "$ref": "#/components/parameters/installation-id" + } + ], + "responses": { + "200": { + "description": "A list of repositories which the authenticated GitHub App should be granted access to.", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/accessible-repository" + } + }, + "examples": { + "default": { + "value": [ + { + "id": 1, + "name": "Hello World", + "full_name": "octocat/Hello-World" + }, + { + "id": 2, + "login": "Goodbye World", + "full_name": "octocat/Goodbye-World" + } + ] + } + } + } + } + } + }, + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "repositories": { + "type": "array", + "description": "The repository names to add to the installation.", + "items": { + "type": "string" + }, + "maxItems": 50 + } + }, + "required": [ + "repositories" + ] + }, + "examples": { + "repositories": { + "value": { + "repositories": [ + "hello-world", + "hello-world-2" + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + } + }, + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}/repositories/remove": { + "patch": { + "summary": "Remove repository access from an organization installation", + "description": "Remove repository access from a GitHub App installed on an organization. You can remove up to 50 repositories at a time. You cannot remove repositories from an app installed on `all` repositories, nor can you remove the last repository for an app. If you attempt to do so, the API will return a 422 Unprocessable Entity error.\n\nThis API can only be called by a GitHub App installed on the enterprise that owns the organization.", + "tags": [ + "apps" + ], + "operationId": "enterprise-apps/remove-repository-access-to-installation", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#remove-repository-access-from-an-organization-installation" + }, + "parameters": [ + { + "$ref": "#/components/parameters/enterprise" + }, + { + "$ref": "#/components/parameters/org" + }, + { + "$ref": "#/components/parameters/installation-id" + } + ], + "responses": { + "200": { + "description": "A list of repositories which the authenticated GitHub App has lost access to.", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/accessible-repository" + } + }, + "examples": { + "default": { + "value": [ + { + "id": 1, + "name": "Hello World", + "full_name": "octocat/Hello-World" + }, + { + "id": 2, + "login": "Goodbye World", + "full_name": "octocat/Goodbye-World" + } + ] + } + } + } + } + }, + "422": { + "description": "The request was well-formed but was unable to be followed due to semantic errors. This can happen if you attempt to remove a repository from an installation that has access to `all` repositories, or if you attempt to remove the last repository from an installation.", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/basic-error" + }, + "examples": { + "default": { + "value": [ + { + "message": "Cannot remove the last repository from this installation. Uninstall this application instead." + }, + { + "documentation_url": "https://docs.github.com/rest/enterprise-admin/organization-installations#remove-repository-access-to-an-organization-installation" + }, + { + "status": 422 + } + ] + } + } + } + } + } + }, + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "repositories": { + "type": "array", + "description": "The repository names to remove from the installation.", + "items": { + "type": "string" + }, + "maxItems": 50 + } + }, + "required": [ + "repositories" + ] + }, + "examples": { + "repositories": { + "value": { + "repositories": [ + "hello-world", + "hello-world-2" + ] + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "organization-installations" + } + } + }, "/enterprises/{enterprise}/audit-log": { "get": { "summary": "Get the audit log for an enterprise", @@ -24841,7 +25552,7 @@ }, "delete": { "summary": "Remove an organization member", - "description": "Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories.", + "description": "Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories.\n\n> [!NOTE]\n> If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team.", "tags": [ "orgs" ], @@ -25259,7 +25970,7 @@ }, "delete": { "summary": "Remove organization membership for a user", - "description": "In order to remove a user's membership with an organization, the authenticated user must be an organization owner.\n\nIf the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases.", + "description": "In order to remove a user's membership with an organization, the authenticated user must be an organization owner.\n\nIf the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases.\n\n> [!NOTE]\n> If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team.", "tags": [ "orgs" ], @@ -110596,7 +111307,7 @@ ] }, "repository_selection": { - "description": "Describe whether all repositories have been selected or there's a selection involved", + "description": "Describe whether all repositories have been selected or there's a selection involved. For enterprise installations this is `selected`.", "type": "string", "enum": [ "all", @@ -110630,6 +111341,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -111524,7 +112241,7 @@ }, "installation-token": { "title": "Installation Token", - "description": "Authentication token for a GitHub App installed on a user or org.", + "description": "Authentication token for a GitHub App installed on a user, org, or enterprise.", "type": "object", "properties": { "token": { @@ -113650,6 +114367,136 @@ "announcement" ] }, + "installable-organization": { + "title": "Installable Organization", + "description": "A GitHub organization on which a GitHub App can be installed.", + "type": "object", + "properties": { + "id": { + "type": "integer", + "examples": [ + 1 + ] + }, + "login": { + "type": "string", + "examples": [ + "github" + ] + }, + "accessible_repositories_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/enterprises/biz-name/apps/organizations/org-login/accessible_repositories" + ] + } + }, + "required": [ + "id", + "login" + ] + }, + "accessible-repository": { + "title": "Accessible Repository", + "description": "A repository that may be made accessible to a GitHub App.", + "type": "object", + "properties": { + "id": { + "description": "Unique identifier of the repository", + "type": "integer", + "format": "int64", + "examples": [ + 1 + ] + }, + "name": { + "description": "The name of the repository.", + "type": "string", + "examples": [ + "Team Environment" + ] + }, + "full_name": { + "type": "string", + "examples": [ + "octocat/Hello-World" + ] + } + }, + "required": [ + "full_name", + "id", + "name" + ] + }, + "enterprise-organization-installation": { + "title": "Enterprise Organization Installation", + "description": "A GitHub App Installation on an enterprise-owned organization", + "type": "object", + "properties": { + "id": { + "description": "The ID of the installation.", + "type": "integer", + "examples": [ + 1 + ] + }, + "app_slug": { + "type": "string", + "examples": [ + "github/github-actions" + ] + }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, + "repository_selection": { + "description": "Describe whether all repositories have been selected or there's a selection involved", + "type": "string", + "enum": [ + "all", + "selected" + ] + }, + "repositories_url": { + "type": "string", + "format": "uri", + "examples": [ + "https://api.github.com/enterprises/acme-corp/apps/organizations/some-org/installations/1/repositories" + ] + }, + "permissions": { + "$ref": "#/components/schemas/app-permissions" + }, + "events": { + "type": "array", + "items": { + "type": "string" + } + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" + } + }, + "required": [ + "id", + "client_id", + "repository_selection", + "repositories_url", + "permissions", + "created_at", + "updated_at" + ] + }, "audit-log-event": { "type": "object", "properties": { @@ -298472,6 +299319,25 @@ "user_dismissible": false } }, + "enterprise-organization-installation": { + "value": { + "id": 1, + "app_slug": "monalisa/orbit", + "repository_selection": "selected", + "repositories_url": "https://api.github.com/enterprises/acme-corp/apps/organizations/some-org/installations/1/repositories", + "permissions": { + "checks": "write", + "metadata": "read", + "contents": "read" + }, + "events": [ + "push", + "pull_request" + ], + "created_at": "2017-07-08T16:18:44-04:00", + "updated_at": "2017-07-08T16:18:44-04:00" + } + }, "audit-log": { "value": [ { @@ -328628,6 +329494,15 @@ "type": "string" } }, + "org": { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, "audit-log-enterprise-phrase": { "name": "phrase", "description": "A search phrase. For more information, see [Searching the audit log](https://docs.github.com/enterprise-cloud@latest//admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/searching-the-audit-log-for-your-enterprise#searching-the-audit-log).", @@ -328917,15 +329792,6 @@ "type": "string" } }, - "org": { - "name": "org", - "description": "The organization name. The name is not case sensitive.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, "custom-property-name": { "name": "custom_property_name", "description": "The custom property name", diff --git a/descriptions-next/ghec/ghec.yaml b/descriptions-next/ghec/ghec.yaml index 4c3cfbd7e0..d1b581a289 100644 --- a/descriptions-next/ghec/ghec.yaml +++ b/descriptions-next/ghec/ghec.yaml @@ -714,7 +714,7 @@ paths: delete: summary: Delete an installation for the authenticated app description: |- - Uninstalls a GitHub App on a user, organization, or business account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the "[Suspend an app installation](https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#suspend-an-app-installation)" endpoint. + Uninstalls a GitHub App on a user, organization, or enterprise account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the "[Suspend an app installation](https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#suspend-an-app-installation)" endpoint. You must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. tags: @@ -739,12 +739,14 @@ paths: post: summary: Create an installation access token for an app description: |- - Creates an installation access token that enables a GitHub App to make authenticated API requests for the app's installation on an organization or individual account. Installation tokens expire one hour from the time you create them. Using an expired token produces a status code of `401 - Unauthorized`, and requires creating a new installation token. By default the installation token has access to all repositories that the installation can access. + Creates an installation access token that enables a GitHub App to make authenticated API requests for the app's installation on an enterprise, organization, or individual account. Installation tokens expire one hour from the time you create them. Using an expired token produces a status code of `401 - Unauthorized`, and requires creating a new installation token. By default the installation token has access to all repositories that the installation can access. Optionally, you can use the `repositories` or `repository_ids` body parameters to specify individual repositories that the installation access token can access. If you don't use `repositories` or `repository_ids` to grant access to specific repositories, the installation access token will have access to all repositories that the installation was granted access to. The installation access token cannot be granted access to repositories that the installation was not granted access to. Up to 500 repositories can be listed in this manner. Optionally, use the `permissions` body parameter to specify the permissions that the installation access token should have. If `permissions` is not specified, the installation access token will have all of the permissions that were granted to the app. The installation access token cannot be granted permissions that the app was not granted. + Enterprise account installations do not have access to repositories and cannot be scoped down using the `permissions` parameter. + You must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. tags: - apps @@ -814,7 +816,7 @@ paths: put: summary: Suspend an app installation description: |- - Suspends a GitHub App on a user, organization, or business account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub Enterprise Cloud API or webhook events is blocked for that account. + Suspends a GitHub App on a user, organization, or enterprise account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub Enterprise Cloud API or webhook events is blocked for that account. You must use a [JWT](https://docs.github.com/enterprise-cloud@latest//apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. tags: @@ -3484,6 +3486,488 @@ paths: enabledForGitHubApps: false category: announcement-banners subcategory: enterprises + "/enterprises/{enterprise}/apps/installable_organizations": + get: + summary: Get enterprise-owned organizations that can have GitHub Apps installed + description: |- + List the organizations owned by the enterprise, intended for use by GitHub Apps that are managing applications across the enterprise. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/installable-organizations + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#get-enterprise-owned-organizations-that-can-have-github-apps-installed + parameters: + - "$ref": "#/components/parameters/enterprise" + - "$ref": "#/components/parameters/per-page" + - "$ref": "#/components/parameters/page" + responses: + '200': + description: A list of organizations owned by the enterprise on which the + authenticated GitHub App is installed. + content: + application/json: + schema: + type: array + items: + "$ref": "#/components/schemas/installable-organization" + examples: + default: + value: + - id: 1 + login: github + - id: 2 + login: microsoft + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + "/enterprises/{enterprise}/apps/installable_organizations/{org}/accessible_repositories": + get: + summary: Get repositories belonging to an enterprise-owned organization + description: |- + List the repositories belonging to an enterprise-owned organization that can be made accessible to a GitHub App installed on that organization. This API provides a shallow list of repositories in the organization, allowing the caller to then add or remove those repositories to an installation in that organization. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/installable-organization-accessible-repositories + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#get-repositories-belonging-to-an-enterprise-owned-organization + parameters: + - "$ref": "#/components/parameters/enterprise" + - "$ref": "#/components/parameters/org" + - "$ref": "#/components/parameters/per-page" + - "$ref": "#/components/parameters/page" + responses: + '200': + description: A list of repositories owned by the enterprise organization + on which the authenticated GitHub App is installed. + content: + application/json: + schema: + type: array + items: + "$ref": "#/components/schemas/accessible-repository" + examples: + default: + value: + - id: 1 + name: Hello World + full_name: octocat/Hello-World + - id: 2 + login: Goodbye World + full_name: octocat/Goodbye-World + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + "/enterprises/{enterprise}/apps/organizations/{org}/installations": + get: + summary: List GitHub Apps installed on an enterprise-owned organization + description: |- + Lists the GitHub App installations associated with the given enterprise-owned organization. This lists all GitHub Apps that have been installed on the organization, regardless of who owns the application. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/organization-installations + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#list-github-apps-installed-on-an-enterprise-owned-organization + parameters: + - "$ref": "#/components/parameters/enterprise" + - "$ref": "#/components/parameters/org" + - "$ref": "#/components/parameters/per-page" + - "$ref": "#/components/parameters/page" + responses: + '200': + description: A list of GitHub App installations that have been granted access + to the organization + content: + application/json: + schema: + type: array + items: + "$ref": "#/components/schemas/enterprise-organization-installation" + examples: + default: + value: + - "$ref": "#/components/examples/enterprise-organization-installation" + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + post: + summary: Install a GitHub App on an enterprise-owned organization + description: |- + Installs any valid GitHub App on the specified organization owned by the enterprise. If the app is already installed on the organization, and is suspended, it will be unsuspended. + If the app has a pending installation request, they will all be approved. + + If the app is already installed and has a pending update request, it will be updated to the latest version. If the app is now requesting repository permissions, it will be given access to the repositories listed in the request or fail if no `repository_selection` is provided. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/create-installation + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#install-a-github-app-on-an-enterprise-owned-organization + parameters: + - "$ref": "#/components/parameters/enterprise" + - "$ref": "#/components/parameters/org" + responses: + '200': + description: A GitHub App installation that was installed previously. + content: + application/json: + schema: + "$ref": "#/components/schemas/installation" + examples: + default: + "$ref": "#/components/examples/base-installation" + '201': + description: A GitHub App installation. + content: + application/json: + schema: + "$ref": "#/components/schemas/installation" + examples: + default: + "$ref": "#/components/examples/base-installation" + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + client_id: + type: string + description: The Client ID of the GitHub App to install. + repository_selection: + type: string + description: |- + The repository selection for the GitHub App. Must be one of: + * `all` - the installation can access all repositories in the organization. + * `selected` - the installation can access only the listed repositories. + * `none` - no repository permissions are requested. Only use when the app does not request repository permissions. + enum: + - all + - selected + - none + repositories: + type: array + description: The names of the repositories to which the installation + will be granted access. This is the simple name of the repository, + not the full name (e.g., `hello-world` not `octocat/hello-world`). + This is only required when `repository_selection` is `selected`. + items: + type: string + maxItems: 50 + required: + - client_id + - repository_selection + examples: + default: + summary: Example of installing a GitHub App on an organization and + granting access to all of its repositories. + value: + client_id: Iv2abc123aabbcc + repository_selection: all + repository_selection_selected: + value: + client_id: Iv2abc123aabbcc + repository_selection: selected + repositories: + - hello-world + - hello-world-2 + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}": + delete: + summary: Uninstall a GitHub App from an enterprise-owned organization + description: |- + Uninstall a GitHub App from an organization. Any app installed on the organization can be removed. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/delete-installation + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#uninstall-a-github-app-from-an-enterprise-owned-organization + parameters: + - "$ref": "#/components/parameters/enterprise" + - "$ref": "#/components/parameters/org" + - "$ref": "#/components/parameters/installation-id" + responses: + '204': + description: An empty response indicates that the installation was successfully + removed. + '404': + "$ref": "#/components/responses/not_found" + '403': + "$ref": "#/components/responses/forbidden" + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}/repositories": + get: + summary: Get the repositories accessible to a given GitHub App installation + description: |- + Lists the repositories accessible to a given GitHub App installation on an enterprise-owned organization. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/organization-installation-repositories + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#get-the-repositories-accessible-to-a-given-github-app-installation + parameters: + - "$ref": "#/components/parameters/enterprise" + - "$ref": "#/components/parameters/org" + - "$ref": "#/components/parameters/installation-id" + - "$ref": "#/components/parameters/per-page" + - "$ref": "#/components/parameters/page" + responses: + '200': + description: A list of repositories owned by the enterprise organization + to which the installation has access. + content: + application/json: + schema: + type: array + items: + "$ref": "#/components/schemas/accessible-repository" + examples: + default: + value: + - id: 1 + name: Hello World + full_name: octocat/Hello-World + - id: 2 + login: Goodbye World + full_name: octocat/Goodbye-World + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + patch: + summary: Toggle installation repository access between selected and all repositories + description: |- + Toggle repository access for a GitHub App installation between all repositories and selected repositories. You must provide at least one repository when changing the access to 'selected'. If you change the access to 'all', the repositories list must not be provided. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/change-installation-repository-access-selection + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#toggle-installation-repository-access-between-selected-and-all-repositories + parameters: + - "$ref": "#/components/parameters/enterprise" + - "$ref": "#/components/parameters/org" + - "$ref": "#/components/parameters/installation-id" + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + repository_selection: + type: string + description: One of either 'all' or 'selected' + enum: + - all + - selected + repositories: + type: array + description: The repository names to add to the installation. Only + required when repository_selection is 'selected' + items: + type: string + maxItems: 50 + required: + - repository_selection + examples: + default: + summary: Change the repositories accessible to a GitHub App from 'all + repositories' to a specified subset. + value: + repository_selection: selected + repositories: + - hello-world + - hello-world-2 + responses: + '200': + description: The GitHub App installation that was updated. + content: + application/json: + schema: + "$ref": "#/components/schemas/installation" + examples: + default: + "$ref": "#/components/examples/base-installation" + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}/repositories/add": + patch: + summary: Grant repository access to an organization installation + description: |- + Grant repository access to an organization installation. You can add up to 50 repositories at a time. If the installation already has access to the repository, it will not be added again. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/grant-repository-access-to-installation + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#grant-repository-access-to-an-organization-installation + parameters: + - "$ref": "#/components/parameters/enterprise" + - "$ref": "#/components/parameters/org" + - "$ref": "#/components/parameters/installation-id" + responses: + '200': + description: A list of repositories which the authenticated GitHub App should + be granted access to. + content: + application/json: + schema: + type: array + items: + "$ref": "#/components/schemas/accessible-repository" + examples: + default: + value: + - id: 1 + name: Hello World + full_name: octocat/Hello-World + - id: 2 + login: Goodbye World + full_name: octocat/Goodbye-World + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + repositories: + type: array + description: The repository names to add to the installation. + items: + type: string + maxItems: 50 + required: + - repositories + examples: + repositories: + value: + repositories: + - hello-world + - hello-world-2 + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations + "/enterprises/{enterprise}/apps/organizations/{org}/installations/{installation_id}/repositories/remove": + patch: + summary: Remove repository access from an organization installation + description: |- + Remove repository access from a GitHub App installed on an organization. You can remove up to 50 repositories at a time. You cannot remove repositories from an app installed on `all` repositories, nor can you remove the last repository for an app. If you attempt to do so, the API will return a 422 Unprocessable Entity error. + + This API can only be called by a GitHub App installed on the enterprise that owns the organization. + tags: + - apps + operationId: enterprise-apps/remove-repository-access-to-installation + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/organization-installations#remove-repository-access-from-an-organization-installation + parameters: + - "$ref": "#/components/parameters/enterprise" + - "$ref": "#/components/parameters/org" + - "$ref": "#/components/parameters/installation-id" + responses: + '200': + description: A list of repositories which the authenticated GitHub App has + lost access to. + content: + application/json: + schema: + type: array + items: + "$ref": "#/components/schemas/accessible-repository" + examples: + default: + value: + - id: 1 + name: Hello World + full_name: octocat/Hello-World + - id: 2 + login: Goodbye World + full_name: octocat/Goodbye-World + '422': + description: The request was well-formed but was unable to be followed due + to semantic errors. This can happen if you attempt to remove a repository + from an installation that has access to `all` repositories, or if you + attempt to remove the last repository from an installation. + content: + application/json: + schema: + "$ref": "#/components/schemas/basic-error" + examples: + default: + value: + - message: Cannot remove the last repository from this installation. + Uninstall this application instead. + - documentation_url: https://docs.github.com/rest/enterprise-admin/organization-installations#remove-repository-access-to-an-organization-installation + - status: 422 + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + repositories: + type: array + description: The repository names to remove from the installation. + items: + type: string + maxItems: 50 + required: + - repositories + examples: + repositories: + value: + repositories: + - hello-world + - hello-world-2 + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: organization-installations "/enterprises/{enterprise}/audit-log": get: summary: Get the audit log for an enterprise @@ -17923,8 +18407,11 @@ paths: subcategory: members delete: summary: Remove an organization member - description: Removing a user from this list will remove them from all teams - and they will no longer have any access to the organization's repositories. + description: |- + Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories. + + > [!NOTE] + > If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team. tags: - orgs operationId: orgs/remove-member @@ -18229,6 +18716,9 @@ paths: In order to remove a user's membership with an organization, the authenticated user must be an organization owner. If the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases. + + > [!NOTE] + > If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team. tags: - orgs operationId: orgs/remove-membership-for-user @@ -79840,7 +80330,7 @@ components: - object repository_selection: description: Describe whether all repositories have been selected or there's - a selection involved + a selection involved. For enterprise installations this is `selected`. type: string enum: - all @@ -79864,6 +80354,10 @@ components: type: integer examples: - 1 + client_id: + type: string + examples: + - Iv1.ab1112223334445c target_id: description: The ID of the user or organization this token is being scoped to. @@ -80538,7 +81032,8 @@ components: - updated_at installation-token: title: Installation Token - description: Authentication token for a GitHub App installed on a user or org. + description: Authentication token for a GitHub App installed on a user, org, + or enterprise. type: object properties: token: @@ -82166,6 +82661,101 @@ components: "$ref": "#/components/schemas/announcement-user-dismissible" required: - announcement + installable-organization: + title: Installable Organization + description: A GitHub organization on which a GitHub App can be installed. + type: object + properties: + id: + type: integer + examples: + - 1 + login: + type: string + examples: + - github + accessible_repositories_url: + type: string + format: uri + examples: + - https://api.github.com/enterprises/biz-name/apps/organizations/org-login/accessible_repositories + required: + - id + - login + accessible-repository: + title: Accessible Repository + description: A repository that may be made accessible to a GitHub App. + type: object + properties: + id: + description: Unique identifier of the repository + type: integer + format: int64 + examples: + - 1 + name: + description: The name of the repository. + type: string + examples: + - Team Environment + full_name: + type: string + examples: + - octocat/Hello-World + required: + - full_name + - id + - name + enterprise-organization-installation: + title: Enterprise Organization Installation + description: A GitHub App Installation on an enterprise-owned organization + type: object + properties: + id: + description: The ID of the installation. + type: integer + examples: + - 1 + app_slug: + type: string + examples: + - github/github-actions + client_id: + type: string + examples: + - Iv1.ab1112223334445c + repository_selection: + description: Describe whether all repositories have been selected or there's + a selection involved + type: string + enum: + - all + - selected + repositories_url: + type: string + format: uri + examples: + - https://api.github.com/enterprises/acme-corp/apps/organizations/some-org/installations/1/repositories + permissions: + "$ref": "#/components/schemas/app-permissions" + events: + type: array + items: + type: string + created_at: + type: string + format: date-time + updated_at: + type: string + format: date-time + required: + - id + - client_id + - repository_selection + - repositories_url + - permissions + - created_at + - updated_at audit-log-event: type: object properties: @@ -219613,6 +220203,21 @@ components: announcement: Very **important** announcement about _something_. expires_at: '2021-01-01T00:00:00.000+00:00' user_dismissible: false + enterprise-organization-installation: + value: + id: 1 + app_slug: monalisa/orbit + repository_selection: selected + repositories_url: https://api.github.com/enterprises/acme-corp/apps/organizations/some-org/installations/1/repositories + permissions: + checks: write + metadata: read + contents: read + events: + - push + - pull_request + created_at: '2017-07-08T16:18:44-04:00' + updated_at: '2017-07-08T16:18:44-04:00' audit-log: value: - "@timestamp": 1606929874512 @@ -245415,6 +246020,13 @@ components: required: true schema: type: string + org: + name: org + description: The organization name. The name is not case sensitive. + in: path + required: true + schema: + type: string audit-log-enterprise-phrase: name: phrase description: A search phrase. For more information, see [Searching the audit @@ -245690,13 +246302,6 @@ components: required: true schema: type: string - org: - name: org - description: The organization name. The name is not case sensitive. - in: path - required: true - schema: - type: string custom-property-name: name: custom_property_name description: The custom property name diff --git a/descriptions-next/ghes-3.13/dereferenced/ghes-3.13.2022-11-28.deref.json b/descriptions-next/ghes-3.13/dereferenced/ghes-3.13.2022-11-28.deref.json index b74d242cbe..fd1b37e551 100644 --- a/descriptions-next/ghes-3.13/dereferenced/ghes-3.13.2022-11-28.deref.json +++ b/descriptions-next/ghes-3.13/dereferenced/ghes-3.13.2022-11-28.deref.json @@ -12332,6 +12332,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -13417,6 +13423,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -14172,7 +14184,7 @@ }, "delete": { "summary": "Delete an installation for the authenticated app", - "description": "Uninstalls a GitHub App on a user, organization, or business account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the \"[Suspend an app installation](https://docs.github.com/enterprise-server@3.13/rest/apps/apps#suspend-an-app-installation)\" endpoint.\n\nYou must use a [JWT](https://docs.github.com/enterprise-server@3.13/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", + "description": "Uninstalls a GitHub App on a user, organization, or enterprise account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the \"[Suspend an app installation](https://docs.github.com/enterprise-server@3.13/rest/apps/apps#suspend-an-app-installation)\" endpoint.\n\nYou must use a [JWT](https://docs.github.com/enterprise-server@3.13/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", "tags": [ "apps" ], @@ -16408,7 +16420,7 @@ "/app/installations/{installation_id}/suspended": { "put": { "summary": "Suspend an app installation", - "description": "Suspends a GitHub App on a user, organization, or business account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub Enterprise Server API or webhook events is blocked for that account.\n\nYou must use a [JWT](https://docs.github.com/enterprise-server@3.13/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", + "description": "Suspends a GitHub App on a user, organization, or enterprise account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub Enterprise Server API or webhook events is blocked for that account.\n\nYou must use a [JWT](https://docs.github.com/enterprise-server@3.13/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", "tags": [ "apps" ], @@ -108697,6 +108709,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -109797,6 +109815,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -114192,7 +114216,7 @@ }, "delete": { "summary": "Remove an organization member", - "description": "Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories.", + "description": "Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories.\n\n> [!NOTE]\n> If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team.", "tags": [ "orgs" ], @@ -115303,7 +115327,7 @@ }, "delete": { "summary": "Remove organization membership for a user", - "description": "In order to remove a user's membership with an organization, the authenticated user must be an organization owner.\n\nIf the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases.", + "description": "In order to remove a user's membership with an organization, the authenticated user must be an organization owner.\n\nIf the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases.\n\n> [!NOTE]\n> If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team.", "tags": [ "orgs" ], @@ -302055,6 +302079,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -488813,6 +488843,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -536016,6 +536052,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -715491,6 +715533,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -718567,6 +718615,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -721548,6 +721602,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -724529,6 +724589,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -727644,6 +727710,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -730766,6 +730838,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -735899,6 +735977,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" diff --git a/descriptions-next/ghes-3.13/dereferenced/ghes-3.13.2022-11-28.deref.yaml b/descriptions-next/ghes-3.13/dereferenced/ghes-3.13.2022-11-28.deref.yaml index b875288b8c..4e74cffcf3 100644 --- a/descriptions-next/ghes-3.13/dereferenced/ghes-3.13.2022-11-28.deref.yaml +++ b/descriptions-next/ghes-3.13/dereferenced/ghes-3.13.2022-11-28.deref.yaml @@ -5126,6 +5126,10 @@ paths: type: integer examples: - 1 + client_id: + type: string + examples: + - Iv1.ab1112223334445c target_id: description: The ID of the user or organization this token is being scoped to. @@ -5339,7 +5343,7 @@ paths: delete: summary: Delete an installation for the authenticated app description: |- - Uninstalls a GitHub App on a user, organization, or business account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the "[Suspend an app installation](https://docs.github.com/enterprise-server@3.13/rest/apps/apps#suspend-an-app-installation)" endpoint. + Uninstalls a GitHub App on a user, organization, or enterprise account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the "[Suspend an app installation](https://docs.github.com/enterprise-server@3.13/rest/apps/apps#suspend-an-app-installation)" endpoint. You must use a [JWT](https://docs.github.com/enterprise-server@3.13/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. tags: @@ -6198,7 +6202,7 @@ paths: put: summary: Suspend an app installation description: |- - Suspends a GitHub App on a user, organization, or business account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub Enterprise Server API or webhook events is blocked for that account. + Suspends a GitHub App on a user, organization, or enterprise account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub Enterprise Server API or webhook events is blocked for that account. You must use a [JWT](https://docs.github.com/enterprise-server@3.13/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. tags: @@ -28265,8 +28269,11 @@ paths: subcategory: members delete: summary: Remove an organization member - description: Removing a user from this list will remove them from all teams - and they will no longer have any access to the organization's repositories. + description: |- + Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories. + + > [!NOTE] + > If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team. tags: - orgs operationId: orgs/remove-member @@ -28470,6 +28477,9 @@ paths: In order to remove a user's membership with an organization, the authenticated user must be an organization owner. If the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases. + + > [!NOTE] + > If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team. tags: - orgs operationId: orgs/remove-membership-for-user diff --git a/descriptions-next/ghes-3.13/dereferenced/ghes-3.13.deref.json b/descriptions-next/ghes-3.13/dereferenced/ghes-3.13.deref.json index b74d242cbe..fd1b37e551 100644 --- a/descriptions-next/ghes-3.13/dereferenced/ghes-3.13.deref.json +++ b/descriptions-next/ghes-3.13/dereferenced/ghes-3.13.deref.json @@ -12332,6 +12332,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -13417,6 +13423,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -14172,7 +14184,7 @@ }, "delete": { "summary": "Delete an installation for the authenticated app", - "description": "Uninstalls a GitHub App on a user, organization, or business account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the \"[Suspend an app installation](https://docs.github.com/enterprise-server@3.13/rest/apps/apps#suspend-an-app-installation)\" endpoint.\n\nYou must use a [JWT](https://docs.github.com/enterprise-server@3.13/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", + "description": "Uninstalls a GitHub App on a user, organization, or enterprise account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the \"[Suspend an app installation](https://docs.github.com/enterprise-server@3.13/rest/apps/apps#suspend-an-app-installation)\" endpoint.\n\nYou must use a [JWT](https://docs.github.com/enterprise-server@3.13/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", "tags": [ "apps" ], @@ -16408,7 +16420,7 @@ "/app/installations/{installation_id}/suspended": { "put": { "summary": "Suspend an app installation", - "description": "Suspends a GitHub App on a user, organization, or business account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub Enterprise Server API or webhook events is blocked for that account.\n\nYou must use a [JWT](https://docs.github.com/enterprise-server@3.13/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", + "description": "Suspends a GitHub App on a user, organization, or enterprise account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub Enterprise Server API or webhook events is blocked for that account.\n\nYou must use a [JWT](https://docs.github.com/enterprise-server@3.13/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.", "tags": [ "apps" ], @@ -108697,6 +108709,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -109797,6 +109815,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -114192,7 +114216,7 @@ }, "delete": { "summary": "Remove an organization member", - "description": "Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories.", + "description": "Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories.\n\n> [!NOTE]\n> If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team.", "tags": [ "orgs" ], @@ -115303,7 +115327,7 @@ }, "delete": { "summary": "Remove organization membership for a user", - "description": "In order to remove a user's membership with an organization, the authenticated user must be an organization owner.\n\nIf the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases.", + "description": "In order to remove a user's membership with an organization, the authenticated user must be an organization owner.\n\nIf the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases.\n\n> [!NOTE]\n> If a user has both direct membership in the organization as well as indirect membership via an enterprise team, only their direct membership will be removed. Their indirect membership via an enterprise team remains until the user is removed from the enterprise team.", "tags": [ "orgs" ], @@ -302055,6 +302079,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -488813,6 +488843,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -536016,6 +536052,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -715491,6 +715533,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -718567,6 +718615,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -721548,6 +721602,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -724529,6 +724589,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or organization this token is being scoped to.", "type": "integer" @@ -727644,6 +727710,12 @@ 1 ] }, + "client_id": { + "type": "string", + "examples": [ + "Iv1.ab1112223334445c" + ] + }, "target_id": { "description": "The ID of the user or {"code":"internal","msg":"git-diff-tree: context deadline exceeded","meta":{"cause":"*fmt.wrapError"}}