diff --git a/descriptions/api.github.com/api.github.com.2022-11-28.json b/descriptions/api.github.com/api.github.com.2022-11-28.json index fa7adeba5d..32f350fe62 100644 --- a/descriptions/api.github.com/api.github.com.2022-11-28.json +++ b/descriptions/api.github.com/api.github.com.2022-11-28.json @@ -71290,7 +71290,7 @@ }, "post": { "summary": "Create a release", - "description": "Users with push access to the repository can create a release.\n\nThis endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see \"[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)\" and \"[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api).\"", + "description": "Users with push access to the repository can create a release.\n\n> [!NOTE]\n> If the commit identified by `target_commitish` (or, when `target_commitish` is omitted, the latest commit on the default branch) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead.\n\nOAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the \"Workflows\" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see \"[Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)\".\n\nThis endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see \"[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)\" and \"[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api).\"", "tags": [ "repos" ], @@ -71843,7 +71843,7 @@ }, "patch": { "summary": "Update a release", - "description": "Users with push access to the repository can edit a release.", + "description": "Users with push access to the repository can edit a release.\n\n> [!NOTE]\n> If the resolved target commit (the new value of `target_commitish` if you are changing it, otherwise the existing target) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead.\n\nOAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the \"Workflows\" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see \"[Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)\".", "tags": [ "repos" ], @@ -135361,17 +135361,14 @@ "type": "string", "description": "A machine-readable code describing the error.", "enum": [ - "none", - "config_load", - "compile_db", + "invalid", + "unprocessable", "start_delimiter", "end_delimiter", - "display_name", + "name", "must_match", "must_not_match", - "custom_pattern_version_mismatch", - "db_size", - "db_size_calculation" + "custom_pattern_version_mismatch" ] }, "message": { @@ -140951,6 +140948,15 @@ "enum": [ "weekly" ] + }, + "ai_findings_option": { + "description": "The AI findings configuration for the repository.", + "nullable": true, + "type": "string", + "enum": [ + "disabled", + "on_push" + ] } } }, @@ -140994,6 +141000,14 @@ "ruby" ] } + }, + "ai_findings_option": { + "description": "Whether AI findings run for Code Quality on this repository.", + "type": "string", + "enum": [ + "disabled", + "on_push" + ] } }, "anyOf": [ @@ -141016,6 +141030,11 @@ "required": [ "languages" ] + }, + { + "required": [ + "ai_findings_option" + ] } ], "additionalProperties": false @@ -319800,7 +319819,8 @@ "runner_type": "standard", "runner_label": null, "updated_at": "2023-01-01T00:00:00Z", - "schedule": "weekly" + "schedule": "weekly", + "ai_findings_option": "on_push" } }, "code-quality-setup-update": { diff --git a/descriptions/api.github.com/api.github.com.2022-11-28.yaml b/descriptions/api.github.com/api.github.com.2022-11-28.yaml index 2ae8d3a404..586b945f26 100644 --- a/descriptions/api.github.com/api.github.com.2022-11-28.yaml +++ b/descriptions/api.github.com/api.github.com.2022-11-28.yaml @@ -52398,6 +52398,11 @@ paths: description: |- Users with push access to the repository can create a release. + > [!NOTE] + > If the commit identified by `target_commitish` (or, when `target_commitish` is omitted, the latest commit on the default branch) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead. + + OAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the "Workflows" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see "[Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)". + This endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)" and "[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api)." tags: - repos @@ -52799,7 +52804,13 @@ paths: subcategory: releases patch: summary: Update a release - description: Users with push access to the repository can edit a release. + description: |- + Users with push access to the repository can edit a release. + + > [!NOTE] + > If the resolved target commit (the new value of `target_commitish` if you are changing it, otherwise the existing target) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead. + + OAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the "Workflows" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see "[Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)". tags: - repos operationId: repos/update-release @@ -99761,17 +99772,14 @@ components: type: string description: A machine-readable code describing the error. enum: - - none - - config_load - - compile_db + - invalid + - unprocessable - start_delimiter - end_delimiter - - display_name + - name - must_match - must_not_match - custom_pattern_version_mismatch - - db_size - - db_size_calculation message: type: string description: A human-readable description of the error. @@ -104110,6 +104118,13 @@ components: type: string enum: - weekly + ai_findings_option: + description: The AI findings configuration for the repository. + nullable: true + type: string + enum: + - disabled + - on_push code-quality-setup-update: description: Configuration for code quality setup. type: object @@ -104143,6 +104158,12 @@ components: - javascript-typescript - python - ruby + ai_findings_option: + description: Whether AI findings run for Code Quality on this repository. + type: string + enum: + - disabled + - on_push anyOf: - required: - state @@ -104152,6 +104173,8 @@ components: - runner_label - required: - languages + - required: + - ai_findings_option additionalProperties: false code-quality-setup-update-response: description: |- @@ -240951,6 +240974,7 @@ components: runner_label: updated_at: '2023-01-01T00:00:00Z' schedule: weekly + ai_findings_option: on_push code-quality-setup-update: value: state: configured diff --git a/descriptions/api.github.com/api.github.com.2026-03-10.json b/descriptions/api.github.com/api.github.com.2026-03-10.json index b2934388c7..098ee09484 100644 --- a/descriptions/api.github.com/api.github.com.2026-03-10.json +++ b/descriptions/api.github.com/api.github.com.2026-03-10.json @@ -71207,7 +71207,7 @@ }, "post": { "summary": "Create a release", - "description": "Users with push access to the repository can create a release.\n\nThis endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see \"[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)\" and \"[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api).\"", + "description": "Users with push access to the repository can create a release.\n\n> [!NOTE]\n> If the commit identified by `target_commitish` (or, when `target_commitish` is omitted, the latest commit on the default branch) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead.\n\nOAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the \"Workflows\" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see \"[Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)\".\n\nThis endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see \"[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)\" and \"[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api).\"", "tags": [ "repos" ], @@ -71760,7 +71760,7 @@ }, "patch": { "summary": "Update a release", - "description": "Users with push access to the repository can edit a release.", + "description": "Users with push access to the repository can edit a release.\n\n> [!NOTE]\n> If the resolved target commit (the new value of `target_commitish` if you are changing it, otherwise the existing target) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead.\n\nOAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the \"Workflows\" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see \"[Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)\".", "tags": [ "repos" ], @@ -134827,17 +134827,14 @@ "type": "string", "description": "A machine-readable code describing the error.", "enum": [ - "none", - "config_load", - "compile_db", + "invalid", + "unprocessable", "start_delimiter", "end_delimiter", - "display_name", + "name", "must_match", "must_not_match", - "custom_pattern_version_mismatch", - "db_size", - "db_size_calculation" + "custom_pattern_version_mismatch" ] }, "message": { @@ -140382,6 +140379,15 @@ "enum": [ "weekly" ] + }, + "ai_findings_option": { + "description": "The AI findings configuration for the repository.", + "nullable": true, + "type": "string", + "enum": [ + "disabled", + "on_push" + ] } } }, @@ -140425,6 +140431,14 @@ "ruby" ] } + }, + "ai_findings_option": { + "description": "Whether AI findings run for Code Quality on this repository.", + "type": "string", + "enum": [ + "disabled", + "on_push" + ] } }, "anyOf": [ @@ -140447,6 +140461,11 @@ "required": [ "languages" ] + }, + { + "required": [ + "ai_findings_option" + ] } ], "additionalProperties": false @@ -319030,7 +319049,8 @@ "runner_type": "standard", "runner_label": null, "updated_at": "2023-01-01T00:00:00Z", - "schedule": "weekly" + "schedule": "weekly", + "ai_findings_option": "on_push" } }, "code-quality-setup-update": { diff --git a/descriptions/api.github.com/api.github.com.2026-03-10.yaml b/descriptions/api.github.com/api.github.com.2026-03-10.yaml index 56af258cdc..866623f9c2 100644 --- a/descriptions/api.github.com/api.github.com.2026-03-10.yaml +++ b/descriptions/api.github.com/api.github.com.2026-03-10.yaml @@ -52326,6 +52326,11 @@ paths: description: |- Users with push access to the repository can create a release. + > [!NOTE] + > If the commit identified by `target_commitish` (or, when `target_commitish` is omitted, the latest commit on the default branch) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead. + + OAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the "Workflows" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see "[Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)". + This endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)" and "[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api)." tags: - repos @@ -52727,7 +52732,13 @@ paths: subcategory: releases patch: summary: Update a release - description: Users with push access to the repository can edit a release. + description: |- + Users with push access to the repository can edit a release. + + > [!NOTE] + > If the resolved target commit (the new value of `target_commitish` if you are changing it, otherwise the existing target) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead. + + OAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the "Workflows" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see "[Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)". tags: - repos operationId: repos/update-release @@ -99337,17 +99348,14 @@ components: type: string description: A machine-readable code describing the error. enum: - - none - - config_load - - compile_db + - invalid + - unprocessable - start_delimiter - end_delimiter - - display_name + - name - must_match - must_not_match - custom_pattern_version_mismatch - - db_size - - db_size_calculation message: type: string description: A human-readable description of the error. @@ -103658,6 +103666,13 @@ components: type: string enum: - weekly + ai_findings_option: + description: The AI findings configuration for the repository. + nullable: true + type: string + enum: + - disabled + - on_push code-quality-setup-update: description: Configuration for code quality setup. type: object @@ -103691,6 +103706,12 @@ components: - javascript-typescript - python - ruby + ai_findings_option: + description: Whether AI findings run for Code Quality on this repository. + type: string + enum: + - disabled + - on_push anyOf: - required: - state @@ -103700,6 +103721,8 @@ components: - runner_label - required: - languages + - required: + - ai_findings_option additionalProperties: false code-quality-setup-update-response: description: |- @@ -240254,6 +240277,7 @@ components: runner_label: updated_at: '2023-01-01T00:00:00Z' schedule: weekly + ai_findings_option: on_push code-quality-setup-update: value: state: configured diff --git a/descriptions/api.github.com/api.github.com.json b/descriptions/api.github.com/api.github.com.json index cfd7a7c93a..e0ee723a26 100644 --- a/descriptions/api.github.com/api.github.com.json +++ b/descriptions/api.github.com/api.github.com.json @@ -71597,7 +71597,7 @@ }, "post": { "summary": "Create a release", - "description": "Users with push access to the repository can create a release.\n\nThis endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see \"[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)\" and \"[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api).\"", + "description": "Users with push access to the repository can create a release.\n\n> [!NOTE]\n> If the commit identified by `target_commitish` (or, when `target_commitish` is omitted, the latest commit on the default branch) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead.\n\nOAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the \"Workflows\" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see \"[Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)\".\n\nThis endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see \"[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)\" and \"[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api).\"", "tags": [ "repos" ], @@ -72150,7 +72150,7 @@ }, "patch": { "summary": "Update a release", - "description": "Users with push access to the repository can edit a release.", + "description": "Users with push access to the repository can edit a release.\n\n> [!NOTE]\n> If the resolved target commit (the new value of `target_commitish` if you are changing it, otherwise the existing target) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead.\n\nOAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the \"Workflows\" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see \"[Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)\".", "tags": [ "repos" ], @@ -136349,17 +136349,14 @@ "type": "string", "description": "A machine-readable code describing the error.", "enum": [ - "none", - "config_load", - "compile_db", + "invalid", + "unprocessable", "start_delimiter", "end_delimiter", - "display_name", + "name", "must_match", "must_not_match", - "custom_pattern_version_mismatch", - "db_size", - "db_size_calculation" + "custom_pattern_version_mismatch" ] }, "message": { @@ -142076,6 +142073,15 @@ "enum": [ "weekly" ] + }, + "ai_findings_option": { + "description": "The AI findings configuration for the repository.", + "nullable": true, + "type": "string", + "enum": [ + "disabled", + "on_push" + ] } } }, @@ -142119,6 +142125,14 @@ "ruby" ] } + }, + "ai_findings_option": { + "description": "Whether AI findings run for Code Quality on this repository.", + "type": "string", + "enum": [ + "disabled", + "on_push" + ] } }, "anyOf": [ @@ -142141,6 +142155,11 @@ "required": [ "languages" ] + }, + { + "required": [ + "ai_findings_option" + ] } ], "additionalProperties": false @@ -322013,7 +322032,8 @@ "runner_type": "standard", "runner_label": null, "updated_at": "2023-01-01T00:00:00Z", - "schedule": "weekly" + "schedule": "weekly", + "ai_findings_option": "on_push" } }, "code-quality-setup-update": { diff --git a/descriptions/api.github.com/api.github.com.yaml b/descriptions/api.github.com/api.github.com.yaml index 475150e862..5b137308e0 100644 --- a/descriptions/api.github.com/api.github.com.yaml +++ b/descriptions/api.github.com/api.github.com.yaml @@ -52586,6 +52586,11 @@ paths: description: |- Users with push access to the repository can create a release. + > [!NOTE] + > If the commit identified by `target_commitish` (or, when `target_commitish` is omitted, the latest commit on the default branch) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead. + + OAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the "Workflows" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see "[Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)". + This endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)" and "[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api)." tags: - repos @@ -52987,7 +52992,13 @@ paths: subcategory: releases patch: summary: Update a release - description: Users with push access to the repository can edit a release. + description: |- + Users with push access to the repository can edit a release. + + > [!NOTE] + > If the resolved target commit (the new value of `target_commitish` if you are changing it, otherwise the existing target) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead. + + OAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the "Workflows" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see "[Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)". tags: - repos operationId: repos/update-release @@ -100441,17 +100452,14 @@ components: type: string description: A machine-readable code describing the error. enum: - - none - - config_load - - compile_db + - invalid + - unprocessable - start_delimiter - end_delimiter - - display_name + - name - must_match - must_not_match - custom_pattern_version_mismatch - - db_size - - db_size_calculation message: type: string description: A human-readable description of the error. @@ -104909,6 +104917,13 @@ components: type: string enum: - weekly + ai_findings_option: + description: The AI findings configuration for the repository. + nullable: true + type: string + enum: + - disabled + - on_push code-quality-setup-update: description: Configuration for code quality setup. type: object @@ -104942,6 +104957,12 @@ components: - javascript-typescript - python - ruby + ai_findings_option: + description: Whether AI findings run for Code Quality on this repository. + type: string + enum: + - disabled + - on_push anyOf: - required: - state @@ -104951,6 +104972,8 @@ components: - runner_label - required: - languages + - required: + - ai_findings_option additionalProperties: false code-quality-setup-update-response: description: |- @@ -242392,6 +242415,7 @@ components: runner_label: updated_at: '2023-01-01T00:00:00Z' schedule: weekly + ai_findings_option: on_push code-quality-setup-update: value: state: configured diff --git a/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json b/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json index da28b1c463..ccf7a1b670 100644 --- a/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json +++ b/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json @@ -225124,17 +225124,14 @@ "type": "string", "description": "A machine-readable code describing the error.", "enum": [ - "none", - "config_load", - "compile_db", + "invalid", + "unprocessable", "start_delimiter", "end_delimiter", - "display_name", + "name", "must_match", "must_not_match", - "custom_pattern_version_mismatch", - "db_size", - "db_size_calculation" + "custom_pattern_version_mismatch" ] }, "message": { @@ -309698,6 +309695,15 @@ "enum": [ "weekly" ] + }, + "ai_findings_option": { + "description": "The AI findings configuration for the repository.", + "nullable": true, + "type": "string", + "enum": [ + "disabled", + "on_push" + ] } } }, @@ -309712,7 +309718,8 @@ "runner_type": "standard", "runner_label": null, "updated_at": "2023-01-01T00:00:00Z", - "schedule": "weekly" + "schedule": "weekly", + "ai_findings_option": "on_push" } } } @@ -309875,6 +309882,14 @@ "ruby" ] } + }, + "ai_findings_option": { + "description": "Whether AI findings run for Code Quality on this repository.", + "type": "string", + "enum": [ + "disabled", + "on_push" + ] } }, "anyOf": [ @@ -309897,6 +309912,11 @@ "required": [ "languages" ] + }, + { + "required": [ + "ai_findings_option" + ] } ], "additionalProperties": false @@ -557258,7 +557278,7 @@ }, "post": { "summary": "Create a release", - "description": "Users with push access to the repository can create a release.\n\nThis endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see \"[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)\" and \"[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api).\"", + "description": "Users with push access to the repository can create a release.\n\n> [!NOTE]\n> If the commit identified by `target_commitish` (or, when `target_commitish` is omitted, the latest commit on the default branch) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead.\n\nOAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the \"Workflows\" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see \"[Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)\".\n\nThis endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see \"[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)\" and \"[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api).\"", "tags": [ "repos" ], @@ -560878,7 +560898,7 @@ }, "patch": { "summary": "Update a release", - "description": "Users with push access to the repository can edit a release.", + "description": "Users with push access to the repository can edit a release.\n\n> [!NOTE]\n> If the resolved target commit (the new value of `target_commitish` if you are changing it, otherwise the existing target) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead.\n\nOAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the \"Workflows\" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see \"[Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)\".", "tags": [ "repos" ], @@ -580008,17 +580028,14 @@ "type": "string", "description": "A machine-readable code describing the error.", "enum": [ - "none", - "config_load", - "compile_db", + "invalid", + "unprocessable", "start_delimiter", "end_delimiter", - "display_name", + "name", "must_match", "must_not_match", - "custom_pattern_version_mismatch", - "db_size", - "db_size_calculation" + "custom_pattern_version_mismatch" ] }, "message": { diff --git a/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml b/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml index 2d3ab692a0..427e9c4dfc 100644 --- a/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml +++ b/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml @@ -53422,17 +53422,14 @@ paths: description: A machine-readable code describing the error. enum: - - none - - config_load - - compile_db + - invalid + - unprocessable - start_delimiter - end_delimiter - - display_name + - name - must_match - must_not_match - custom_pattern_version_mismatch - - db_size - - db_size_calculation message: type: string description: A human-readable description of the error. @@ -71001,6 +70998,13 @@ paths: type: string enum: - weekly + ai_findings_option: + description: The AI findings configuration for the repository. + nullable: true + type: string + enum: + - disabled + - on_push examples: default: value: @@ -71012,6 +71016,7 @@ paths: runner_label: updated_at: '2023-01-01T00:00:00Z' schedule: weekly + ai_findings_option: on_push '403': *443 '404': *6 '503': *123 @@ -71072,6 +71077,12 @@ paths: - javascript-typescript - python - ruby + ai_findings_option: + description: Whether AI findings run for Code Quality on this repository. + type: string + enum: + - disabled + - on_push anyOf: - required: - state @@ -71081,6 +71092,8 @@ paths: - runner_label - required: - languages + - required: + - ai_findings_option additionalProperties: false examples: default: @@ -100550,6 +100563,11 @@ paths: description: |- Users with push access to the repository can create a release. + > [!NOTE] + > If the commit identified by `target_commitish` (or, when `target_commitish` is omitted, the latest commit on the default branch) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead. + + OAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the "Workflows" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see "[Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)". + This endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)" and "[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api)." tags: - repos @@ -101063,7 +101081,13 @@ paths: subcategory: releases patch: summary: Update a release - description: Users with push access to the repository can edit a release. + description: |- + Users with push access to the repository can edit a release. + + > [!NOTE] + > If the resolved target commit (the new value of `target_commitish` if you are changing it, otherwise the existing target) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead. + + OAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the "Workflows" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see "[Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)". tags: - repos operationId: repos/update-release diff --git a/descriptions/api.github.com/dereferenced/api.github.com.2026-03-10.deref.json b/descriptions/api.github.com/dereferenced/api.github.com.2026-03-10.deref.json index 2932841fc4..ecf966d870 100644 --- a/descriptions/api.github.com/dereferenced/api.github.com.2026-03-10.deref.json +++ b/descriptions/api.github.com/dereferenced/api.github.com.2026-03-10.deref.json @@ -219286,17 +219286,14 @@ "type": "string", "description": "A machine-readable code describing the error.", "enum": [ - "none", - "config_load", - "compile_db", + "invalid", + "unprocessable", "start_delimiter", "end_delimiter", - "display_name", + "name", "must_match", "must_not_match", - "custom_pattern_version_mismatch", - "db_size", - "db_size_calculation" + "custom_pattern_version_mismatch" ] }, "message": { @@ -303566,6 +303563,15 @@ "enum": [ "weekly" ] + }, + "ai_findings_option": { + "description": "The AI findings configuration for the repository.", + "nullable": true, + "type": "string", + "enum": [ + "disabled", + "on_push" + ] } } }, @@ -303580,7 +303586,8 @@ "runner_type": "standard", "runner_label": null, "updated_at": "2023-01-01T00:00:00Z", - "schedule": "weekly" + "schedule": "weekly", + "ai_findings_option": "on_push" } } } @@ -303743,6 +303750,14 @@ "ruby" ] } + }, + "ai_findings_option": { + "description": "Whether AI findings run for Code Quality on this repository.", + "type": "string", + "enum": [ + "disabled", + "on_push" + ] } }, "anyOf": [ @@ -303765,6 +303780,11 @@ "required": [ "languages" ] + }, + { + "required": [ + "ai_findings_option" + ] } ], "additionalProperties": false @@ -546594,7 +546614,7 @@ }, "post": { "summary": "Create a release", - "description": "Users with push access to the repository can create a release.\n\nThis endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see \"[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)\" and \"[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api).\"", + "description": "Users with push access to the repository can create a release.\n\n> [!NOTE]\n> If the commit identified by `target_commitish` (or, when `target_commitish` is omitted, the latest commit on the default branch) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead.\n\nOAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the \"Workflows\" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see \"[Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)\".\n\nThis endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see \"[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)\" and \"[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api).\"", "tags": [ "repos" ], @@ -550214,7 +550234,7 @@ }, "patch": { "summary": "Update a release", - "description": "Users with push access to the repository can edit a release.", + "description": "Users with push access to the repository can edit a release.\n\n> [!NOTE]\n> If the resolved target commit (the new value of `target_commitish` if you are changing it, otherwise the existing target) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead.\n\nOAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the \"Workflows\" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see \"[Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)\".", "tags": [ "repos" ], @@ -569344,17 +569364,14 @@ "type": "string", "description": "A machine-readable code describing the error.", "enum": [ - "none", - "config_load", - "compile_db", + "invalid", + "unprocessable", "start_delimiter", "end_delimiter", - "display_name", + "name", "must_match", "must_not_match", - "custom_pattern_version_mismatch", - "db_size", - "db_size_calculation" + "custom_pattern_version_mismatch" ] }, "message": { diff --git a/descriptions/api.github.com/dereferenced/api.github.com.2026-03-10.deref.yaml b/descriptions/api.github.com/dereferenced/api.github.com.2026-03-10.deref.yaml index d05ca07881..d0766936de 100644 --- a/descriptions/api.github.com/dereferenced/api.github.com.2026-03-10.deref.yaml +++ b/descriptions/api.github.com/dereferenced/api.github.com.2026-03-10.deref.yaml @@ -53055,17 +53055,14 @@ paths: description: A machine-readable code describing the error. enum: - - none - - config_load - - compile_db + - invalid + - unprocessable - start_delimiter - end_delimiter - - display_name + - name - must_match - must_not_match - custom_pattern_version_mismatch - - db_size - - db_size_calculation message: type: string description: A human-readable description of the error. @@ -70569,6 +70566,13 @@ paths: type: string enum: - weekly + ai_findings_option: + description: The AI findings configuration for the repository. + nullable: true + type: string + enum: + - disabled + - on_push examples: default: value: @@ -70580,6 +70584,7 @@ paths: runner_label: updated_at: '2023-01-01T00:00:00Z' schedule: weekly + ai_findings_option: on_push '403': *443 '404': *6 '503': *123 @@ -70640,6 +70645,12 @@ paths: - javascript-typescript - python - ruby + ai_findings_option: + description: Whether AI findings run for Code Quality on this repository. + type: string + enum: + - disabled + - on_push anyOf: - required: - state @@ -70649,6 +70660,8 @@ paths: - runner_label - required: - languages + - required: + - ai_findings_option additionalProperties: false examples: default: @@ -100013,6 +100026,11 @@ paths: description: |- Users with push access to the repository can create a release. + > [!NOTE] + > If the commit identified by `target_commitish` (or, when `target_commitish` is omitted, the latest commit on the default branch) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead. + + OAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the "Workflows" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see "[Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)". + This endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)" and "[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api)." tags: - repos @@ -100526,7 +100544,13 @@ paths: subcategory: releases patch: summary: Update a release - description: Users with push access to the repository can edit a release. + description: |- + Users with push access to the repository can edit a release. + + > [!NOTE] + > If the resolved target commit (the new value of `target_commitish` if you are changing it, otherwise the existing target) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead. + + OAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the "Workflows" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see "[Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)". tags: - repos operationId: repos/update-release diff --git a/descriptions/api.github.com/dereferenced/api.github.com.deref.json b/descriptions/api.github.com/dereferenced/api.github.com.deref.json index 6a801fd90f..aae3668aec 100644 --- a/descriptions/api.github.com/dereferenced/api.github.com.deref.json +++ b/descriptions/api.github.com/dereferenced/api.github.com.deref.json @@ -231478,17 +231478,14 @@ "type": "string", "description": "A machine-readable code describing the error.", "enum": [ - "none", - "config_load", - "compile_db", + "invalid", + "unprocessable", "start_delimiter", "end_delimiter", - "display_name", + "name", "must_match", "must_not_match", - "custom_pattern_version_mismatch", - "db_size", - "db_size_calculation" + "custom_pattern_version_mismatch" ] }, "message": { @@ -317323,6 +317320,15 @@ "enum": [ "weekly" ] + }, + "ai_findings_option": { + "description": "The AI findings configuration for the repository.", + "nullable": true, + "type": "string", + "enum": [ + "disabled", + "on_push" + ] } } }, @@ -317337,7 +317343,8 @@ "runner_type": "standard", "runner_label": null, "updated_at": "2023-01-01T00:00:00Z", - "schedule": "weekly" + "schedule": "weekly", + "ai_findings_option": "on_push" } } } @@ -317500,6 +317507,14 @@ "ruby" ] } + }, + "ai_findings_option": { + "description": "Whether AI findings run for Code Quality on this repository.", + "type": "string", + "enum": [ + "disabled", + "on_push" + ] } }, "anyOf": [ @@ -317522,6 +317537,11 @@ "required": [ "languages" ] + }, + { + "required": [ + "ai_findings_option" + ] } ], "additionalProperties": false @@ -571084,7 +571104,7 @@ }, "post": { "summary": "Create a release", - "description": "Users with push access to the repository can create a release.\n\nThis endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see \"[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)\" and \"[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api).\"", + "description": "Users with push access to the repository can create a release.\n\n> [!NOTE]\n> If the commit identified by `target_commitish` (or, when `target_commitish` is omitted, the latest commit on the default branch) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead.\n\nOAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the \"Workflows\" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see \"[Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)\".\n\nThis endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see \"[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)\" and \"[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api).\"", "tags": [ "repos" ], @@ -574704,7 +574724,7 @@ }, "patch": { "summary": "Update a release", - "description": "Users with push access to the repository can edit a release.", + "description": "Users with push access to the repository can edit a release.\n\n> [!NOTE]\n> If the resolved target commit (the new value of `target_commitish` if you are changing it, otherwise the existing target) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead.\n\nOAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the \"Workflows\" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see \"[Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)\".", "tags": [ "repos" ], @@ -593834,17 +593854,14 @@ "type": "string", "description": "A machine-readable code describing the error.", "enum": [ - "none", - "config_load", - "compile_db", + "invalid", + "unprocessable", "start_delimiter", "end_delimiter", - "display_name", + "name", "must_match", "must_not_match", - "custom_pattern_version_mismatch", - "db_size", - "db_size_calculation" + "custom_pattern_version_mismatch" ] }, "message": { diff --git a/descriptions/api.github.com/dereferenced/api.github.com.deref.yaml b/descriptions/api.github.com/dereferenced/api.github.com.deref.yaml index f4739ca9e4..d895d9aec2 100644 --- a/descriptions/api.github.com/dereferenced/api.github.com.deref.yaml +++ b/descriptions/api.github.com/dereferenced/api.github.com.deref.yaml @@ -53890,17 +53890,14 @@ paths: description: A machine-readable code describing the error. enum: - - none - - config_load - - compile_db + - invalid + - unprocessable - start_delimiter - end_delimiter - - display_name + - name - must_match - must_not_match - custom_pattern_version_mismatch - - db_size - - db_size_calculation message: type: string description: A human-readable description of the error. @@ -71642,6 +71639,13 @@ paths: type: string enum: - weekly + ai_findings_option: + description: The AI findings configuration for the repository. + nullable: true + type: string + enum: + - disabled + - on_push examples: default: value: @@ -71653,6 +71657,7 @@ paths: runner_label: updated_at: '2023-01-01T00:00:00Z' schedule: weekly + ai_findings_option: on_push '403': *445 '404': *6 '503': *123 @@ -71713,6 +71718,12 @@ paths: - javascript-typescript - python - ruby + ai_findings_option: + description: Whether AI findings run for Code Quality on this repository. + type: string + enum: + - disabled + - on_push anyOf: - required: - state @@ -71722,6 +71733,8 @@ paths: - runner_label - required: - languages + - required: + - ai_findings_option additionalProperties: false examples: default: @@ -101387,6 +101400,11 @@ paths: description: |- Users with push access to the repository can create a release. + > [!NOTE] + > If the commit identified by `target_commitish` (or, when `target_commitish` is omitted, the latest commit on the default branch) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead. + + OAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the "Workflows" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see "[Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)". + This endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)" and "[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api)." tags: - repos @@ -101900,7 +101918,13 @@ paths: subcategory: releases patch: summary: Update a release - description: Users with push access to the repository can edit a release. + description: |- + Users with push access to the repository can edit a release. + + > [!NOTE] + > If the resolved target commit (the new value of `target_commitish` if you are changing it, otherwise the existing target) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead. + + OAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the "Workflows" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see "[Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)". tags: - repos operationId: repos/update-release diff --git a/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.json b/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.json index 2beded882f..c411a6de60 100644 --- a/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.json +++ b/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.json @@ -49776,6 +49776,211 @@ } } }, + "/enterprises/{enterprise}/credential-authorizations/revoke-credential-type": { + "post": { + "summary": "Revoke a single credential type for an enterprise", + "description": "Revokes a single credential type (for example, classic personal access tokens)\nacross all organizations within the enterprise. This removes the sign-in\nauthorizations for that credential type for every member of the enterprise.\n\nFor Enterprise Managed User (EMU) enterprises, you can optionally also destroy the\nactual credentials of that type owned by enterprise members by setting the\n`revoke_credentials` parameter to `true`.\n\nThis operation is performed asynchronously. A background job will be queued to process\nthe revocations.\n\n> [!WARNING]\n> If you use a personal access token to call this endpoint, that token may also be\n> revoked or destroyed as part of this operation.\n\nThe authenticated user must be an enterprise owner or have the `write_enterprise_credentials` permission to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) need the `admin:enterprise` scope to use this endpoint.", + "tags": [ + "enterprise-admin" + ], + "operationId": "enterprise-admin/revoke-credential-type-for-enterprise", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-an-enterprise" + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "credential_type" + ], + "properties": { + "credential_type": { + "type": "string", + "description": "The type of credential to revoke across the enterprise.", + "enum": [ + "classic_pat", + "fine_grained_pat", + "ssh_key", + "oauth_app_token" + ] + }, + "revoke_credentials": { + "type": "boolean", + "description": "Whether to also destroy the actual credentials of this type owned by\nenterprise members. This option is only available for Enterprise Managed\nUser (EMU) enterprises. When set to `true`, all credentials of the given\ntype owned by enterprise members will be destroyed in addition to the\ncredential authorizations. Note that `oauth_app_token` credentials cannot\nbe destroyed; for that type only the credential authorizations are revoked.", + "default": false + } + } + }, + "examples": { + "default": { + "value": { + "credential_type": "classic_pat", + "revoke_credentials": false + } + }, + "emu_with_credential_revocation": { + "summary": "EMU enterprise with credential revocation", + "value": { + "credential_type": "classic_pat", + "revoke_credentials": true + } + } + } + } + } + }, + "responses": { + "202": { + "description": "Accepted - The revocation request has been queued", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "message": { + "type": "string", + "description": "A message indicating the revocation has been queued" + }, + "warning": { + "type": "string", + "description": "A warning message if the token used for this request may be revoked" + } + } + }, + "examples": { + "default": { + "value": { + "message": "Credential type revocation has been queued" + } + }, + "with_warning": { + "value": { + "message": "Credential type revocation has been queued", + "warning": "The token used for this request may also have its authorization revoked as part of this operation" + } + } + } + } + } + }, + "403": { + "description": "Forbidden", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + }, + "422": { + "description": "Validation error - The `credential_type` is missing or invalid, or `revoke_credentials` is not available for this enterprise", + "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": { + "invalid_credential_type": { + "summary": "Missing or invalid `credential_type`", + "value": { + "message": "The `credential_type` parameter is required and must be one of: classic_pat, fine_grained_pat, ssh_key, oauth_app_token", + "documentation_url": "https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-an-enterprise" + } + }, + "non_emu_enterprise": { + "summary": "`revoke_credentials` requested on a non-EMU enterprise", + "value": { + "message": "The `revoke_credentials` option is only available for Enterprise Managed User (EMU) enterprises", + "documentation_url": "https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-an-enterprise" + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "credential-authorizations" + } + } + }, "/enterprises/{enterprise}/credential-authorizations/{username}/revoke": { "post": { "summary": "Revoke credential authorizations for a user in an enterprise", @@ -49983,6 +50188,235 @@ } } }, + "/enterprises/{enterprise}/credential-authorizations/{username}/revoke-credential-type": { + "post": { + "summary": "Revoke a single credential type for a user in an enterprise", + "description": "Revokes a single credential type (for example, classic personal access tokens)\nfor a single user within the enterprise. This removes the sign-in authorizations\nfor that credential type across all organizations in the enterprise for the user.\n\nFor Enterprise Managed User (EMU) enterprises, you can optionally also destroy the\nactual credential of that type owned by the user by setting the `revoke_credentials`\nparameter to `true`.\n\nThis operation is performed asynchronously. A background job will be queued to process\nthe revocations.\n\n> [!WARNING]\n> If you use a personal access token to call this endpoint and target yourself, that\n> token may also be revoked or destroyed as part of this operation.\n\nThe authenticated user must be an enterprise owner or have the `write_enterprise_credentials` permission to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) need the `admin:enterprise` scope to use this endpoint.", + "tags": [ + "enterprise-admin" + ], + "operationId": "enterprise-admin/revoke-credential-type-for-user", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-a-user-in-an-enterprise" + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "username", + "description": "The handle for the GitHub user account.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "credential_type" + ], + "properties": { + "credential_type": { + "type": "string", + "description": "The type of credential to revoke for the user.", + "enum": [ + "classic_pat", + "fine_grained_pat", + "ssh_key", + "oauth_app_token" + ] + }, + "revoke_credentials": { + "type": "boolean", + "description": "Whether to also destroy the actual credential of this type owned by the\nuser. This option is only available for Enterprise Managed User (EMU)\nenterprises. When set to `true`, the credential of the given type owned\nby the user will be destroyed in addition to the credential authorizations.\nNote that `oauth_app_token` credentials cannot be destroyed; for that type\nonly the credential authorizations are revoked.", + "default": false + } + } + }, + "examples": { + "default": { + "value": { + "credential_type": "classic_pat", + "revoke_credentials": false + } + }, + "emu_with_credential_revocation": { + "summary": "EMU enterprise with credential revocation", + "value": { + "credential_type": "classic_pat", + "revoke_credentials": true + } + } + } + } + } + }, + "responses": { + "202": { + "description": "Accepted - The revocation request has been queued", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "message": { + "type": "string", + "description": "A message indicating the revocation has been queued" + }, + "warning": { + "type": "string", + "description": "A warning message if the token used for this request may be revoked" + } + } + }, + "examples": { + "default": { + "value": { + "message": "Credential type revocation for user 'octocat' has been queued" + } + }, + "with_authorization_revoked_warning": { + "summary": "Warning when the calling token may have its authorization revoked", + "value": { + "message": "Credential type revocation for user 'octocat' has been queued", + "warning": "The token used for this request may also have its authorization revoked as part of this operation" + } + }, + "with_credential_destroyed_warning": { + "summary": "Warning when the calling token may be destroyed (EMU with `revoke_credentials`)", + "value": { + "message": "Credential type revocation for user 'octocat' has been queued", + "warning": "The token used for this request may also be destroyed as part of this operation" + } + } + } + } + } + }, + "403": { + "description": "Forbidden", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + }, + "422": { + "description": "Validation error - The `credential_type` is missing or invalid, the target user cannot be revoked, or `revoke_credentials` is not available for this enterprise", + "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": { + "invalid_credential_type": { + "summary": "Missing or invalid `credential_type`", + "value": { + "message": "The `credential_type` parameter is required and must be one of: classic_pat, fine_grained_pat, ssh_key, oauth_app_token", + "documentation_url": "https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-a-user-in-an-enterprise" + } + }, + "non_emu_enterprise": { + "summary": "`revoke_credentials` requested on a non-EMU enterprise", + "value": { + "message": "The `revoke_credentials` option is only available for Enterprise Managed User (EMU) enterprises", + "documentation_url": "https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-a-user-in-an-enterprise" + } + }, + "first_emu_owner": { + "summary": "Target user is the first EMU owner", + "value": { + "message": "The first EMU owner cannot be targeted for credential revocation.", + "documentation_url": "https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-a-user-in-an-enterprise" + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "credential-authorizations" + } + } + }, "/enterprises/{enterprise}/dependabot/alerts": { "get": { "summary": "List Dependabot alerts for an enterprise", @@ -73030,17 +73464,14 @@ "type": "string", "description": "A machine-readable code describing the error.", "enum": [ - "none", - "config_load", - "compile_db", + "invalid", + "unprocessable", "start_delimiter", "end_delimiter", - "display_name", + "name", "must_match", "must_not_match", - "custom_pattern_version_mismatch", - "db_size", - "db_size_calculation" + "custom_pattern_version_mismatch" ] }, "message": { @@ -282335,17 +282766,14 @@ "type": "string", "description": "A machine-readable code describing the error.", "enum": [ - "none", - "config_load", - "compile_db", + "invalid", + "unprocessable", "start_delimiter", "end_delimiter", - "display_name", + "name", "must_match", "must_not_match", - "custom_pattern_version_mismatch", - "db_size", - "db_size_calculation" + "custom_pattern_version_mismatch" ] }, "message": { @@ -370245,6 +370673,15 @@ "enum": [ "weekly" ] + }, + "ai_findings_option": { + "description": "The AI findings configuration for the repository.", + "nullable": true, + "type": "string", + "enum": [ + "disabled", + "on_push" + ] } } }, @@ -370259,7 +370696,8 @@ "runner_type": "standard", "runner_label": null, "updated_at": "2023-01-01T00:00:00Z", - "schedule": "weekly" + "schedule": "weekly", + "ai_findings_option": "on_push" } } } @@ -370422,6 +370860,14 @@ "ruby" ] } + }, + "ai_findings_option": { + "description": "Whether AI findings run for Code Quality on this repository.", + "type": "string", + "enum": [ + "disabled", + "on_push" + ] } }, "anyOf": [ @@ -370444,6 +370890,11 @@ "required": [ "languages" ] + }, + { + "required": [ + "ai_findings_option" + ] } ], "additionalProperties": false @@ -621932,7 +622383,7 @@ }, "post": { "summary": "Create a release", - "description": "Users with push access to the repository can create a release.\n\nThis endpoint triggers [notifications](https://docs.github.com/enterprise-cloud@latest/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see \"[Rate limits for the API](https://docs.github.com/enterprise-cloud@latest/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)\" and \"[Best practices for using the REST API](https://docs.github.com/enterprise-cloud@latest/rest/guides/best-practices-for-using-the-rest-api).\"", + "description": "Users with push access to the repository can create a release.\n\n> [!NOTE]\n> If the commit identified by `target_commitish` (or, when `target_commitish` is omitted, the latest commit on the default branch) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead.\n\nOAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the \"Workflows\" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see \"[Automatic token authentication](https://docs.github.com/enterprise-cloud@latest/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)\".\n\nThis endpoint triggers [notifications](https://docs.github.com/enterprise-cloud@latest/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see \"[Rate limits for the API](https://docs.github.com/enterprise-cloud@latest/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)\" and \"[Best practices for using the REST API](https://docs.github.com/enterprise-cloud@latest/rest/guides/best-practices-for-using-the-rest-api).\"", "tags": [ "repos" ], @@ -625552,7 +626003,7 @@ }, "patch": { "summary": "Update a release", - "description": "Users with push access to the repository can edit a release.", + "description": "Users with push access to the repository can edit a release.\n\n> [!NOTE]\n> If the resolved target commit (the new value of `target_commitish` if you are changing it, otherwise the existing target) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead.\n\nOAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the \"Workflows\" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see \"[Automatic token authentication](https://docs.github.com/enterprise-cloud@latest/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)\".", "tags": [ "repos" ], @@ -644694,17 +645145,14 @@ "type": "string", "description": "A machine-readable code describing the error.", "enum": [ - "none", - "config_load", - "compile_db", + "invalid", + "unprocessable", "start_delimiter", "end_delimiter", - "display_name", + "name", "must_match", "must_not_match", - "custom_pattern_version_mismatch", - "db_size", - "db_size_calculation" + "custom_pattern_version_mismatch" ] }, "message": { diff --git a/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.yaml b/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.yaml index 2adaa287bd..f56c0c0076 100644 --- a/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.yaml +++ b/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.yaml @@ -694,7 +694,7 @@ paths: required: - vector_string - score - cvss_severities: &137 + cvss_severities: &138 type: object nullable: true properties: @@ -734,7 +734,7 @@ paths: required: - vector_string - score - epss: &138 + epss: &139 type: object nullable: true readOnly: true @@ -3845,7 +3845,7 @@ paths: title: Enterprise description: An enterprise on GitHub. type: object - properties: &148 + properties: &149 description: description: A short description of the enterprise. type: string @@ -3887,7 +3887,7 @@ paths: avatar_url: type: string format: uri - required: &149 + required: &150 - id - node_id - name @@ -16028,28 +16028,28 @@ paths: items: &336 type: object properties: - number: &135 + number: &136 type: integer description: The security alert number. readOnly: true - created_at: &142 + created_at: &143 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: &143 + updated_at: &144 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: &140 + url: &141 type: string description: The REST API URL of the alert resource. format: uri readOnly: true - html_url: &141 + html_url: &142 type: string description: The GitHub URL of the alert resource. format: uri @@ -16068,7 +16068,7 @@ paths: - open - dismissed - fixed - fixed_at: &145 + fixed_at: &146 type: string description: 'The time that the alert was no longer detected and was considered fixed in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.' @@ -16082,7 +16082,7 @@ paths: properties: *20 required: *21 nullable: true - dismissed_at: &144 + dismissed_at: &145 type: string description: 'The time that the alert was dismissed in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.' @@ -16241,7 +16241,7 @@ paths: title: Simple Repository description: A GitHub repository. type: object - properties: &146 + properties: &147 id: type: integer format: int64 @@ -16468,7 +16468,7 @@ paths: format: uri example: https://api.github.com/repos/octocat/Hello-World/hooks description: The API URL to list the hooks on the repository. - required: &147 + required: &148 - archive_url - assignees_url - blobs_url @@ -20391,6 +20391,123 @@ paths: enabledForGitHubApps: true category: enterprise-admin subcategory: credential-authorizations + "/enterprises/{enterprise}/credential-authorizations/revoke-credential-type": + post: + summary: Revoke a single credential type for an enterprise + description: |- + Revokes a single credential type (for example, classic personal access tokens) + across all organizations within the enterprise. This removes the sign-in + authorizations for that credential type for every member of the enterprise. + + For Enterprise Managed User (EMU) enterprises, you can optionally also destroy the + actual credentials of that type owned by enterprise members by setting the + `revoke_credentials` parameter to `true`. + + This operation is performed asynchronously. A background job will be queued to process + the revocations. + + > [!WARNING] + > If you use a personal access token to call this endpoint, that token may also be + > revoked or destroyed as part of this operation. + + The authenticated user must be an enterprise owner or have the `write_enterprise_credentials` permission to use this endpoint. + + OAuth app tokens and personal access tokens (classic) need the `admin:enterprise` scope to use this endpoint. + tags: + - enterprise-admin + operationId: enterprise-admin/revoke-credential-type-for-enterprise + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-an-enterprise + parameters: + - *42 + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - credential_type + properties: + credential_type: + type: string + description: The type of credential to revoke across the enterprise. + enum: + - classic_pat + - fine_grained_pat + - ssh_key + - oauth_app_token + revoke_credentials: + type: boolean + description: |- + Whether to also destroy the actual credentials of this type owned by + enterprise members. This option is only available for Enterprise Managed + User (EMU) enterprises. When set to `true`, all credentials of the given + type owned by enterprise members will be destroyed in addition to the + credential authorizations. Note that `oauth_app_token` credentials cannot + be destroyed; for that type only the credential authorizations are revoked. + default: false + examples: + default: + value: + credential_type: classic_pat + revoke_credentials: false + emu_with_credential_revocation: + summary: EMU enterprise with credential revocation + value: + credential_type: classic_pat + revoke_credentials: true + responses: + '202': + description: Accepted - The revocation request has been queued + content: + application/json: + schema: + type: object + properties: + message: + type: string + description: A message indicating the revocation has been queued + warning: + type: string + description: A warning message if the token used for this request + may be revoked + examples: + default: + value: + message: Credential type revocation has been queued + with_warning: + value: + message: Credential type revocation has been queued + warning: The token used for this request may also have its authorization + revoked as part of this operation + '403': *29 + '404': *6 + '422': + description: Validation error - The `credential_type` is missing or invalid, + or `revoke_credentials` is not available for this enterprise + content: + application/json: + schema: *3 + examples: + invalid_credential_type: + summary: Missing or invalid `credential_type` + value: + message: 'The `credential_type` parameter is required and must + be one of: classic_pat, fine_grained_pat, ssh_key, oauth_app_token' + documentation_url: https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-an-enterprise + non_emu_enterprise: + summary: "`revoke_credentials` requested on a non-EMU enterprise" + value: + message: The `revoke_credentials` option is only available for + Enterprise Managed User (EMU) enterprises + documentation_url: https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-an-enterprise + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: credential-authorizations "/enterprises/{enterprise}/credential-authorizations/{username}/revoke": post: summary: Revoke credential authorizations for a user in an enterprise @@ -20421,7 +20538,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/credential-authorizations#revoke-credential-authorizations-for-a-user-in-an-enterprise parameters: - *42 - - &152 + - &135 name: username description: The handle for the GitHub user account. in: path @@ -20513,6 +20630,143 @@ paths: enabledForGitHubApps: true category: enterprise-admin subcategory: credential-authorizations + "/enterprises/{enterprise}/credential-authorizations/{username}/revoke-credential-type": + post: + summary: Revoke a single credential type for a user in an enterprise + description: |- + Revokes a single credential type (for example, classic personal access tokens) + for a single user within the enterprise. This removes the sign-in authorizations + for that credential type across all organizations in the enterprise for the user. + + For Enterprise Managed User (EMU) enterprises, you can optionally also destroy the + actual credential of that type owned by the user by setting the `revoke_credentials` + parameter to `true`. + + This operation is performed asynchronously. A background job will be queued to process + the revocations. + + > [!WARNING] + > If you use a personal access token to call this endpoint and target yourself, that + > token may also be revoked or destroyed as part of this operation. + + The authenticated user must be an enterprise owner or have the `write_enterprise_credentials` permission to use this endpoint. + + OAuth app tokens and personal access tokens (classic) need the `admin:enterprise` scope to use this endpoint. + tags: + - enterprise-admin + operationId: enterprise-admin/revoke-credential-type-for-user + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-a-user-in-an-enterprise + parameters: + - *42 + - *135 + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - credential_type + properties: + credential_type: + type: string + description: The type of credential to revoke for the user. + enum: + - classic_pat + - fine_grained_pat + - ssh_key + - oauth_app_token + revoke_credentials: + type: boolean + description: |- + Whether to also destroy the actual credential of this type owned by the + user. This option is only available for Enterprise Managed User (EMU) + enterprises. When set to `true`, the credential of the given type owned + by the user will be destroyed in addition to the credential authorizations. + Note that `oauth_app_token` credentials cannot be destroyed; for that type + only the credential authorizations are revoked. + default: false + examples: + default: + value: + credential_type: classic_pat + revoke_credentials: false + emu_with_credential_revocation: + summary: EMU enterprise with credential revocation + value: + credential_type: classic_pat + revoke_credentials: true + responses: + '202': + description: Accepted - The revocation request has been queued + content: + application/json: + schema: + type: object + properties: + message: + type: string + description: A message indicating the revocation has been queued + warning: + type: string + description: A warning message if the token used for this request + may be revoked + examples: + default: + value: + message: Credential type revocation for user 'octocat' has been + queued + with_authorization_revoked_warning: + summary: Warning when the calling token may have its authorization + revoked + value: + message: Credential type revocation for user 'octocat' has been + queued + warning: The token used for this request may also have its authorization + revoked as part of this operation + with_credential_destroyed_warning: + summary: Warning when the calling token may be destroyed (EMU with + `revoke_credentials`) + value: + message: Credential type revocation for user 'octocat' has been + queued + warning: The token used for this request may also be destroyed + as part of this operation + '403': *29 + '404': *6 + '422': + description: Validation error - The `credential_type` is missing or invalid, + the target user cannot be revoked, or `revoke_credentials` is not available + for this enterprise + content: + application/json: + schema: *3 + examples: + invalid_credential_type: + summary: Missing or invalid `credential_type` + value: + message: 'The `credential_type` parameter is required and must + be one of: classic_pat, fine_grained_pat, ssh_key, oauth_app_token' + documentation_url: https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-a-user-in-an-enterprise + non_emu_enterprise: + summary: "`revoke_credentials` requested on a non-EMU enterprise" + value: + message: The `revoke_credentials` option is only available for + Enterprise Managed User (EMU) enterprises + documentation_url: https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-a-user-in-an-enterprise + first_emu_owner: + summary: Target user is the first EMU owner + value: + message: The first EMU owner cannot be targeted for credential + revocation. + documentation_url: https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-a-user-in-an-enterprise + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: credential-authorizations "/enterprises/{enterprise}/dependabot/alerts": get: summary: List Dependabot alerts for an enterprise @@ -20650,7 +20904,7 @@ paths: type: object description: A Dependabot alert. properties: - number: *135 + number: *136 state: type: string description: The state of the Dependabot alert. @@ -20665,7 +20919,7 @@ paths: description: Details for the vulnerable dependency. readOnly: true properties: - package: &136 + package: &137 type: object description: Details for the vulnerable package. readOnly: true @@ -20740,13 +20994,13 @@ paths: description: Vulnerable version range information for the advisory. readOnly: true - items: &139 + items: &140 type: object description: Details pertaining to one vulnerable version range for the advisory. readOnly: true properties: - package: *136 + package: *137 severity: type: string description: The severity of the vulnerability. @@ -20819,8 +21073,8 @@ paths: - score - vector_string additionalProperties: false - cvss_severities: *137 - epss: *138 + cvss_severities: *138 + epss: *139 cwes: type: array description: Details for the advisory pertaining to Common @@ -20919,12 +21173,12 @@ paths: - updated_at - withdrawn_at additionalProperties: false - security_vulnerability: *139 - url: *140 - html_url: *141 - created_at: *142 - updated_at: *143 - dismissed_at: *144 + security_vulnerability: *140 + url: *141 + html_url: *142 + created_at: *143 + updated_at: *144 + dismissed_at: *145 dismissed_by: title: Simple User description: A GitHub user. @@ -20948,7 +21202,7 @@ paths: dismissal. nullable: true maxLength: 280 - fixed_at: *145 + fixed_at: *146 auto_dismissed_at: &649 type: string description: 'The time that the alert was auto-dismissed in @@ -21424,8 +21678,8 @@ paths: title: Simple Repository description: A GitHub repository. type: object - properties: *146 - required: *147 + properties: *147 + required: *148 nullable: true additionalProperties: false examples: @@ -21933,8 +22187,8 @@ paths: title: Enterprise description: An enterprise on GitHub. type: object - properties: *148 - required: *149 + properties: *149 + required: *150 nullable: true created_at: description: The date and time the role was created. @@ -22027,7 +22281,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/enterprise-roles#remove-all-enterprise-roles-from-a-team parameters: - *42 - - &150 + - &151 name: team_slug description: The slug of the enterprise team name. in: path @@ -22070,8 +22324,8 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/enterprise-roles#assign-an-enterprise-role-to-a-team parameters: - *42 - - *150 - - &151 + - *151 + - &152 name: role_id description: The unique identifier of the role. in: path @@ -22113,8 +22367,8 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/enterprise-roles#remove-an-enterprise-role-from-a-team parameters: - *42 - - *150 - *151 + - *152 responses: '204': description: Response @@ -22148,7 +22402,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/enterprise-roles#remove-all-enterprise-roles-from-a-user parameters: - *42 - - *152 + - *135 responses: '204': description: Response @@ -22182,8 +22436,8 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/enterprise-roles#assign-an-enterprise-role-to-an-enterprise-user parameters: - *42 + - *135 - *152 - - *151 responses: '204': description: Response @@ -22216,8 +22470,8 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/enterprise-roles#remove-enterprise-user-role-assignment parameters: - *42 + - *135 - *152 - - *151 responses: '204': description: Response @@ -22251,7 +22505,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/enterprise-roles#get-an-enterprise-role parameters: - *42 - - *151 + - *152 responses: '200': description: Response @@ -22311,7 +22565,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/enterprise-roles#list-teams-that-are-assigned-to-an-enterprise-role parameters: - *42 - - *151 + - *152 - *17 - *19 responses: @@ -22362,7 +22616,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/enterprise-roles#list-users-that-are-assigned-to-an-enterprise-role parameters: - *42 - - *151 + - *152 - *17 - *19 responses: @@ -23018,7 +23272,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: - *42 - - *152 + - *135 responses: '200': description: The user's GitHub Copilot seat details, including usage. @@ -26160,8 +26414,8 @@ paths: items: &476 type: object properties: - number: *135 - created_at: *142 + number: *136 + created_at: *143 updated_at: type: string description: 'The time that the alert was last updated in ISO @@ -26169,8 +26423,8 @@ paths: format: date-time readOnly: true nullable: true - url: *140 - html_url: *141 + url: *141 + html_url: *142 locations_url: type: string format: uri @@ -27153,17 +27407,14 @@ paths: description: A machine-readable code describing the error. enum: - - none - - config_load - - compile_db + - invalid + - unprocessable - start_delimiter - end_delimiter - - display_name + - name - must_match - must_not_match - custom_pattern_version_mismatch - - db_size - - db_size_calculation message: type: string description: A human-readable description of the error. @@ -30658,7 +30909,7 @@ paths: parameters: - *42 - *222 - - *152 + - *135 responses: '200': description: User is a member of the enterprise team. @@ -30703,7 +30954,7 @@ paths: parameters: - *42 - *222 - - *152 + - *135 responses: '201': description: Successfully added team member @@ -30730,7 +30981,7 @@ paths: parameters: - *42 - *222 - - *152 + - *135 responses: '204': description: Response @@ -46022,7 +46273,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/blocking#check-if-a-user-is-blocked-by-an-organization parameters: - *90 - - *152 + - *135 responses: '204': description: If the user is blocked @@ -46048,7 +46299,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/blocking#block-a-user-from-an-organization parameters: - *90 - - *152 + - *135 responses: '204': description: Response @@ -46069,7 +46320,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/blocking#unblock-a-user-from-an-organization parameters: - *90 - - *152 + - *135 responses: '204': description: Response @@ -52317,7 +52568,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/custom-roles#get-a-custom-repository-role parameters: - *90 - - *151 + - *152 responses: '200': description: Response @@ -52348,7 +52599,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/custom-roles#update-a-custom-repository-role parameters: - *90 - - *151 + - *152 requestBody: required: true content: @@ -52418,7 +52669,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/custom-roles#delete-a-custom-repository-role parameters: - *90 - - *151 + - *152 responses: '204': description: Response @@ -52498,7 +52749,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/custom-roles#closing-down---get-a-custom-role parameters: - *90 - - *151 + - *152 responses: '200': description: Response @@ -52535,7 +52786,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/custom-roles#closing-down---update-a-custom-role parameters: - *90 - - *151 + - *152 requestBody: required: true content: @@ -52588,7 +52839,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/custom-roles#closing-down---delete-a-custom-role parameters: - *90 - - *151 + - *152 responses: '204': description: Response @@ -56973,7 +57224,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/members#check-organization-membership-for-a-user parameters: - *90 - - *152 + - *135 responses: '204': description: Response if requester is an organization member and user is @@ -57008,7 +57259,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/members#remove-an-organization-member parameters: - *90 - - *152 + - *135 responses: '204': description: Response @@ -57035,7 +57286,7 @@ paths: - *17 - *19 - *90 - - *152 + - *135 responses: '200': description: Response @@ -57079,7 +57330,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/codespaces/organizations#delete-a-codespace-from-the-organization parameters: - *90 - - *152 + - *135 - &411 name: codespace_name in: path @@ -57114,7 +57365,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/codespaces/organizations#stop-a-codespace-for-an-organization-user parameters: - *90 - - *152 + - *135 - *411 responses: '200': @@ -57297,7 +57548,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/copilot/copilot-user-management#get-copilot-seat-assignment-details-for-a-user parameters: - *90 - - *152 + - *135 responses: '200': description: The user's GitHub Copilot seat details, including usage. @@ -57373,7 +57624,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/members#get-organization-membership-for-a-user parameters: - *90 - - *152 + - *135 responses: '200': description: Response @@ -57519,7 +57770,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/members#set-organization-membership-for-a-user parameters: - *90 - - *152 + - *135 requestBody: required: false content: @@ -57574,7 +57825,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/members#remove-organization-membership-for-a-user parameters: - *90 - - *152 + - *135 responses: '204': description: Response @@ -58909,7 +59160,7 @@ paths: parameters: - *90 - *227 - - *151 + - *152 responses: '204': description: Response @@ -58940,7 +59191,7 @@ paths: parameters: - *90 - *227 - - *151 + - *152 responses: '204': description: Response @@ -58966,7 +59217,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/organization-roles#remove-all-organization-roles-for-a-user parameters: - *90 - - *152 + - *135 responses: '204': description: Response @@ -58992,8 +59243,8 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/organization-roles#assign-an-organization-role-to-a-user parameters: - *90 + - *135 - *152 - - *151 responses: '204': description: Response @@ -59024,8 +59275,8 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/organization-roles#remove-an-organization-role-from-a-user parameters: - *90 + - *135 - *152 - - *151 responses: '204': description: Response @@ -59054,7 +59305,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/organization-roles#get-an-organization-role parameters: - *90 - - *151 + - *152 responses: '200': description: Response @@ -59118,7 +59369,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/organization-roles#update-a-custom-organization-role parameters: - *90 - - *151 + - *152 requestBody: required: true content: @@ -59211,7 +59462,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/organization-roles#delete-a-custom-organization-role parameters: - *90 - - *151 + - *152 responses: '204': description: Response @@ -59237,7 +59488,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/organization-roles#list-teams-that-are-assigned-to-an-organization-role parameters: - *90 - - *151 + - *152 - *17 - *19 responses: @@ -59378,7 +59629,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/organization-roles#list-users-that-are-assigned-to-an-organization-role parameters: - *90 - - *151 + - *152 - *17 - *19 responses: @@ -59584,7 +59835,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/outside-collaborators#convert-an-organization-member-to-outside-collaborator parameters: - *90 - - *152 + - *135 requestBody: required: false content: @@ -59642,7 +59893,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/outside-collaborators#remove-outside-collaborator-from-an-organization parameters: - *90 - - *152 + - *135 responses: '204': description: Response @@ -64999,7 +65250,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/members#check-public-organization-membership-for-a-user parameters: - *90 - - *152 + - *135 responses: '204': description: Response if user is a public member @@ -65024,7 +65275,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/members#set-public-organization-membership-for-the-authenticated-user parameters: - *90 - - *152 + - *135 responses: '204': description: Response @@ -65046,7 +65297,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/members#remove-public-organization-membership-for-the-authenticated-user parameters: - *90 - - *152 + - *135 responses: '204': description: Response @@ -67829,7 +68080,7 @@ paths: required: - vector_string - score - cvss_severities: *137 + cvss_severities: *138 cwes: type: array nullable: true @@ -70066,7 +70317,7 @@ paths: parameters: - *90 - *227 - - *152 + - *135 responses: '200': description: Response @@ -70137,7 +70388,7 @@ paths: parameters: - *90 - *227 - - *152 + - *135 requestBody: required: false content: @@ -70201,7 +70452,7 @@ paths: parameters: - *90 - *227 - - *152 + - *135 responses: '204': description: Response @@ -85315,6 +85566,13 @@ paths: type: string enum: - weekly + ai_findings_option: + description: The AI findings configuration for the repository. + nullable: true + type: string + enum: + - disabled + - on_push examples: default: value: @@ -85326,6 +85584,7 @@ paths: runner_label: updated_at: '2023-01-01T00:00:00Z' schedule: weekly + ai_findings_option: on_push '403': *582 '404': *6 '503': *204 @@ -85386,6 +85645,12 @@ paths: - javascript-typescript - python - ruby + ai_findings_option: + description: Whether AI findings run for Code Quality on this repository. + type: string + enum: + - disabled + - on_push anyOf: - required: - state @@ -85395,6 +85660,8 @@ paths: - runner_label - required: - languages + - required: + - ai_findings_option additionalProperties: false examples: default: @@ -85540,14 +85807,14 @@ paths: items: type: object properties: - number: *135 - created_at: *142 - updated_at: *143 - url: *140 - html_url: *141 + number: *136 + created_at: *143 + updated_at: *144 + url: *141 + html_url: *142 instances_url: *585 state: *116 - fixed_at: *145 + fixed_at: *146 dismissed_by: title: Simple User description: A GitHub user. @@ -85555,7 +85822,7 @@ paths: properties: *20 required: *21 nullable: true - dismissed_at: *144 + dismissed_at: *145 dismissed_reason: *586 dismissed_comment: *587 rule: *588 @@ -85723,7 +85990,7 @@ paths: field in the response from the `GET /repos/{owner}/{repo}/code-scanning/alerts` operation. required: true - schema: *135 + schema: *136 responses: '200': description: Response @@ -85732,14 +85999,14 @@ paths: schema: &593 type: object properties: - number: *135 - created_at: *142 - updated_at: *143 - url: *140 - html_url: *141 + number: *136 + created_at: *143 + updated_at: *144 + url: *141 + html_url: *142 instances_url: *585 state: *116 - fixed_at: *145 + fixed_at: *146 dismissed_by: title: Simple User description: A GitHub user. @@ -85747,7 +86014,7 @@ paths: properties: *20 required: *21 nullable: true - dismissed_at: *144 + dismissed_at: *145 dismissed_reason: *586 dismissed_comment: *587 rule: @@ -89481,7 +89748,7 @@ paths: parameters: - *510 - *511 - - *152 + - *135 responses: '204': description: Response if user is a collaborator @@ -89529,7 +89796,7 @@ paths: parameters: - *510 - *511 - - *152 + - *135 requestBody: required: false content: @@ -89786,7 +90053,7 @@ paths: parameters: - *510 - *511 - - *152 + - *135 responses: '204': description: No Content when collaborator was removed from the repository. @@ -89819,7 +90086,7 @@ paths: parameters: - *510 - *511 - - *152 + - *135 responses: '200': description: if user has admin permissions @@ -94065,7 +94332,7 @@ paths: type: object description: A Dependabot alert. properties: - number: *135 + number: *136 state: type: string description: The state of the Dependabot alert. @@ -94080,7 +94347,7 @@ paths: description: Details for the vulnerable dependency. readOnly: true properties: - package: *136 + package: *137 manifest_path: type: string description: The full path to the dependency manifest file, @@ -94109,12 +94376,12 @@ paths: - transitive - inconclusive security_advisory: *648 - security_vulnerability: *139 - url: *140 - html_url: *141 - created_at: *142 - updated_at: *143 - dismissed_at: *144 + security_vulnerability: *140 + url: *141 + html_url: *142 + created_at: *143 + updated_at: *144 + dismissed_at: *145 dismissed_by: title: Simple User description: A GitHub user. @@ -94138,7 +94405,7 @@ paths: dismissal. nullable: true maxLength: 280 - fixed_at: *145 + fixed_at: *146 auto_dismissed_at: *649 dismissal_request: *650 assignees: @@ -94406,7 +94673,7 @@ paths: or in `number` fields in the response from the `GET /repos/{owner}/{repo}/dependabot/alerts` operation. required: true - schema: *135 + schema: *136 responses: '200': description: Response @@ -115566,6 +115833,11 @@ paths: description: |- Users with push access to the repository can create a release. + > [!NOTE] + > If the commit identified by `target_commitish` (or, when `target_commitish` is omitted, the latest commit on the default branch) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead. + + OAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the "Workflows" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see "[Automatic token authentication](https://docs.github.com/enterprise-cloud@latest/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)". + This endpoint triggers [notifications](https://docs.github.com/enterprise-cloud@latest/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/enterprise-cloud@latest/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)" and "[Best practices for using the REST API](https://docs.github.com/enterprise-cloud@latest/rest/guides/best-practices-for-using-the-rest-api)." tags: - repos @@ -116079,7 +116351,13 @@ paths: subcategory: releases patch: summary: Update a release - description: Users with push access to the repository can edit a release. + description: |- + Users with push access to the repository can edit a release. + + > [!NOTE] + > If the resolved target commit (the new value of `target_commitish` if you are changing it, otherwise the existing target) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead. + + OAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the "Workflows" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see "[Automatic token authentication](https://docs.github.com/enterprise-cloud@latest/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)". tags: - repos operationId: repos/update-release @@ -117203,8 +117481,8 @@ paths: items: type: object properties: - number: *135 - created_at: *142 + number: *136 + created_at: *143 updated_at: type: string description: 'The time that the alert was last updated in ISO @@ -117212,8 +117490,8 @@ paths: format: date-time readOnly: true nullable: true - url: *140 - html_url: *141 + url: *141 + html_url: *142 locations_url: type: string format: uri @@ -117502,8 +117780,8 @@ paths: schema: &810 type: object properties: - number: *135 - created_at: *142 + number: *136 + created_at: *143 updated_at: type: string description: 'The time that the alert was last updated in ISO @@ -117511,8 +117789,8 @@ paths: format: date-time readOnly: true nullable: true - url: *140 - html_url: *141 + url: *141 + html_url: *142 locations_url: type: string format: uri @@ -125843,7 +126121,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/teams/members#get-team-member-legacy parameters: - *868 - - *152 + - *135 responses: '204': description: if user is a member @@ -125880,7 +126158,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/teams/members#add-team-member-legacy parameters: - *868 - - *152 + - *135 responses: '204': description: Response @@ -125920,7 +126198,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/teams/members#remove-team-member-legacy parameters: - *868 - - *152 + - *135 responses: '204': description: Response @@ -125957,7 +126235,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/teams/members#get-team-membership-for-a-user-legacy parameters: - *868 - - *152 + - *135 responses: '200': description: Response @@ -125999,7 +126277,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/teams/members#add-or-update-team-membership-for-a-user-legacy parameters: - *868 - - *152 + - *135 requestBody: required: false content: @@ -126061,7 +126339,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/teams/members#remove-team-membership-for-a-user-legacy parameters: - *868 - - *152 + - *135 responses: '204': description: Response @@ -126998,7 +127276,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: - - *152 + - *135 responses: '204': description: If the user is blocked @@ -127026,7 +127304,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/users/blocking#block-a-user parameters: - - *152 + - *135 responses: '204': description: Response @@ -127050,7 +127328,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/users/blocking#unblock-a-user parameters: - - *152 + - *135 responses: '204': description: Response @@ -129297,7 +129575,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: - - *152 + - *135 responses: '204': description: if the person is followed by the authenticated user @@ -129327,7 +129605,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/users/followers#follow-a-user parameters: - - *152 + - *135 responses: '204': description: Response @@ -129352,7 +129630,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/users/followers#unfollow-a-user parameters: - - *152 + - *135 responses: '204': description: Response @@ -133633,7 +133911,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/users/users#get-a-user parameters: - - *152 + - *135 responses: '200': description: Response @@ -133671,7 +133949,7 @@ paths: - *17 - *111 - *112 - - *152 + - *135 requestBody: required: true content: @@ -133767,7 +134045,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/users/attestations#delete-attestations-in-bulk parameters: - - *152 + - *135 requestBody: required: true content: @@ -133832,7 +134110,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/users/attestations#delete-attestations-by-subject-digest parameters: - - *152 + - *135 - name: subject_digest description: Subject Digest in: path @@ -133863,7 +134141,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/users/attestations#delete-attestations-by-id parameters: - - *152 + - *135 - name: attestation_id description: Attestation ID in: path @@ -133901,7 +134179,7 @@ paths: - *17 - *111 - *112 - - *152 + - *135 - name: subject_digest description: Subject Digest in: path @@ -133987,7 +134265,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/copilot-spaces#list-copilot-spaces-for-a-user parameters: - - *152 + - *135 - name: per_page description: The number of results per page (max 100). in: query @@ -134142,7 +134420,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/copilot-spaces#create-a-copilot-space-for-a-user parameters: - - *152 + - *135 requestBody: required: true content: @@ -134322,7 +134600,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/copilot-spaces#get-a-copilot-space-for-a-user parameters: - - *152 + - *135 - name: space_number description: The unique identifier of the Copilot Space. in: path @@ -134358,7 +134636,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/copilot-spaces#set-a-copilot-space-for-a-user parameters: - - *152 + - *135 - name: space_number description: The unique identifier of the Copilot Space. in: path @@ -134482,7 +134760,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/copilot-spaces#delete-a-copilot-space-for-a-user parameters: - - *152 + - *135 - name: space_number description: The unique identifier of the Copilot Space. in: path @@ -134516,7 +134794,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/collaborators#list-collaborators-for-a-copilot-space-for-a-user parameters: - - *152 + - *135 - name: space_number description: The unique identifier of the Copilot Space. in: path @@ -134632,7 +134910,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/collaborators#add-a-collaborator-to-a-copilot-space-for-a-user parameters: - - *152 + - *135 - name: space_number description: The unique identifier of the Copilot Space. in: path @@ -134739,7 +135017,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/collaborators#set-a-collaborator-role-for-a-copilot-space-for-a-user parameters: - - *152 + - *135 - name: space_number description: The unique identifier of the Copilot Space. in: path @@ -134852,7 +135130,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/collaborators#remove-a-collaborator-from-a-copilot-space-for-a-user parameters: - - *152 + - *135 - name: space_number description: The unique identifier of the Copilot Space. in: path @@ -134900,7 +135178,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/resources#list-resources-for-a-copilot-space-for-a-user parameters: - - *152 + - *135 - name: space_number description: The unique identifier of the Copilot Space. in: path @@ -134958,7 +135236,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/resources#create-a-resource-for-a-copilot-space-for-a-user parameters: - - *152 + - *135 - name: space_number description: The unique identifier of the Copilot Space. in: path @@ -135063,7 +135341,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/resources#get-a-resource-for-a-copilot-space-for-a-user parameters: - - *152 + - *135 - name: space_number description: The unique identifier of the Copilot Space. in: path @@ -135113,7 +135391,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/resources#set-a-resource-for-a-copilot-space-for-a-user parameters: - - *152 + - *135 - name: space_number description: The unique identifier of the Copilot Space. in: path @@ -135181,7 +135459,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/resources#delete-a-resource-from-a-copilot-space-for-a-user parameters: - - *152 + - *135 - name: space_number description: The unique identifier of the Copilot Space. in: path @@ -135217,7 +135495,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: - - *152 + - *135 responses: '200': description: Response @@ -135250,7 +135528,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/activity/events#list-events-for-the-authenticated-user parameters: - - *152 + - *135 - *17 - *19 responses: @@ -135322,7 +135600,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/activity/events#list-organization-events-for-the-authenticated-user parameters: - - *152 + - *135 - *90 - *17 - *19 @@ -135410,7 +135688,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/activity/events#list-public-events-for-a-user parameters: - - *152 + - *135 - *17 - *19 responses: @@ -135478,7 +135756,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/users/followers#list-followers-of-a-user parameters: - - *152 + - *135 - *17 - *19 responses: @@ -135509,7 +135787,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/users/followers#list-the-people-a-user-follows parameters: - - *152 + - *135 - *17 - *19 responses: @@ -135540,7 +135818,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: - - *152 + - *135 - name: target_user in: path required: true @@ -135567,7 +135845,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/gists/gists#list-gists-for-a-user parameters: - - *152 + - *135 - *242 - *17 - *19 @@ -135601,7 +135879,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: - - *152 + - *135 - *17 - *19 responses: @@ -135637,7 +135915,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/users/users#get-contextual-information-for-a-user parameters: - - *152 + - *135 - name: subject_type description: Identifies which additional information you'd like to receive about the person's hovercard. Can be `organization`, `repository`, `issue`, @@ -135709,7 +135987,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: - - *152 + - *135 responses: '200': description: Response @@ -135735,7 +136013,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/users/keys#list-public-keys-for-a-user parameters: - - *152 + - *135 - *17 - *19 responses: @@ -135790,7 +136068,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/orgs#list-organizations-for-a-user parameters: - - *152 + - *135 - *17 - *19 responses: @@ -135842,7 +136120,7 @@ paths: - nuget - container - *892 - - *152 + - *135 - *19 - *17 responses: @@ -135879,7 +136157,7 @@ paths: parameters: - *422 - *423 - - *152 + - *135 responses: '200': description: Response @@ -135910,7 +136188,7 @@ paths: parameters: - *422 - *423 - - *152 + - *135 responses: '204': description: Response @@ -135944,7 +136222,7 @@ paths: parameters: - *422 - *423 - - *152 + - *135 - name: token description: package token schema: @@ -135978,7 +136256,7 @@ paths: parameters: - *422 - *423 - - *152 + - *135 responses: '200': description: Response @@ -136047,7 +136325,7 @@ paths: - *422 - *423 - *425 - - *152 + - *135 responses: '200': description: Response @@ -136090,7 +136368,7 @@ paths: parameters: - *422 - *423 - - *152 + - *135 - *425 responses: '204': @@ -136125,7 +136403,7 @@ paths: parameters: - *422 - *423 - - *152 + - *135 - *425 responses: '204': @@ -136150,7 +136428,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/projects/projects#list-projects-for-user parameters: - - *152 + - *135 - name: q description: Limit results to projects of the specified type. in: query @@ -136192,7 +136470,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/projects/projects#get-project-for-user parameters: - *438 - - *152 + - *135 responses: '200': description: Response @@ -136223,7 +136501,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/projects/fields#list-project-fields-for-user parameters: - *438 - - *152 + - *135 - *17 - *111 - *112 @@ -136257,7 +136535,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/projects/fields#add-field-to-user-owned-project parameters: - - *152 + - *135 - *438 requestBody: required: true @@ -136370,7 +136648,7 @@ paths: parameters: - *438 - *924 - - *152 + - *135 responses: '200': description: Response @@ -136402,7 +136680,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/projects/items#list-items-for-a-user-owned-project parameters: - *438 - - *152 + - *135 - *111 - *112 - *17 @@ -136457,7 +136735,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/projects/items#add-item-to-user-owned-project parameters: - - *152 + - *135 - *438 requestBody: required: true @@ -136564,7 +136842,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/projects/items#get-an-item-for-a-user-owned-project parameters: - *438 - - *152 + - *135 - *448 - name: fields description: |- @@ -136609,7 +136887,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/projects/items#update-project-item-for-user parameters: - *438 - - *152 + - *135 - *448 requestBody: required: true @@ -136707,7 +136985,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/projects/items#delete-project-item-for-user parameters: - *438 - - *152 + - *135 - *448 responses: '204': @@ -136731,7 +137009,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/projects/items#list-items-for-a-user-project-view parameters: - *438 - - *152 + - *135 - *926 - name: fields description: |- @@ -136788,7 +137066,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: - - *152 + - *135 - *17 - *19 responses: @@ -136863,7 +137141,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: - - *152 + - *135 - *17 - *19 responses: @@ -136936,7 +137214,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/repos/repos#list-repositories-for-a-user parameters: - - *152 + - *135 - name: type description: Limit results to repositories of the specified type. in: query @@ -137001,7 +137279,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: - - *152 + - *135 - *17 - *19 responses: @@ -137033,7 +137311,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: - - *152 + - *135 - *17 - *19 responses: @@ -137069,7 +137347,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/activity/starring#list-repositories-starred-by-a-user parameters: - - *152 + - *135 - *928 - *113 - *17 @@ -137105,7 +137383,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/activity/watching#list-repositories-watched-by-a-user parameters: - - *152 + - *135 - *17 - *19 responses: @@ -256308,8 +256586,8 @@ x-webhooks: alert: &1000 type: object properties: - number: *135 - created_at: *142 + number: *136 + created_at: *143 updated_at: type: string description: 'The time that the alert was last updated in ISO @@ -256317,8 +256595,8 @@ x-webhooks: format: date-time readOnly: true nullable: true - url: *140 - html_url: *141 + url: *141 + html_url: *142 locations_url: type: string format: uri @@ -257587,7 +257865,7 @@ x-webhooks: required: - vector_string - score - cvss_severities: *137 + cvss_severities: *138 cwes: type: array items: @@ -257851,7 +258129,7 @@ x-webhooks: required: - vector_string - score - cvss_severities: *137 + cvss_severities: *138 cwes: type: array items: diff --git a/descriptions/ghec/dereferenced/ghec.2026-03-10.deref.json b/descriptions/ghec/dereferenced/ghec.2026-03-10.deref.json index f8d3ef0ce3..fa415622a6 100644 --- a/descriptions/ghec/dereferenced/ghec.2026-03-10.deref.json +++ b/descriptions/ghec/dereferenced/ghec.2026-03-10.deref.json @@ -49661,6 +49661,211 @@ } } }, + "/enterprises/{enterprise}/credential-authorizations/revoke-credential-type": { + "post": { + "summary": "Revoke a single credential type for an enterprise", + "description": "Revokes a single credential type (for example, classic personal access tokens)\nacross all organizations within the enterprise. This removes the sign-in\nauthorizations for that credential type for every member of the enterprise.\n\nFor Enterprise Managed User (EMU) enterprises, you can optionally also destroy the\nactual credentials of that type owned by enterprise members by setting the\n`revoke_credentials` parameter to `true`.\n\nThis operation is performed asynchronously. A background job will be queued to process\nthe revocations.\n\n> [!WARNING]\n> If you use a personal access token to call this endpoint, that token may also be\n> revoked or destroyed as part of this operation.\n\nThe authenticated user must be an enterprise owner or have the `write_enterprise_credentials` permission to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) need the `admin:enterprise` scope to use this endpoint.", + "tags": [ + "enterprise-admin" + ], + "operationId": "enterprise-admin/revoke-credential-type-for-enterprise", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-an-enterprise" + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "credential_type" + ], + "properties": { + "credential_type": { + "type": "string", + "description": "The type of credential to revoke across the enterprise.", + "enum": [ + "classic_pat", + "fine_grained_pat", + "ssh_key", + "oauth_app_token" + ] + }, + "revoke_credentials": { + "type": "boolean", + "description": "Whether to also destroy the actual credentials of this type owned by\nenterprise members. This option is only available for Enterprise Managed\nUser (EMU) enterprises. When set to `true`, all credentials of the given\ntype owned by enterprise members will be destroyed in addition to the\ncredential authorizations. Note that `oauth_app_token` credentials cannot\nbe destroyed; for that type only the credential authorizations are revoked.", + "default": false + } + } + }, + "examples": { + "default": { + "value": { + "credential_type": "classic_pat", + "revoke_credentials": false + } + }, + "emu_with_credential_revocation": { + "summary": "EMU enterprise with credential revocation", + "value": { + "credential_type": "classic_pat", + "revoke_credentials": true + } + } + } + } + } + }, + "responses": { + "202": { + "description": "Accepted - The revocation request has been queued", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "message": { + "type": "string", + "description": "A message indicating the revocation has been queued" + }, + "warning": { + "type": "string", + "description": "A warning message if the token used for this request may be revoked" + } + } + }, + "examples": { + "default": { + "value": { + "message": "Credential type revocation has been queued" + } + }, + "with_warning": { + "value": { + "message": "Credential type revocation has been queued", + "warning": "The token used for this request may also have its authorization revoked as part of this operation" + } + } + } + } + } + }, + "403": { + "description": "Forbidden", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + }, + "422": { + "description": "Validation error - The `credential_type` is missing or invalid, or `revoke_credentials` is not available for this enterprise", + "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": { + "invalid_credential_type": { + "summary": "Missing or invalid `credential_type`", + "value": { + "message": "The `credential_type` parameter is required and must be one of: classic_pat, fine_grained_pat, ssh_key, oauth_app_token", + "documentation_url": "https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-an-enterprise" + } + }, + "non_emu_enterprise": { + "summary": "`revoke_credentials` requested on a non-EMU enterprise", + "value": { + "message": "The `revoke_credentials` option is only available for Enterprise Managed User (EMU) enterprises", + "documentation_url": "https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-an-enterprise" + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "credential-authorizations" + } + } + }, "/enterprises/{enterprise}/credential-authorizations/{username}/revoke": { "post": { "summary": "Revoke credential authorizations for a user in an enterprise", @@ -49868,6 +50073,235 @@ } } }, + "/enterprises/{enterprise}/credential-authorizations/{username}/revoke-credential-type": { + "post": { + "summary": "Revoke a single credential type for a user in an enterprise", + "description": "Revokes a single credential type (for example, classic personal access tokens)\nfor a single user within the enterprise. This removes the sign-in authorizations\nfor that credential type across all organizations in the enterprise for the user.\n\nFor Enterprise Managed User (EMU) enterprises, you can optionally also destroy the\nactual credential of that type owned by the user by setting the `revoke_credentials`\nparameter to `true`.\n\nThis operation is performed asynchronously. A background job will be queued to process\nthe revocations.\n\n> [!WARNING]\n> If you use a personal access token to call this endpoint and target yourself, that\n> token may also be revoked or destroyed as part of this operation.\n\nThe authenticated user must be an enterprise owner or have the `write_enterprise_credentials` permission to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) need the `admin:enterprise` scope to use this endpoint.", + "tags": [ + "enterprise-admin" + ], + "operationId": "enterprise-admin/revoke-credential-type-for-user", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-a-user-in-an-enterprise" + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "username", + "description": "The handle for the GitHub user account.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "credential_type" + ], + "properties": { + "credential_type": { + "type": "string", + "description": "The type of credential to revoke for the user.", + "enum": [ + "classic_pat", + "fine_grained_pat", + "ssh_key", + "oauth_app_token" + ] + }, + "revoke_credentials": { + "type": "boolean", + "description": "Whether to also destroy the actual credential of this type owned by the\nuser. This option is only available for Enterprise Managed User (EMU)\nenterprises. When set to `true`, the credential of the given type owned\nby the user will be destroyed in addition to the credential authorizations.\nNote that `oauth_app_token` credentials cannot be destroyed; for that type\nonly the credential authorizations are revoked.", + "default": false + } + } + }, + "examples": { + "default": { + "value": { + "credential_type": "classic_pat", + "revoke_credentials": false + } + }, + "emu_with_credential_revocation": { + "summary": "EMU enterprise with credential revocation", + "value": { + "credential_type": "classic_pat", + "revoke_credentials": true + } + } + } + } + } + }, + "responses": { + "202": { + "description": "Accepted - The revocation request has been queued", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "message": { + "type": "string", + "description": "A message indicating the revocation has been queued" + }, + "warning": { + "type": "string", + "description": "A warning message if the token used for this request may be revoked" + } + } + }, + "examples": { + "default": { + "value": { + "message": "Credential type revocation for user 'octocat' has been queued" + } + }, + "with_authorization_revoked_warning": { + "summary": "Warning when the calling token may have its authorization revoked", + "value": { + "message": "Credential type revocation for user 'octocat' has been queued", + "warning": "The token used for this request may also have its authorization revoked as part of this operation" + } + }, + "with_credential_destroyed_warning": { + "summary": "Warning when the calling token may be destroyed (EMU with `revoke_credentials`)", + "value": { + "message": "Credential type revocation for user 'octocat' has been queued", + "warning": "The token used for this request may also be destroyed as part of this operation" + } + } + } + } + } + }, + "403": { + "description": "Forbidden", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + }, + "422": { + "description": "Validation error - The `credential_type` is missing or invalid, the target user cannot be revoked, or `revoke_credentials` is not available for this enterprise", + "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": { + "invalid_credential_type": { + "summary": "Missing or invalid `credential_type`", + "value": { + "message": "The `credential_type` parameter is required and must be one of: classic_pat, fine_grained_pat, ssh_key, oauth_app_token", + "documentation_url": "https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-a-user-in-an-enterprise" + } + }, + "non_emu_enterprise": { + "summary": "`revoke_credentials` requested on a non-EMU enterprise", + "value": { + "message": "The `revoke_credentials` option is only available for Enterprise Managed User (EMU) enterprises", + "documentation_url": "https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-a-user-in-an-enterprise" + } + }, + "first_emu_owner": { + "summary": "Target user is the first EMU owner", + "value": { + "message": "The first EMU owner cannot be targeted for credential revocation.", + "documentation_url": "https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-a-user-in-an-enterprise" + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "credential-authorizations" + } + } + }, "/enterprises/{enterprise}/dependabot/alerts": { "get": { "summary": "List Dependabot alerts for an enterprise", @@ -72889,17 +73323,14 @@ "type": "string", "description": "A machine-readable code describing the error.", "enum": [ - "none", - "config_load", - "compile_db", + "invalid", + "unprocessable", "start_delimiter", "end_delimiter", - "display_name", + "name", "must_match", "must_not_match", - "custom_pattern_version_mismatch", - "db_size", - "db_size_calculation" + "custom_pattern_version_mismatch" ] }, "message": { @@ -276250,17 +276681,14 @@ "type": "string", "description": "A machine-readable code describing the error.", "enum": [ - "none", - "config_load", - "compile_db", + "invalid", + "unprocessable", "start_delimiter", "end_delimiter", - "display_name", + "name", "must_match", "must_not_match", - "custom_pattern_version_mismatch", - "db_size", - "db_size_calculation" + "custom_pattern_version_mismatch" ] }, "message": { @@ -363866,6 +364294,15 @@ "enum": [ "weekly" ] + }, + "ai_findings_option": { + "description": "The AI findings configuration for the repository.", + "nullable": true, + "type": "string", + "enum": [ + "disabled", + "on_push" + ] } } }, @@ -363880,7 +364317,8 @@ "runner_type": "standard", "runner_label": null, "updated_at": "2023-01-01T00:00:00Z", - "schedule": "weekly" + "schedule": "weekly", + "ai_findings_option": "on_push" } } } @@ -364043,6 +364481,14 @@ "ruby" ] } + }, + "ai_findings_option": { + "description": "Whether AI findings run for Code Quality on this repository.", + "type": "string", + "enum": [ + "disabled", + "on_push" + ] } }, "anyOf": [ @@ -364065,6 +364511,11 @@ "required": [ "languages" ] + }, + { + "required": [ + "ai_findings_option" + ] } ], "additionalProperties": false @@ -611021,7 +611472,7 @@ }, "post": { "summary": "Create a release", - "description": "Users with push access to the repository can create a release.\n\nThis endpoint triggers [notifications](https://docs.github.com/enterprise-cloud@latest/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see \"[Rate limits for the API](https://docs.github.com/enterprise-cloud@latest/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)\" and \"[Best practices for using the REST API](https://docs.github.com/enterprise-cloud@latest/rest/guides/best-practices-for-using-the-rest-api).\"", + "description": "Users with push access to the repository can create a release.\n\n> [!NOTE]\n> If the commit identified by `target_commitish` (or, when `target_commitish` is omitted, the latest commit on the default branch) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead.\n\nOAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the \"Workflows\" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see \"[Automatic token authentication](https://docs.github.com/enterprise-cloud@latest/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)\".\n\nThis endpoint triggers [notifications](https://docs.github.com/enterprise-cloud@latest/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see \"[Rate limits for the API](https://docs.github.com/enterprise-cloud@latest/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)\" and \"[Best practices for using the REST API](https://docs.github.com/enterprise-cloud@latest/rest/guides/best-practices-for-using-the-rest-api).\"", "tags": [ "repos" ], @@ -614641,7 +615092,7 @@ }, "patch": { "summary": "Update a release", - "description": "Users with push access to the repository can edit a release.", + "description": "Users with push access to the repository can edit a release.\n\n> [!NOTE]\n> If the resolved target commit (the new value of `target_commitish` if you are changing it, otherwise the existing target) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead.\n\nOAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the \"Workflows\" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see \"[Automatic token authentication](https://docs.github.com/enterprise-cloud@latest/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)\".", "tags": [ "repos" ], @@ -633783,17 +634234,14 @@ "type": "string", "description": "A machine-readable code describing the error.", "enum": [ - "none", - "config_load", - "compile_db", + "invalid", + "unprocessable", "start_delimiter", "end_delimiter", - "display_name", + "name", "must_match", "must_not_match", - "custom_pattern_version_mismatch", - "db_size", - "db_size_calculation" + "custom_pattern_version_mismatch" ] }, "message": { diff --git a/descriptions/ghec/dereferenced/ghec.2026-03-10.deref.yaml b/descriptions/ghec/dereferenced/ghec.2026-03-10.deref.yaml index 8036c69833..fa1fff55e4 100644 --- a/descriptions/ghec/dereferenced/ghec.2026-03-10.deref.yaml +++ b/descriptions/ghec/dereferenced/ghec.2026-03-10.deref.yaml @@ -666,7 +666,7 @@ paths: - vulnerable_version_range - first_patched_version - vulnerable_functions - cvss_severities: &137 + cvss_severities: &138 type: object nullable: true properties: @@ -706,7 +706,7 @@ paths: required: - vector_string - score - epss: &138 + epss: &139 type: object nullable: true readOnly: true @@ -3813,7 +3813,7 @@ paths: title: Enterprise description: An enterprise on GitHub. type: object - properties: &148 + properties: &149 description: description: A short description of the enterprise. type: string @@ -3855,7 +3855,7 @@ paths: avatar_url: type: string format: uri - required: &149 + required: &150 - id - node_id - name @@ -15980,28 +15980,28 @@ paths: items: &336 type: object properties: - number: &135 + number: &136 type: integer description: The security alert number. readOnly: true - created_at: &142 + created_at: &143 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: &143 + updated_at: &144 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: &140 + url: &141 type: string description: The REST API URL of the alert resource. format: uri readOnly: true - html_url: &141 + html_url: &142 type: string description: The GitHub URL of the alert resource. format: uri @@ -16020,7 +16020,7 @@ paths: - open - dismissed - fixed - fixed_at: &145 + fixed_at: &146 type: string description: 'The time that the alert was no longer detected and was considered fixed in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.' @@ -16034,7 +16034,7 @@ paths: properties: *20 required: *21 nullable: true - dismissed_at: &144 + dismissed_at: &145 type: string description: 'The time that the alert was dismissed in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.' @@ -16193,7 +16193,7 @@ paths: title: Simple Repository description: A GitHub repository. type: object - properties: &146 + properties: &147 id: type: integer format: int64 @@ -16420,7 +16420,7 @@ paths: format: uri example: https://api.github.com/repos/octocat/Hello-World/hooks description: The API URL to list the hooks on the repository. - required: &147 + required: &148 - archive_url - assignees_url - blobs_url @@ -20343,6 +20343,123 @@ paths: enabledForGitHubApps: true category: enterprise-admin subcategory: credential-authorizations + "/enterprises/{enterprise}/credential-authorizations/revoke-credential-type": + post: + summary: Revoke a single credential type for an enterprise + description: |- + Revokes a single credential type (for example, classic personal access tokens) + across all organizations within the enterprise. This removes the sign-in + authorizations for that credential type for every member of the enterprise. + + For Enterprise Managed User (EMU) enterprises, you can optionally also destroy the + actual credentials of that type owned by enterprise members by setting the + `revoke_credentials` parameter to `true`. + + This operation is performed asynchronously. A background job will be queued to process + the revocations. + + > [!WARNING] + > If you use a personal access token to call this endpoint, that token may also be + > revoked or destroyed as part of this operation. + + The authenticated user must be an enterprise owner or have the `write_enterprise_credentials` permission to use this endpoint. + + OAuth app tokens and personal access tokens (classic) need the `admin:enterprise` scope to use this endpoint. + tags: + - enterprise-admin + operationId: enterprise-admin/revoke-credential-type-for-enterprise + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-an-enterprise + parameters: + - *42 + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - credential_type + properties: + credential_type: + type: string + description: The type of credential to revoke across the enterprise. + enum: + - classic_pat + - fine_grained_pat + - ssh_key + - oauth_app_token + revoke_credentials: + type: boolean + description: |- + Whether to also destroy the actual credentials of this type owned by + enterprise members. This option is only available for Enterprise Managed + User (EMU) enterprises. When set to `true`, all credentials of the given + type owned by enterprise members will be destroyed in addition to the + credential authorizations. Note that `oauth_app_token` credentials cannot + be destroyed; for that type only the credential authorizations are revoked. + default: false + examples: + default: + value: + credential_type: classic_pat + revoke_credentials: false + emu_with_credential_revocation: + summary: EMU enterprise with credential revocation + value: + credential_type: classic_pat + revoke_credentials: true + responses: + '202': + description: Accepted - The revocation request has been queued + content: + application/json: + schema: + type: object + properties: + message: + type: string + description: A message indicating the revocation has been queued + warning: + type: string + description: A warning message if the token used for this request + may be revoked + examples: + default: + value: + message: Credential type revocation has been queued + with_warning: + value: + message: Credential type revocation has been queued + warning: The token used for this request may also have its authorization + revoked as part of this operation + '403': *29 + '404': *6 + '422': + description: Validation error - The `credential_type` is missing or invalid, + or `revoke_credentials` is not available for this enterprise + content: + application/json: + schema: *3 + examples: + invalid_credential_type: + summary: Missing or invalid `credential_type` + value: + message: 'The `credential_type` parameter is required and must + be one of: classic_pat, fine_grained_pat, ssh_key, oauth_app_token' + documentation_url: https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-an-enterprise + non_emu_enterprise: + summary: "`revoke_credentials` requested on a non-EMU enterprise" + value: + message: The `revoke_credentials` option is only available for + Enterprise Managed User (EMU) enterprises + documentation_url: https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-an-enterprise + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: credential-authorizations "/enterprises/{enterprise}/credential-authorizations/{username}/revoke": post: summary: Revoke credential authorizations for a user in an enterprise @@ -20373,7 +20490,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/credential-authorizations#revoke-credential-authorizations-for-a-user-in-an-enterprise parameters: - *42 - - &152 + - &135 name: username description: The handle for the GitHub user account. in: path @@ -20465,6 +20582,143 @@ paths: enabledForGitHubApps: true category: enterprise-admin subcategory: credential-authorizations + "/enterprises/{enterprise}/credential-authorizations/{username}/revoke-credential-type": + post: + summary: Revoke a single credential type for a user in an enterprise + description: |- + Revokes a single credential type (for example, classic personal access tokens) + for a single user within the enterprise. This removes the sign-in authorizations + for that credential type across all organizations in the enterprise for the user. + + For Enterprise Managed User (EMU) enterprises, you can optionally also destroy the + actual credential of that type owned by the user by setting the `revoke_credentials` + parameter to `true`. + + This operation is performed asynchronously. A background job will be queued to process + the revocations. + + > [!WARNING] + > If you use a personal access token to call this endpoint and target yourself, that + > token may also be revoked or destroyed as part of this operation. + + The authenticated user must be an enterprise owner or have the `write_enterprise_credentials` permission to use this endpoint. + + OAuth app tokens and personal access tokens (classic) need the `admin:enterprise` scope to use this endpoint. + tags: + - enterprise-admin + operationId: enterprise-admin/revoke-credential-type-for-user + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-a-user-in-an-enterprise + parameters: + - *42 + - *135 + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - credential_type + properties: + credential_type: + type: string + description: The type of credential to revoke for the user. + enum: + - classic_pat + - fine_grained_pat + - ssh_key + - oauth_app_token + revoke_credentials: + type: boolean + description: |- + Whether to also destroy the actual credential of this type owned by the + user. This option is only available for Enterprise Managed User (EMU) + enterprises. When set to `true`, the credential of the given type owned + by the user will be destroyed in addition to the credential authorizations. + Note that `oauth_app_token` credentials cannot be destroyed; for that type + only the credential authorizations are revoked. + default: false + examples: + default: + value: + credential_type: classic_pat + revoke_credentials: false + emu_with_credential_revocation: + summary: EMU enterprise with credential revocation + value: + credential_type: classic_pat + revoke_credentials: true + responses: + '202': + description: Accepted - The revocation request has been queued + content: + application/json: + schema: + type: object + properties: + message: + type: string + description: A message indicating the revocation has been queued + warning: + type: string + description: A warning message if the token used for this request + may be revoked + examples: + default: + value: + message: Credential type revocation for user 'octocat' has been + queued + with_authorization_revoked_warning: + summary: Warning when the calling token may have its authorization + revoked + value: + message: Credential type revocation for user 'octocat' has been + queued + warning: The token used for this request may also have its authorization + revoked as part of this operation + with_credential_destroyed_warning: + summary: Warning when the calling token may be destroyed (EMU with + `revoke_credentials`) + value: + message: Credential type revocation for user 'octocat' has been + queued + warning: The token used for this request may also be destroyed + as part of this operation + '403': *29 + '404': *6 + '422': + description: Validation error - The `credential_type` is missing or invalid, + the target user cannot be revoked, or `revoke_credentials` is not available + for this enterprise + content: + application/json: + schema: *3 + examples: + invalid_credential_type: + summary: Missing or invalid `credential_type` + value: + message: 'The `credential_type` parameter is required and must + be one of: classic_pat, fine_grained_pat, ssh_key, oauth_app_token' + documentation_url: https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-a-user-in-an-enterprise + non_emu_enterprise: + summary: "`revoke_credentials` requested on a non-EMU enterprise" + value: + message: The `revoke_credentials` option is only available for + Enterprise Managed User (EMU) enterprises + documentation_url: https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-a-user-in-an-enterprise + first_emu_owner: + summary: Target user is the first EMU owner + value: + message: The first EMU owner cannot be targeted for credential + revocation. + documentation_url: https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-a-user-in-an-enterprise + x-github: + githubCloudOnly: true + enabledForGitHubApps: true + category: enterprise-admin + subcategory: credential-authorizations "/enterprises/{enterprise}/dependabot/alerts": get: summary: List Dependabot alerts for an enterprise @@ -20602,7 +20856,7 @@ paths: type: object description: A Dependabot alert. properties: - number: *135 + number: *136 state: type: string description: The state of the Dependabot alert. @@ -20617,7 +20871,7 @@ paths: description: Details for the vulnerable dependency. readOnly: true properties: - package: &136 + package: &137 type: object description: Details for the vulnerable package. readOnly: true @@ -20692,13 +20946,13 @@ paths: description: Vulnerable version range information for the advisory. readOnly: true - items: &139 + items: &140 type: object description: Details pertaining to one vulnerable version range for the advisory. readOnly: true properties: - package: *136 + package: *137 severity: type: string description: The severity of the vulnerability. @@ -20750,8 +21004,8 @@ paths: enum: - general - malware - cvss_severities: *137 - epss: *138 + cvss_severities: *138 + epss: *139 cwes: type: array description: Details for the advisory pertaining to Common @@ -20849,12 +21103,12 @@ paths: - updated_at - withdrawn_at additionalProperties: false - security_vulnerability: *139 - url: *140 - html_url: *141 - created_at: *142 - updated_at: *143 - dismissed_at: *144 + security_vulnerability: *140 + url: *141 + html_url: *142 + created_at: *143 + updated_at: *144 + dismissed_at: *145 dismissed_by: title: Simple User description: A GitHub user. @@ -20878,7 +21132,7 @@ paths: dismissal. nullable: true maxLength: 280 - fixed_at: *145 + fixed_at: *146 auto_dismissed_at: &649 type: string description: 'The time that the alert was auto-dismissed in @@ -21354,8 +21608,8 @@ paths: title: Simple Repository description: A GitHub repository. type: object - properties: *146 - required: *147 + properties: *147 + required: *148 nullable: true additionalProperties: false examples: @@ -21863,8 +22117,8 @@ paths: title: Enterprise description: An enterprise on GitHub. type: object - properties: *148 - required: *149 + properties: *149 + required: *150 nullable: true created_at: description: The date and time the role was created. @@ -21957,7 +22211,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/enterprise-roles#remove-all-enterprise-roles-from-a-team parameters: - *42 - - &150 + - &151 name: team_slug description: The slug of the enterprise team name. in: path @@ -22000,8 +22254,8 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/enterprise-roles#assign-an-enterprise-role-to-a-team parameters: - *42 - - *150 - - &151 + - *151 + - &152 name: role_id description: The unique identifier of the role. in: path @@ -22043,8 +22297,8 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/enterprise-roles#remove-an-enterprise-role-from-a-team parameters: - *42 - - *150 - *151 + - *152 responses: '204': description: Response @@ -22078,7 +22332,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/enterprise-roles#remove-all-enterprise-roles-from-a-user parameters: - *42 - - *152 + - *135 responses: '204': description: Response @@ -22112,8 +22366,8 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/enterprise-roles#assign-an-enterprise-role-to-an-enterprise-user parameters: - *42 + - *135 - *152 - - *151 responses: '204': description: Response @@ -22146,8 +22400,8 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/enterprise-roles#remove-enterprise-user-role-assignment parameters: - *42 + - *135 - *152 - - *151 responses: '204': description: Response @@ -22181,7 +22435,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/enterprise-roles#get-an-enterprise-role parameters: - *42 - - *151 + - *152 responses: '200': description: Response @@ -22241,7 +22495,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/enterprise-roles#list-teams-that-are-assigned-to-an-enterprise-role parameters: - *42 - - *151 + - *152 - *17 - *19 responses: @@ -22292,7 +22546,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/enterprise-roles#list-users-that-are-assigned-to-an-enterprise-role parameters: - *42 - - *151 + - *152 - *17 - *19 responses: @@ -22948,7 +23202,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: - *42 - - *152 + - *135 responses: '200': description: The user's GitHub Copilot seat details, including usage. @@ -26090,8 +26344,8 @@ paths: items: &476 type: object properties: - number: *135 - created_at: *142 + number: *136 + created_at: *143 updated_at: type: string description: 'The time that the alert was last updated in ISO @@ -26099,8 +26353,8 @@ paths: format: date-time readOnly: true nullable: true - url: *140 - html_url: *141 + url: *141 + html_url: *142 locations_url: type: string format: uri @@ -27083,17 +27337,14 @@ paths: description: A machine-readable code describing the error. enum: - - none - - config_load - - compile_db + - invalid + - unprocessable - start_delimiter - end_delimiter - - display_name + - name - must_match - must_not_match - custom_pattern_version_mismatch - - db_size - - db_size_calculation message: type: string description: A human-readable description of the error. @@ -30588,7 +30839,7 @@ paths: parameters: - *42 - *222 - - *152 + - *135 responses: '200': description: User is a member of the enterprise team. @@ -30633,7 +30884,7 @@ paths: parameters: - *42 - *222 - - *152 + - *135 responses: '201': description: Successfully added team member @@ -30660,7 +30911,7 @@ paths: parameters: - *42 - *222 - - *152 + - *135 responses: '204': description: Response @@ -45596,7 +45847,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/blocking#check-if-a-user-is-blocked-by-an-organization parameters: - *90 - - *152 + - *135 responses: '204': description: If the user is blocked @@ -45622,7 +45873,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/blocking#block-a-user-from-an-organization parameters: - *90 - - *152 + - *135 responses: '204': description: Response @@ -45643,7 +45894,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/blocking#unblock-a-user-from-an-organization parameters: - *90 - - *152 + - *135 responses: '204': description: Response @@ -51960,7 +52211,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/custom-roles#get-a-custom-repository-role parameters: - *90 - - *151 + - *152 responses: '200': description: Response @@ -51991,7 +52242,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/custom-roles#update-a-custom-repository-role parameters: - *90 - - *151 + - *152 requestBody: required: true content: @@ -52061,7 +52312,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/custom-roles#delete-a-custom-repository-role parameters: - *90 - - *151 + - *152 responses: '204': description: Response @@ -52141,7 +52392,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/custom-roles#closing-down---get-a-custom-role parameters: - *90 - - *151 + - *152 responses: '200': description: Response @@ -52178,7 +52429,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/custom-roles#closing-down---update-a-custom-role parameters: - *90 - - *151 + - *152 requestBody: required: true content: @@ -52231,7 +52482,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/custom-roles#closing-down---delete-a-custom-role parameters: - *90 - - *151 + - *152 responses: '204': description: Response @@ -56614,7 +56865,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/members#check-organization-membership-for-a-user parameters: - *90 - - *152 + - *135 responses: '204': description: Response if requester is an organization member and user is @@ -56649,7 +56900,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/members#remove-an-organization-member parameters: - *90 - - *152 + - *135 responses: '204': description: Response @@ -56677,7 +56928,7 @@ paths: - *17 - *19 - *90 - - *152 + - *135 responses: '200': description: Response @@ -56721,7 +56972,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/codespaces/organizations#delete-a-codespace-from-the-organization parameters: - *90 - - *152 + - *135 - &411 name: codespace_name in: path @@ -56756,7 +57007,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/codespaces/organizations#stop-a-codespace-for-an-organization-user parameters: - *90 - - *152 + - *135 - *411 responses: '200': @@ -56939,7 +57190,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/copilot/copilot-user-management#get-copilot-seat-assignment-details-for-a-user parameters: - *90 - - *152 + - *135 responses: '200': description: The user's GitHub Copilot seat details, including usage. @@ -57015,7 +57266,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/members#get-organization-membership-for-a-user parameters: - *90 - - *152 + - *135 responses: '200': description: Response @@ -57161,7 +57412,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/members#set-organization-membership-for-a-user parameters: - *90 - - *152 + - *135 requestBody: required: false content: @@ -57217,7 +57468,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/members#remove-organization-membership-for-a-user parameters: - *90 - - *152 + - *135 responses: '204': description: Response @@ -58439,7 +58690,7 @@ paths: parameters: - *90 - *227 - - *151 + - *152 responses: '204': description: Response @@ -58470,7 +58721,7 @@ paths: parameters: - *90 - *227 - - *151 + - *152 responses: '204': description: Response @@ -58496,7 +58747,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/organization-roles#remove-all-organization-roles-for-a-user parameters: - *90 - - *152 + - *135 responses: '204': description: Response @@ -58522,8 +58773,8 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/organization-roles#assign-an-organization-role-to-a-user parameters: - *90 + - *135 - *152 - - *151 responses: '204': description: Response @@ -58554,8 +58805,8 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/organization-roles#remove-an-organization-role-from-a-user parameters: - *90 + - *135 - *152 - - *151 responses: '204': description: Response @@ -58584,7 +58835,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/organization-roles#get-an-organization-role parameters: - *90 - - *151 + - *152 responses: '200': description: Response @@ -58648,7 +58899,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/organization-roles#update-a-custom-organization-role parameters: - *90 - - *151 + - *152 requestBody: required: true content: @@ -58741,7 +58992,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/organization-roles#delete-a-custom-organization-role parameters: - *90 - - *151 + - *152 responses: '204': description: Response @@ -58767,7 +59018,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/organization-roles#list-teams-that-are-assigned-to-an-organization-role parameters: - *90 - - *151 + - *152 - *17 - *19 responses: @@ -58908,7 +59159,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/organization-roles#list-users-that-are-assigned-to-an-organization-role parameters: - *90 - - *151 + - *152 - *17 - *19 responses: @@ -59114,7 +59365,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/outside-collaborators#convert-an-organization-member-to-outside-collaborator parameters: - *90 - - *152 + - *135 requestBody: required: false content: @@ -59172,7 +59423,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/outside-collaborators#remove-outside-collaborator-from-an-organization parameters: - *90 - - *152 + - *135 responses: '204': description: Response @@ -64627,7 +64878,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/members#check-public-organization-membership-for-a-user parameters: - *90 - - *152 + - *135 responses: '204': description: Response if user is a public member @@ -64652,7 +64903,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/members#set-public-organization-membership-for-the-authenticated-user parameters: - *90 - - *152 + - *135 responses: '204': description: Response @@ -64674,7 +64925,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/members#remove-public-organization-membership-for-the-authenticated-user parameters: - *90 - - *152 + - *135 responses: '204': description: Response @@ -67433,7 +67684,7 @@ paths: - patched_versions - vulnerable_functions additionalProperties: false - cvss_severities: *137 + cvss_severities: *138 cwes: type: array nullable: true @@ -69661,7 +69912,7 @@ paths: parameters: - *90 - *227 - - *152 + - *135 responses: '200': description: Response @@ -69732,7 +69983,7 @@ paths: parameters: - *90 - *227 - - *152 + - *135 requestBody: required: false content: @@ -69796,7 +70047,7 @@ paths: parameters: - *90 - *227 - - *152 + - *135 responses: '204': description: Response @@ -84872,6 +85123,13 @@ paths: type: string enum: - weekly + ai_findings_option: + description: The AI findings configuration for the repository. + nullable: true + type: string + enum: + - disabled + - on_push examples: default: value: @@ -84883,6 +85141,7 @@ paths: runner_label: updated_at: '2023-01-01T00:00:00Z' schedule: weekly + ai_findings_option: on_push '403': *582 '404': *6 '503': *204 @@ -84943,6 +85202,12 @@ paths: - javascript-typescript - python - ruby + ai_findings_option: + description: Whether AI findings run for Code Quality on this repository. + type: string + enum: + - disabled + - on_push anyOf: - required: - state @@ -84952,6 +85217,8 @@ paths: - runner_label - required: - languages + - required: + - ai_findings_option additionalProperties: false examples: default: @@ -85097,14 +85364,14 @@ paths: items: type: object properties: - number: *135 - created_at: *142 - updated_at: *143 - url: *140 - html_url: *141 + number: *136 + created_at: *143 + updated_at: *144 + url: *141 + html_url: *142 instances_url: *585 state: *116 - fixed_at: *145 + fixed_at: *146 dismissed_by: title: Simple User description: A GitHub user. @@ -85112,7 +85379,7 @@ paths: properties: *20 required: *21 nullable: true - dismissed_at: *144 + dismissed_at: *145 dismissed_reason: *586 dismissed_comment: *587 rule: *588 @@ -85280,7 +85547,7 @@ paths: field in the response from the `GET /repos/{owner}/{repo}/code-scanning/alerts` operation. required: true - schema: *135 + schema: *136 responses: '200': description: Response @@ -85289,14 +85556,14 @@ paths: schema: &593 type: object properties: - number: *135 - created_at: *142 - updated_at: *143 - url: *140 - html_url: *141 + number: *136 + created_at: *143 + updated_at: *144 + url: *141 + html_url: *142 instances_url: *585 state: *116 - fixed_at: *145 + fixed_at: *146 dismissed_by: title: Simple User description: A GitHub user. @@ -85304,7 +85571,7 @@ paths: properties: *20 required: *21 nullable: true - dismissed_at: *144 + dismissed_at: *145 dismissed_reason: *586 dismissed_comment: *587 rule: @@ -89036,7 +89303,7 @@ paths: parameters: - *510 - *511 - - *152 + - *135 responses: '204': description: Response if user is a collaborator @@ -89084,7 +89351,7 @@ paths: parameters: - *510 - *511 - - *152 + - *135 requestBody: required: false content: @@ -89341,7 +89608,7 @@ paths: parameters: - *510 - *511 - - *152 + - *135 responses: '204': description: No Content when collaborator was removed from the repository. @@ -89374,7 +89641,7 @@ paths: parameters: - *510 - *511 - - *152 + - *135 responses: '200': description: if user has admin permissions @@ -93620,7 +93887,7 @@ paths: type: object description: A Dependabot alert. properties: - number: *135 + number: *136 state: type: string description: The state of the Dependabot alert. @@ -93635,7 +93902,7 @@ paths: description: Details for the vulnerable dependency. readOnly: true properties: - package: *136 + package: *137 manifest_path: type: string description: The full path to the dependency manifest file, @@ -93664,12 +93931,12 @@ paths: - transitive - inconclusive security_advisory: *648 - security_vulnerability: *139 - url: *140 - html_url: *141 - created_at: *142 - updated_at: *143 - dismissed_at: *144 + security_vulnerability: *140 + url: *141 + html_url: *142 + created_at: *143 + updated_at: *144 + dismissed_at: *145 dismissed_by: title: Simple User description: A GitHub user. @@ -93693,7 +93960,7 @@ paths: dismissal. nullable: true maxLength: 280 - fixed_at: *145 + fixed_at: *146 auto_dismissed_at: *649 dismissal_request: *650 assignees: @@ -93961,7 +94228,7 @@ paths: or in `number` fields in the response from the `GET /repos/{owner}/{repo}/dependabot/alerts` operation. required: true - schema: *135 + schema: *136 responses: '200': description: Response @@ -115018,6 +115285,11 @@ paths: description: |- Users with push access to the repository can create a release. + > [!NOTE] + > If the commit identified by `target_commitish` (or, when `target_commitish` is omitted, the latest commit on the default branch) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead. + + OAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the "Workflows" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see "[Automatic token authentication](https://docs.github.com/enterprise-cloud@latest/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)". + This endpoint triggers [notifications](https://docs.github.com/enterprise-cloud@latest/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/enterprise-cloud@latest/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)" and "[Best practices for using the REST API](https://docs.github.com/enterprise-cloud@latest/rest/guides/best-practices-for-using-the-rest-api)." tags: - repos @@ -115531,7 +115803,13 @@ paths: subcategory: releases patch: summary: Update a release - description: Users with push access to the repository can edit a release. + description: |- + Users with push access to the repository can edit a release. + + > [!NOTE] + > If the resolved target commit (the new value of `target_commitish` if you are changing it, otherwise the existing target) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead. + + OAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the "Workflows" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see "[Automatic token authentication](https://docs.github.com/enterprise-cloud@latest/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)". tags: - repos operationId: repos/update-release @@ -116655,8 +116933,8 @@ paths: items: type: object properties: - number: *135 - created_at: *142 + number: *136 + created_at: *143 updated_at: type: string description: 'The time that the alert was last updated in ISO @@ -116664,8 +116942,8 @@ paths: format: date-time readOnly: true nullable: true - url: *140 - html_url: *141 + url: *141 + html_url: *142 locations_url: type: string format: uri @@ -116954,8 +117232,8 @@ paths: schema: &810 type: object properties: - number: *135 - created_at: *142 + number: *136 + created_at: *143 updated_at: type: string description: 'The time that the alert was last updated in ISO @@ -116963,8 +117241,8 @@ paths: format: date-time readOnly: true nullable: true - url: *140 - html_url: *141 + url: *141 + html_url: *142 locations_url: type: string format: uri @@ -125281,7 +125559,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/teams/members#get-team-member-legacy parameters: - *868 - - *152 + - *135 responses: '204': description: if user is a member @@ -125318,7 +125596,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/teams/members#add-team-member-legacy parameters: - *868 - - *152 + - *135 responses: '204': description: Response @@ -125358,7 +125636,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/teams/members#remove-team-member-legacy parameters: - *868 - - *152 + - *135 responses: '204': description: Response @@ -125395,7 +125673,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/teams/members#get-team-membership-for-a-user-legacy parameters: - *868 - - *152 + - *135 responses: '200': description: Response @@ -125437,7 +125715,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/teams/members#add-or-update-team-membership-for-a-user-legacy parameters: - *868 - - *152 + - *135 requestBody: required: false content: @@ -125499,7 +125777,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/teams/members#remove-team-membership-for-a-user-legacy parameters: - *868 - - *152 + - *135 responses: '204': description: Response @@ -126594,7 +126872,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: - - *152 + - *135 responses: '204': description: If the user is blocked @@ -126622,7 +126900,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/users/blocking#block-a-user parameters: - - *152 + - *135 responses: '204': description: Response @@ -126646,7 +126924,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/users/blocking#unblock-a-user parameters: - - *152 + - *135 responses: '204': description: Response @@ -128893,7 +129171,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: - - *152 + - *135 responses: '204': description: if the person is followed by the authenticated user @@ -128923,7 +129201,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/users/followers#follow-a-user parameters: - - *152 + - *135 responses: '204': description: Response @@ -128948,7 +129226,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/users/followers#unfollow-a-user parameters: - - *152 + - *135 responses: '204': description: Response @@ -133229,7 +133507,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/users/users#get-a-user parameters: - - *152 + - *135 responses: '200': description: Response @@ -133267,7 +133545,7 @@ paths: - *17 - *111 - *112 - - *152 + - *135 requestBody: required: true content: @@ -133349,7 +133627,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/users/attestations#delete-attestations-in-bulk parameters: - - *152 + - *135 requestBody: required: true content: @@ -133414,7 +133692,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/users/attestations#delete-attestations-by-subject-digest parameters: - - *152 + - *135 - name: subject_digest description: Subject Digest in: path @@ -133445,7 +133723,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/users/attestations#delete-attestations-by-id parameters: - - *152 + - *135 - name: attestation_id description: Attestation ID in: path @@ -133483,7 +133761,7 @@ paths: - *17 - *111 - *112 - - *152 + - *135 - name: subject_digest description: Subject Digest in: path @@ -133553,7 +133831,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/copilot-spaces#list-copilot-spaces-for-a-user parameters: - - *152 + - *135 - name: per_page description: The number of results per page (max 100). in: query @@ -133708,7 +133986,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/copilot-spaces#create-a-copilot-space-for-a-user parameters: - - *152 + - *135 requestBody: required: true content: @@ -133888,7 +134166,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/copilot-spaces#get-a-copilot-space-for-a-user parameters: - - *152 + - *135 - name: space_number description: The unique identifier of the Copilot Space. in: path @@ -133924,7 +134202,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/copilot-spaces#set-a-copilot-space-for-a-user parameters: - - *152 + - *135 - name: space_number description: The unique identifier of the Copilot Space. in: path @@ -134048,7 +134326,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/copilot-spaces#delete-a-copilot-space-for-a-user parameters: - - *152 + - *135 - name: space_number description: The unique identifier of the Copilot Space. in: path @@ -134082,7 +134360,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/collaborators#list-collaborators-for-a-copilot-space-for-a-user parameters: - - *152 + - *135 - name: space_number description: The unique identifier of the Copilot Space. in: path @@ -134198,7 +134476,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/collaborators#add-a-collaborator-to-a-copilot-space-for-a-user parameters: - - *152 + - *135 - name: space_number description: The unique identifier of the Copilot Space. in: path @@ -134305,7 +134583,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/collaborators#set-a-collaborator-role-for-a-copilot-space-for-a-user parameters: - - *152 + - *135 - name: space_number description: The unique identifier of the Copilot Space. in: path @@ -134418,7 +134696,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/collaborators#remove-a-collaborator-from-a-copilot-space-for-a-user parameters: - - *152 + - *135 - name: space_number description: The unique identifier of the Copilot Space. in: path @@ -134466,7 +134744,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/resources#list-resources-for-a-copilot-space-for-a-user parameters: - - *152 + - *135 - name: space_number description: The unique identifier of the Copilot Space. in: path @@ -134524,7 +134802,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/resources#create-a-resource-for-a-copilot-space-for-a-user parameters: - - *152 + - *135 - name: space_number description: The unique identifier of the Copilot Space. in: path @@ -134629,7 +134907,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/resources#get-a-resource-for-a-copilot-space-for-a-user parameters: - - *152 + - *135 - name: space_number description: The unique identifier of the Copilot Space. in: path @@ -134679,7 +134957,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/resources#set-a-resource-for-a-copilot-space-for-a-user parameters: - - *152 + - *135 - name: space_number description: The unique identifier of the Copilot Space. in: path @@ -134747,7 +135025,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/copilot-spaces/resources#delete-a-resource-from-a-copilot-space-for-a-user parameters: - - *152 + - *135 - name: space_number description: The unique identifier of the Copilot Space. in: path @@ -134783,7 +135061,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: - - *152 + - *135 responses: '200': description: Response @@ -134816,7 +135094,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/activity/events#list-events-for-the-authenticated-user parameters: - - *152 + - *135 - *17 - *19 responses: @@ -134888,7 +135166,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/activity/events#list-organization-events-for-the-authenticated-user parameters: - - *152 + - *135 - *90 - *17 - *19 @@ -134976,7 +135254,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/activity/events#list-public-events-for-a-user parameters: - - *152 + - *135 - *17 - *19 responses: @@ -135044,7 +135322,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/users/followers#list-followers-of-a-user parameters: - - *152 + - *135 - *17 - *19 responses: @@ -135075,7 +135353,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/users/followers#list-the-people-a-user-follows parameters: - - *152 + - *135 - *17 - *19 responses: @@ -135106,7 +135384,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: - - *152 + - *135 - name: target_user in: path required: true @@ -135133,7 +135411,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/gists/gists#list-gists-for-a-user parameters: - - *152 + - *135 - *242 - *17 - *19 @@ -135167,7 +135445,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: - - *152 + - *135 - *17 - *19 responses: @@ -135203,7 +135481,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/users/users#get-contextual-information-for-a-user parameters: - - *152 + - *135 - name: subject_type description: Identifies which additional information you'd like to receive about the person's hovercard. Can be `organization`, `repository`, `issue`, @@ -135275,7 +135553,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: - - *152 + - *135 responses: '200': description: Response @@ -135301,7 +135579,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/users/keys#list-public-keys-for-a-user parameters: - - *152 + - *135 - *17 - *19 responses: @@ -135356,7 +135634,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/orgs/orgs#list-organizations-for-a-user parameters: - - *152 + - *135 - *17 - *19 responses: @@ -135408,7 +135686,7 @@ paths: - nuget - container - *891 - - *152 + - *135 - *19 - *17 responses: @@ -135445,7 +135723,7 @@ paths: parameters: - *422 - *423 - - *152 + - *135 responses: '200': description: Response @@ -135476,7 +135754,7 @@ paths: parameters: - *422 - *423 - - *152 + - *135 responses: '204': description: Response @@ -135510,7 +135788,7 @@ paths: parameters: - *422 - *423 - - *152 + - *135 - name: token description: package token schema: @@ -135544,7 +135822,7 @@ paths: parameters: - *422 - *423 - - *152 + - *135 responses: '200': description: Response @@ -135613,7 +135891,7 @@ paths: - *422 - *423 - *425 - - *152 + - *135 responses: '200': description: Response @@ -135656,7 +135934,7 @@ paths: parameters: - *422 - *423 - - *152 + - *135 - *425 responses: '204': @@ -135691,7 +135969,7 @@ paths: parameters: - *422 - *423 - - *152 + - *135 - *425 responses: '204': @@ -135716,7 +135994,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/projects/projects#list-projects-for-user parameters: - - *152 + - *135 - name: q description: Limit results to projects of the specified type. in: query @@ -135758,7 +136036,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/projects/projects#get-project-for-user parameters: - *438 - - *152 + - *135 responses: '200': description: Response @@ -135789,7 +136067,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/projects/fields#list-project-fields-for-user parameters: - *438 - - *152 + - *135 - *17 - *111 - *112 @@ -135823,7 +136101,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/projects/fields#add-field-to-user-owned-project parameters: - - *152 + - *135 - *438 requestBody: required: true @@ -135936,7 +136214,7 @@ paths: parameters: - *438 - *924 - - *152 + - *135 responses: '200': description: Response @@ -135968,7 +136246,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/projects/items#list-items-for-a-user-owned-project parameters: - *438 - - *152 + - *135 - *111 - *112 - *17 @@ -136023,7 +136301,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/projects/items#add-item-to-user-owned-project parameters: - - *152 + - *135 - *438 requestBody: required: true @@ -136130,7 +136408,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/projects/items#get-an-item-for-a-user-owned-project parameters: - *438 - - *152 + - *135 - *448 - name: fields description: |- @@ -136175,7 +136453,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/projects/items#update-project-item-for-user parameters: - *438 - - *152 + - *135 - *448 requestBody: required: true @@ -136273,7 +136551,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/projects/items#delete-project-item-for-user parameters: - *438 - - *152 + - *135 - *448 responses: '204': @@ -136297,7 +136575,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest/rest/projects/items#list-items-for-a-user-project-view parameters: - *438 - - *152 + - *135 - *926 - name: fields description: |- @@ -136354,7 +136632,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: - - *152 + - *135 - *17 - *19 responses: @@ -136429,7 +136707,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: - - *152 + - *135 - *17 - *19 responses: @@ -136502,7 +136780,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/repos/repos#list-repositories-for-a-user parameters: - - *152 + - *135 - name: type description: Limit results to repositories of the specified type. in: query @@ -136567,7 +136845,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: - - *152 + - *135 - *17 - *19 responses: @@ -136599,7 +136877,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: - - *152 + - *135 - *17 - *19 responses: @@ -136635,7 +136913,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/activity/starring#list-repositories-starred-by-a-user parameters: - - *152 + - *135 - *928 - *113 - *17 @@ -136671,7 +136949,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest/rest/activity/watching#list-repositories-watched-by-a-user parameters: - - *152 + - *135 - *17 - *19 responses: @@ -255497,8 +255775,8 @@ x-webhooks: alert: &1000 type: object properties: - number: *135 - created_at: *142 + number: *136 + created_at: *143 updated_at: type: string description: 'The time that the alert was last updated in ISO @@ -255506,8 +255784,8 @@ x-webhooks: format: date-time readOnly: true nullable: true - url: *140 - html_url: *141 + url: *141 + html_url: *142 locations_url: type: string format: uri @@ -256765,7 +257043,7 @@ x-webhooks: description, and severity. type: object properties: - cvss_severities: *137 + cvss_severities: *138 cwes: type: array items: @@ -257017,7 +257295,7 @@ x-webhooks: description, and severity. type: object properties: - cvss_severities: *137 + cvss_severities: *138 cwes: type: array items: diff --git a/descriptions/ghec/dereferenced/ghec.deref.json b/descriptions/ghec/dereferenced/ghec.deref.json index 6e3e199dda..8b58cd603b 100644 --- a/descriptions/ghec/dereferenced/ghec.deref.json +++ b/descriptions/ghec/dereferenced/ghec.deref.json @@ -50223,6 +50223,211 @@ } } }, + "/enterprises/{enterprise}/credential-authorizations/revoke-credential-type": { + "post": { + "summary": "Revoke a single credential type for an enterprise", + "description": "Revokes a single credential type (for example, classic personal access tokens)\nacross all organizations within the enterprise. This removes the sign-in\nauthorizations for that credential type for every member of the enterprise.\n\nFor Enterprise Managed User (EMU) enterprises, you can optionally also destroy the\nactual credentials of that type owned by enterprise members by setting the\n`revoke_credentials` parameter to `true`.\n\nThis operation is performed asynchronously. A background job will be queued to process\nthe revocations.\n\n> [!WARNING]\n> If you use a personal access token to call this endpoint, that token may also be\n> revoked or destroyed as part of this operation.\n\nThe authenticated user must be an enterprise owner or have the `write_enterprise_credentials` permission to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) need the `admin:enterprise` scope to use this endpoint.", + "tags": [ + "enterprise-admin" + ], + "operationId": "enterprise-admin/revoke-credential-type-for-enterprise", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-an-enterprise" + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "credential_type" + ], + "properties": { + "credential_type": { + "type": "string", + "description": "The type of credential to revoke across the enterprise.", + "enum": [ + "classic_pat", + "fine_grained_pat", + "ssh_key", + "oauth_app_token" + ] + }, + "revoke_credentials": { + "type": "boolean", + "description": "Whether to also destroy the actual credentials of this type owned by\nenterprise members. This option is only available for Enterprise Managed\nUser (EMU) enterprises. When set to `true`, all credentials of the given\ntype owned by enterprise members will be destroyed in addition to the\ncredential authorizations. Note that `oauth_app_token` credentials cannot\nbe destroyed; for that type only the credential authorizations are revoked.", + "default": false + } + } + }, + "examples": { + "default": { + "value": { + "credential_type": "classic_pat", + "revoke_credentials": false + } + }, + "emu_with_credential_revocation": { + "summary": "EMU enterprise with credential revocation", + "value": { + "credential_type": "classic_pat", + "revoke_credentials": true + } + } + } + } + } + }, + "responses": { + "202": { + "description": "Accepted - The revocation request has been queued", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "message": { + "type": "string", + "description": "A message indicating the revocation has been queued" + }, + "warning": { + "type": "string", + "description": "A warning message if the token used for this request may be revoked" + } + } + }, + "examples": { + "default": { + "value": { + "message": "Credential type revocation has been queued" + } + }, + "with_warning": { + "value": { + "message": "Credential type revocation has been queued", + "warning": "The token used for this request may also have its authorization revoked as part of this operation" + } + } + } + } + } + }, + "403": { + "description": "Forbidden", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + }, + "422": { + "description": "Validation error - The `credential_type` is missing or invalid, or `revoke_credentials` is not available for this enterprise", + "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": { + "invalid_credential_type": { + "summary": "Missing or invalid `credential_type`", + "value": { + "message": "The `credential_type` parameter is required and must be one of: classic_pat, fine_grained_pat, ssh_key, oauth_app_token", + "documentation_url": "https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-an-enterprise" + } + }, + "non_emu_enterprise": { + "summary": "`revoke_credentials` requested on a non-EMU enterprise", + "value": { + "message": "The `revoke_credentials` option is only available for Enterprise Managed User (EMU) enterprises", + "documentation_url": "https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-an-enterprise" + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "credential-authorizations" + } + } + }, "/enterprises/{enterprise}/credential-authorizations/{username}/revoke": { "post": { "summary": "Revoke credential authorizations for a user in an enterprise", @@ -50430,6 +50635,235 @@ } } }, + "/enterprises/{enterprise}/credential-authorizations/{username}/revoke-credential-type": { + "post": { + "summary": "Revoke a single credential type for a user in an enterprise", + "description": "Revokes a single credential type (for example, classic personal access tokens)\nfor a single user within the enterprise. This removes the sign-in authorizations\nfor that credential type across all organizations in the enterprise for the user.\n\nFor Enterprise Managed User (EMU) enterprises, you can optionally also destroy the\nactual credential of that type owned by the user by setting the `revoke_credentials`\nparameter to `true`.\n\nThis operation is performed asynchronously. A background job will be queued to process\nthe revocations.\n\n> [!WARNING]\n> If you use a personal access token to call this endpoint and target yourself, that\n> token may also be revoked or destroyed as part of this operation.\n\nThe authenticated user must be an enterprise owner or have the `write_enterprise_credentials` permission to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) need the `admin:enterprise` scope to use this endpoint.", + "tags": [ + "enterprise-admin" + ], + "operationId": "enterprise-admin/revoke-credential-type-for-user", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-a-user-in-an-enterprise" + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "username", + "description": "The handle for the GitHub user account.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "credential_type" + ], + "properties": { + "credential_type": { + "type": "string", + "description": "The type of credential to revoke for the user.", + "enum": [ + "classic_pat", + "fine_grained_pat", + "ssh_key", + "oauth_app_token" + ] + }, + "revoke_credentials": { + "type": "boolean", + "description": "Whether to also destroy the actual credential of this type owned by the\nuser. This option is only available for Enterprise Managed User (EMU)\nenterprises. When set to `true`, the credential of the given type owned\nby the user will be destroyed in addition to the credential authorizations.\nNote that `oauth_app_token` credentials cannot be destroyed; for that type\nonly the credential authorizations are revoked.", + "default": false + } + } + }, + "examples": { + "default": { + "value": { + "credential_type": "classic_pat", + "revoke_credentials": false + } + }, + "emu_with_credential_revocation": { + "summary": "EMU enterprise with credential revocation", + "value": { + "credential_type": "classic_pat", + "revoke_credentials": true + } + } + } + } + } + }, + "responses": { + "202": { + "description": "Accepted - The revocation request has been queued", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "message": { + "type": "string", + "description": "A message indicating the revocation has been queued" + }, + "warning": { + "type": "string", + "description": "A warning message if the token used for this request may be revoked" + } + } + }, + "examples": { + "default": { + "value": { + "message": "Credential type revocation for user 'octocat' has been queued" + } + }, + "with_authorization_revoked_warning": { + "summary": "Warning when the calling token may have its authorization revoked", + "value": { + "message": "Credential type revocation for user 'octocat' has been queued", + "warning": "The token used for this request may also have its authorization revoked as part of this operation" + } + }, + "with_credential_destroyed_warning": { + "summary": "Warning when the calling token may be destroyed (EMU with `revoke_credentials`)", + "value": { + "message": "Credential type revocation for user 'octocat' has been queued", + "warning": "The token used for this request may also be destroyed as part of this operation" + } + } + } + } + } + }, + "403": { + "description": "Forbidden", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + }, + "422": { + "description": "Validation error - The `credential_type` is missing or invalid, the target user cannot be revoked, or `revoke_credentials` is not available for this enterprise", + "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": { + "invalid_credential_type": { + "summary": "Missing or invalid `credential_type`", + "value": { + "message": "The `credential_type` parameter is required and must be one of: classic_pat, fine_grained_pat, ssh_key, oauth_app_token", + "documentation_url": "https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-a-user-in-an-enterprise" + } + }, + "non_emu_enterprise": { + "summary": "`revoke_credentials` requested on a non-EMU enterprise", + "value": { + "message": "The `revoke_credentials` option is only available for Enterprise Managed User (EMU) enterprises", + "documentation_url": "https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-a-user-in-an-enterprise" + } + }, + "first_emu_owner": { + "summary": "Target user is the first EMU owner", + "value": { + "message": "The first EMU owner cannot be targeted for credential revocation.", + "documentation_url": "https://docs.github.com/rest/enterprise-admin/credential-authorizations#revoke-a-single-credential-type-for-a-user-in-an-enterprise" + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": true, + "category": "enterprise-admin", + "subcategory": "credential-authorizations" + } + } + }, "/enterprises/{enterprise}/dependabot/alerts": { "get": { "summary": "List Dependabot alerts for an enterprise", @@ -73502,17 +73936,14 @@ "type": "string", "description": "A machine-readable code describing the error.", "enum": [ - "none", - "config_load", - "compile_db", + "invalid", + "unprocessable", "start_delimiter", "end_delimiter", - "display_name", + "name", "must_match", "must_not_match", - "custom_pattern_version_mismatch", - "db_size", - "db_size_calculation" + "custom_pattern_version_mismatch" ] }, "message": { @@ -288937,17 +289368,14 @@ "type": "string", "description": "A machine-readable code describing the error.", "enum": [ - "none", - "config_load", - "compile_db", + "invalid", + "unprocessable", "start_delimiter", "end_delimiter", - "display_name", + "name", "must_match", "must_not_match", - "custom_pattern_version_mismatch", - "db_size", - "db_size_calculation" + "custom_pattern_version_mismatch" ] }, "message": { @@ -378118,6 +378546,15 @@ "enum": [ "weekly" ] + }, + "ai_findings_option": { + "description": "The AI findings configuration for the repository.", + "nullable": true, + "type": "string", + "enum": [ + "disabled", + "on_push" + ] } } }, @@ -378132,7 +378569,8 @@ "runner_type": "standard", "runner_label": null, "updated_at": "2023-01-01T00:00:00Z", - "schedule": "weekly" + "schedule": "weekly", + "ai_findings_option": "on_push" } } } @@ -378295,6 +378733,14 @@ "ruby" ] } + }, + "ai_findings_option": { + "description": "Whether AI findings run for Code Quality on this repository.", + "type": "string", + "enum": [ + "disabled", + "on_push" + ] } }, "anyOf": [ @@ -378317,6 +378763,11 @@ "required": [ "languages" ] + }, + { + "required": [ + "ai_findings_option" + ] } ], "additionalProperties": false @@ -636006,7 +636457,7 @@ }, "post": { "summary": "Create a release", - "description": "Users with push access to the repository can create a release.\n\nThis endpoint triggers [notifications](https://docs.github.com/enterprise-cloud@latest/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see \"[Rate limits for the API](https://docs.github.com/enterprise-cloud@latest/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)\" and \"[Best practices for using the REST API](https://docs.github.com/enterprise-cloud@latest/rest/guides/best-practices-for-using-the-rest-api).\"", + "description": "Users with push access to the repository can create a release.\n\n> [!NOTE]\n> If the commit identified by `target_commitish` (or, when `target_commitish` is omitted, the latest commit on the default branch) adds or modifies any file under `.github/workflows/` relative to the repository's default branch, the authenticating token must be authorized to modify workflows. Otherwise, this endpoint returns `404 Not Found`; some authentication paths surface `403 Resource not accessible by integration` instead.\n\nOAuth app tokens and personal access tokens (classic) need the `workflow` scope when the resolved target commit modifies workflow files. Fine-grained access tokens and GitHub App installation tokens also need the \"Workflows\" repository permission (write). The `GITHUB_TOKEN` available to GitHub Actions cannot be authorized for this; for more information, see \"[Automatic token authentication](https://docs.github.com/enterprise-cloud@latest/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)\".\n\nThis endpoint triggers [notifications](https://docs.github.com/enterprise-cloud@latest/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint {"code":"deadline_exceeded","msg":"operation timed out"}