From cf11c1c3e6a7cead097cce44eadc072a464f7f10 Mon Sep 17 00:00:00 2001 From: Sarita Iyer <66540150+saritai@users.noreply.github.com> Date: Thu, 26 Feb 2026 09:41:16 -0500 Subject: [PATCH 1/9] Add back CCR custom instructions note (#59628) --- content/copilot/concepts/prompting/response-customization.md | 2 ++ content/copilot/tutorials/use-custom-instructions.md | 2 ++ .../copilot/code-review/custom-instructions-information.md | 2 ++ data/reusables/copilot/code-review/custom-instructions-limit.md | 2 ++ 4 files changed, 8 insertions(+) create mode 100644 data/reusables/copilot/code-review/custom-instructions-limit.md diff --git a/content/copilot/concepts/prompting/response-customization.md b/content/copilot/concepts/prompting/response-customization.md index 6f35bf58988b..ef832a98b163 100644 --- a/content/copilot/concepts/prompting/response-customization.md +++ b/content/copilot/concepts/prompting/response-customization.md @@ -93,6 +93,8 @@ Here are some common use cases and examples for each type of custom instructions * Preferred language for a company which exclusively speaks a single language: `Always respond in Portuguese.` * Organization-wide preferences: `Do not generate code blocks in responses.` +{% data reusables.copilot.code-review.custom-instructions-limit %} + {% data reusables.copilot.custom-instructions-effective %} ## Next steps diff --git a/content/copilot/tutorials/use-custom-instructions.md b/content/copilot/tutorials/use-custom-instructions.md index be148e75dc5a..6a9b10bca99c 100644 --- a/content/copilot/tutorials/use-custom-instructions.md +++ b/content/copilot/tutorials/use-custom-instructions.md @@ -45,6 +45,8 @@ Before writing custom instructions, it's helpful to understand how {% data varia * **Context limits**: Very long instruction files may result in some instructions being overlooked. * **Specificity matters**: Clear, specific instructions work better than vague directives. +{% data reusables.copilot.code-review.custom-instructions-limit %} + Keep these factors in mind as you write your instructions—they'll help you set realistic expectations and write more effective guidance. ## Writing effective custom instructions diff --git a/data/reusables/copilot/code-review/custom-instructions-information.md b/data/reusables/copilot/code-review/custom-instructions-information.md index e35af5103f25..87537de05272 100644 --- a/data/reusables/copilot/code-review/custom-instructions-information.md +++ b/data/reusables/copilot/code-review/custom-instructions-information.md @@ -6,6 +6,8 @@ You can also write instructions that {% data variables.product.prodname_copilot_ For more information, see [AUTOTITLE](/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot). +{% data reusables.copilot.code-review.custom-instructions-limit %} + ### Example This example of a `.github/copilot-instructions.md` file contains three instructions that will be applied to all {% data variables.copilot.copilot_code-review_short %}s in the repository. diff --git a/data/reusables/copilot/code-review/custom-instructions-limit.md b/data/reusables/copilot/code-review/custom-instructions-limit.md new file mode 100644 index 000000000000..183daf978c36 --- /dev/null +++ b/data/reusables/copilot/code-review/custom-instructions-limit.md @@ -0,0 +1,2 @@ +> [!NOTE] +> {% data variables.copilot.copilot_code-review_short %} only reads the first 4,000 characters of any custom instruction file. Any instructions beyond this limit will not affect the reviews generated by {% data variables.copilot.copilot_code-review_short %}. This limit does not apply to {% data variables.copilot.copilot_chat_short %} or {% data variables.copilot.copilot_coding_agent %}. From 83634fe21e72af09b6f50cd19ed33f4bf4699abb Mon Sep 17 00:00:00 2001 From: Sarita Iyer <66540150+saritai@users.noreply.github.com> Date: Thu, 26 Feb 2026 10:00:34 -0500 Subject: [PATCH 2/9] New Copilot CLI article: Adding MCP servers for Copilot CLI (#59810) Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: Sunbrye Ly <56200261+sunbrye@users.noreply.github.com> --- content/copilot/concepts/context/mcp.md | 1 + .../customize-copilot/add-mcp-servers.md | 105 ++++++++++++++++++ .../copilot-cli/customize-copilot/index.md | 1 + .../how-tos/copilot-cli/use-copilot-cli.md | 2 + .../use-mcp/extend-copilot-chat-with-mcp.md | 1 + .../extend-coding-agent-with-mcp.md | 1 + 6 files changed, 111 insertions(+) create mode 100644 content/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers.md diff --git a/content/copilot/concepts/context/mcp.md b/content/copilot/concepts/context/mcp.md index 5a1715bb5f49..729c06663143 100644 --- a/content/copilot/concepts/context/mcp.md +++ b/content/copilot/concepts/context/mcp.md @@ -99,6 +99,7 @@ The {% data variables.product.github %} MCP Registry is a curated list of MCP se ## Next steps +* [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers) * [AUTOTITLE](/copilot/how-tos/context/model-context-protocol/extending-copilot-chat-with-mcp) * [AUTOTITLE](/copilot/how-tos/context/model-context-protocol/using-the-github-mcp-server) * [AUTOTITLE](/copilot/tutorials/enhancing-copilot-agent-mode-with-mcp) diff --git a/content/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers.md b/content/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers.md new file mode 100644 index 000000000000..58e616312205 --- /dev/null +++ b/content/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers.md @@ -0,0 +1,105 @@ +--- +title: Adding MCP servers for {% data variables.copilot.copilot_cli %} +shortTitle: Add MCP servers +allowTitleToDifferFromFilename: true +intro: 'Extend {% data variables.product.prodname_copilot_short %}''s capabilities by connecting Model Context Protocol (MCP) servers to provide additional tools and context.' +versions: + feature: copilot +topics: + - Copilot +contentType: how-tos +category: + - Configure Copilot CLI # Copilot CLI bespoke page + - Author and optimize with Copilot # Copilot discovery page +--- + +The Model Context Protocol (MCP) is an open standard that defines how applications share context with large language models (LLMs). You can connect MCP servers to {% data variables.copilot.copilot_cli %} to give {% data variables.product.prodname_copilot_short %} access to external tools, data sources, and services. For an overview of MCP, see [AUTOTITLE](/copilot/concepts/about-mcp). + +## Adding an MCP server + +> [!NOTE] +> The {% data variables.product.github %} MCP server is built into {% data variables.copilot.copilot_cli_short %} and is already available without any additional configuration. The steps below are for adding other MCP servers. + +You can add MCP servers using the interactive `/mcp add` command within the CLI, or by editing the configuration file directly. + +For installation instructions, available tools, and URLs for specific MCP servers, see the [{% data variables.product.github %} MCP Registry](https://github.com/mcp). + +### Using the `/mcp add` command + +1. In interactive mode, enter `/mcp add`. A configuration form is displayed. Use Tab to navigate between fields. +1. Next to **Server Name**, enter a unique name for the MCP server. This is the name you will use to refer to the server. +1. Next to **Server Type**, select a type by pressing the corresponding number. The following types are available: + + * **Local** or **STDIO**: starts a local process and communicates over standard input/output (`stdin`/`stdout`). Both options work the same way. **STDIO** is the standard MCP protocol type name, so choose this if you want your configuration to be compatible with {% data variables.product.prodname_vscode_shortname %}, the {% data variables.copilot.copilot_coding_agent %}, and other MCP clients. + * **HTTP** or **SSE**: connects to a remote MCP server. **HTTP** uses the Streamable HTTP transport. **SSE** uses the legacy HTTP with Server-Sent Events transport, which is deprecated in the MCP specification but still supported for backwards compatibility. + +1. The remaining fields depend on the server type you selected: + + * If you chose **Local** or **STDIO**: + + * Next to **Command**, enter the command to start the server, including any arguments. For example, `npx @playwright/mcp@latest`. This corresponds to both the `command` and `args` properties in the JSON configuration file. + * Next to **Environment Variables**, optionally specify environment variables the server needs, such as API keys or tokens, as JSON key-value pairs. For example, `{"API_KEY": "YOUR-API-KEY"}`. The `PATH` variable is automatically inherited from your environment. All other environment variables must be configured here. + + * If you chose **HTTP** or **SSE**: + + * Next to **URL**, paste the remote server URL. For example, `https://mcp.context7.com/mcp`. + * Next to **HTTP Headers**, optionally specify HTTP headers as JSON. For example, `{"CONTEXT7_API_KEY": "YOUR-API-KEY"}`. + +1. Next to **Tools**, specify which tools from the server should be available. Enter `*` to include all tools, or provide a comma-separated list of tool names (no quotes needed). The default is `*`. +1. Press Ctrl+S to save the configuration. The MCP server is added and available immediately without restarting the CLI. + +### Editing the configuration file + +You can also add MCP servers by editing the configuration file at `~/.copilot/mcp-config.json`. This is useful if you want to share configurations or add multiple servers at once. + +The following example shows a configuration file with a local server and a remote HTTP server: + +```json copy +{ + "mcpServers": { + "playwright": { + "type": "local", + "command": "npx", + "args": ["@playwright/mcp@latest"], + "env": {}, + "tools": ["*"] + }, + "context7": { + "type": "http", + "url": "https://mcp.context7.com/mcp", + "headers": { + "CONTEXT7_API_KEY": "YOUR-API-KEY" + }, + "tools": ["*"] + } + } +} +``` + +For more information on MCP server configuration, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp#writing-a-json-configuration-for-mcp-servers). + +## Managing MCP servers + +You can manage your configured MCP servers using the following `/mcp` commands in {% data variables.copilot.copilot_cli_short %}. + +* **List configured MCP servers:** Use the command `/mcp show`. This displays all configured MCP servers and their current status. + +* **View details about a specific server:** Use the command `/mcp show SERVER-NAME`. This displays the status of the specified server and the list of tools it provides. + +* **Edit a server's configuration:** Use the command `/mcp edit SERVER-NAME`. + +* **Delete a server:** Use the command `/mcp delete SERVER-NAME`. + +* **Disable a server:** Use the command `/mcp disable SERVER-NAME`. A disabled server remains configured but is not used by {% data variables.product.prodname_copilot_short %} for the current session. + +* **Enable a previously disabled server:** Use the command `/mcp enable SERVER-NAME`. + +## Using MCP servers + +Once you have added an MCP server, {% data variables.product.prodname_copilot_short %} can automatically use the tools it provides when relevant to your prompt. You can also directly reference an MCP server and specific tools in a prompt to ensure they are used. + +## Further reading + +* [AUTOTITLE](/copilot/concepts/about-mcp) +* [AUTOTITLE](/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp) +* [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp) diff --git a/content/copilot/how-tos/copilot-cli/customize-copilot/index.md b/content/copilot/how-tos/copilot-cli/customize-copilot/index.md index afbb56ff5f98..04488fa17204 100644 --- a/content/copilot/how-tos/copilot-cli/customize-copilot/index.md +++ b/content/copilot/how-tos/copilot-cli/customize-copilot/index.md @@ -10,6 +10,7 @@ children: - /add-custom-instructions - /use-hooks - /create-skills + - /add-mcp-servers - /create-custom-agents-for-cli - /plugins-finding-installing - /plugins-creating diff --git a/content/copilot/how-tos/copilot-cli/use-copilot-cli.md b/content/copilot/how-tos/copilot-cli/use-copilot-cli.md index 6b2d9a164d60..a510109336be 100644 --- a/content/copilot/how-tos/copilot-cli/use-copilot-cli.md +++ b/content/copilot/how-tos/copilot-cli/use-copilot-cli.md @@ -270,6 +270,8 @@ To extend the functionality available to you in {% data variables.copilot.copilo Details of your configured MCP servers are stored in the `mcp-config.json` file, which is located, by default, in the `~/.copilot` directory. This location can be changed by setting the `XDG_CONFIG_HOME` environment variable. For information about the JSON structure of a server definition, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp#writing-a-json-configuration-for-mcp-servers). +For more detailed information on adding and managing MCP servers in {% data variables.copilot.copilot_cli_short %}, see [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers). + ### Context management {% data variables.copilot.copilot_cli_short %} provides several slash commands to help you monitor and manage your context window: diff --git a/content/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp.md b/content/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp.md index ab61b4e01d9b..622bc1fdd25c 100644 --- a/content/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp.md +++ b/content/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp.md @@ -323,6 +323,7 @@ For more information on creating and configuring your own MCP servers, see [the ## Further reading +* [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers) * [AUTOTITLE](/copilot/using-github-copilot/coding-agent/extending-copilot-coding-agent-with-mcp) * [AUTOTITLE](/copilot/customizing-copilot/using-model-context-protocol/using-the-github-mcp-server) * [AUTOTITLE](/copilot/tutorials/enhancing-copilot-agent-mode-with-mcp) diff --git a/content/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp.md b/content/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp.md index 1c14f67c3778..7584a92c9699 100644 --- a/content/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp.md +++ b/content/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp.md @@ -339,6 +339,7 @@ For information on using the {% data variables.product.github %} MCP server in o ## Next steps +* [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers) * [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents) * [AUTOTITLE](/copilot/customizing-copilot/customizing-the-development-environment-for-copilot-coding-agent) * [AUTOTITLE](/copilot/customizing-copilot/extending-copilot-chat-with-mcp) From 78c4c409d5bf821ceb8cbb4ad0a3080ca3677d98 Mon Sep 17 00:00:00 2001 From: Ari LiVigni Date: Thu, 26 Feb 2026 07:07:37 -0800 Subject: [PATCH 3/9] Include hands-on practice section in CLI best practices (#59830) Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: Claire W <78226508+crwaters16@users.noreply.github.com> --- content/copilot/how-tos/copilot-cli/cli-best-practices.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/content/copilot/how-tos/copilot-cli/cli-best-practices.md b/content/copilot/how-tos/copilot-cli/cli-best-practices.md index 862bfafad1e7..cca8e55f2fae 100644 --- a/content/copilot/how-tos/copilot-cli/cli-best-practices.md +++ b/content/copilot/how-tos/copilot-cli/cli-best-practices.md @@ -483,6 +483,9 @@ To submit private feedback to {% data variables.product.github %} about {% data /feedback ``` +## Hands-on practice +Try the [Creating applications with {% data variables.copilot.copilot_cli_short %}](https://github.com/skills/create-applications-with-the-copilot-cli) Skills exercise for practical experience building an application with {% data variables.copilot.copilot_cli_short %}. + ## Further reading * [AUTOTITLE](/copilot/concepts/agents/about-copilot-cli) From 586f9e3bbd3e191178607bdda4150a1e5354931a Mon Sep 17 00:00:00 2001 From: "vault-valet[bot]" <157417028+vault-valet[bot]@users.noreply.github.com> Date: Thu, 26 Feb 2026 07:26:50 -0800 Subject: [PATCH 4/9] [Vault-Valet][docs-internal][production] Updating the `secrets` secrets file (#59815) Co-authored-by: vault-valet[bot] <157417028+vault-valet[bot]@users.noreply.github.com> Co-authored-by: Kevin Heis Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- config/moda/secrets/production/secrets.yml | 62 +++++++++++++++++++++- 1 file changed, 60 insertions(+), 2 deletions(-) diff --git a/config/moda/secrets/production/secrets.yml b/config/moda/secrets/production/secrets.yml index ccdb3af5732d..20b7ce0d3c0a 100644 --- a/config/moda/secrets/production/secrets.yml +++ b/config/moda/secrets/production/secrets.yml @@ -1,8 +1,66 @@ ---- secrets: COOKIE_SECRET: kind: latest_at_deployment_start - key: COOKIE_SECRET type: salt owner: '@github/docs-engineering' externally_usable: true + CSE_COPILOT_ENDPOINT: + kind: latest_at_deployment_start + type: salt + owner: '@github/docs-engineering' + externally_usable: true + CSE_COPILOT_SECRET: + kind: latest_at_deployment_start + type: salt + owner: '@github/docs-engineering' + externally_usable: true + DOCS_BOT_PAT_BASE: + kind: latest_at_deployment_start + type: github_pat + owner: '@github/docs-engineering' + externally_usable: true + DOCS_BOT_PAT_COPILOT: + kind: latest_at_deployment_start + type: github_pat + owner: '@github/docs-engineering' + externally_usable: true + DOCS_BOT_PAT_REPO_SYNC: + kind: latest_at_deployment_start + type: github_pat + owner: '@github/docs-engineering' + externally_usable: true + ELASTICSEARCH_URL: + kind: latest_at_deployment_start + type: elasticsearch + owner: '@github/docs-engineering' + externally_usable: true + FASTLY_API_TOKEN: + kind: latest_at_deployment_start + type: fastly + owner: '@github/docs-engineering' + externally_usable: true + FASTLY_SERVICE_ID: + kind: latest_at_deployment_start + type: fastly + owner: '@github/docs-engineering' + externally_usable: true + FASTLY_TOKEN: + kind: latest_at_deployment_start + type: fastly + owner: '@github/docs-engineering' + externally_usable: true + HAYSTACK_URL: + kind: latest_at_deployment_start + type: failbot + owner: '@github/docs-engineering' + externally_usable: true + HYDRO_ENDPOINT: + kind: latest_at_deployment_start + type: hydro_api_key + owner: '@github/docs-engineering' + externally_usable: true + HYDRO_SECRET: + kind: latest_at_deployment_start + type: hydro_api_key + owner: '@github/docs-engineering' + externally_usable: true From 1e31b76bf080823416c43afe54a063d3ecc04fae Mon Sep 17 00:00:00 2001 From: docs-bot <77750099+docs-bot@users.noreply.github.com> Date: Thu, 26 Feb 2026 08:09:19 -0800 Subject: [PATCH 5/9] [Merge on Feb. 26] Update OpenAPI Description (#59829) Co-authored-by: Sam Browning <106113886+sabrowning1@users.noreply.github.com> --- .../copilot-content-exclusion-management.md | 14 + content/rest/copilot/copilot-custom-agents.md | 13 + content/rest/copilot/index.md | 2 + .../fine-grained-pat-permissions.json | 24 + .../data/fpt-2022-11-28/fine-grained-pat.json | 12 + .../server-to-server-permissions.json | 28 + .../fpt-2022-11-28/server-to-server-rest.json | 12 + .../fpt-2022-11-28/user-to-server-rest.json | 12 + .../fine-grained-pat-permissions.json | 24 + .../ghec-2022-11-28/fine-grained-pat.json | 12 + .../server-to-server-permissions.json | 100 + .../server-to-server-rest.json | 48 + .../ghec-2022-11-28/user-to-server-rest.json | 48 + src/github-apps/lib/config.json | 2 +- src/rest/data/fpt-2022-11-28/schema.json | 501 +++- src/rest/data/ghec-2022-11-28/schema.json | 2278 +++++++++++++---- .../data/ghes-3.14-2022-11-28/schema.json | 5 +- .../data/ghes-3.15-2022-11-28/schema.json | 5 +- .../data/ghes-3.16-2022-11-28/schema.json | 12 +- .../data/ghes-3.17-2022-11-28/schema.json | 12 +- .../data/ghes-3.18-2022-11-28/schema.json | 12 +- .../data/ghes-3.19-2022-11-28/schema.json | 12 +- .../data/ghes-3.20-2022-11-28/schema.json | 12 +- src/rest/lib/config.json | 2 +- src/webhooks/lib/config.json | 2 +- 25 files changed, 2625 insertions(+), 579 deletions(-) create mode 100644 content/rest/copilot/copilot-content-exclusion-management.md create mode 100644 content/rest/copilot/copilot-custom-agents.md diff --git a/content/rest/copilot/copilot-content-exclusion-management.md b/content/rest/copilot/copilot-content-exclusion-management.md new file mode 100644 index 000000000000..ad5d3af89d19 --- /dev/null +++ b/content/rest/copilot/copilot-content-exclusion-management.md @@ -0,0 +1,14 @@ +--- +title: REST API endpoints for Copilot content exclusion management +shortTitle: Copilot content exclusion management +intro: 'Use the REST API to manage {% data variables.product.prodname_copilot_short %} content exclusion rules.' +versions: # DO NOT MANUALLY EDIT. CHANGES WILL BE OVERWRITTEN BY A 🤖 + fpt: '*' + ghec: '*' +topics: + - API +autogenerated: rest +allowTitleToDifferFromFilename: true +--- + + diff --git a/content/rest/copilot/copilot-custom-agents.md b/content/rest/copilot/copilot-custom-agents.md new file mode 100644 index 000000000000..94efea67009f --- /dev/null +++ b/content/rest/copilot/copilot-custom-agents.md @@ -0,0 +1,13 @@ +--- +title: REST API endpoints for Copilot custom agents +shortTitle: Copilot custom agents +intro: 'Use the REST API to manage {% data variables.copilot.copilot_custom_agents %} for your enterprise.' +versions: # DO NOT MANUALLY EDIT. CHANGES WILL BE OVERWRITTEN BY A 🤖 + ghec: '*' +topics: + - API +autogenerated: rest +allowTitleToDifferFromFilename: true +--- + + diff --git a/content/rest/copilot/index.md b/content/rest/copilot/index.md index f6629a016cc8..2816bc36e647 100644 --- a/content/rest/copilot/index.md +++ b/content/rest/copilot/index.md @@ -9,6 +9,8 @@ topics: autogenerated: rest allowTitleToDifferFromFilename: true children: + - /copilot-content-exclusion-management + - /copilot-custom-agents - /copilot-metrics - /copilot-usage-metrics - /copilot-user-management diff --git a/src/github-apps/data/fpt-2022-11-28/fine-grained-pat-permissions.json b/src/github-apps/data/fpt-2022-11-28/fine-grained-pat-permissions.json index dad471038bb0..4dbaa9b35236 100644 --- a/src/github-apps/data/fpt-2022-11-28/fine-grained-pat-permissions.json +++ b/src/github-apps/data/fpt-2022-11-28/fine-grained-pat-permissions.json @@ -1049,6 +1049,30 @@ } ] }, + "org_copilot_content_exclusion": { + "title": "Copilot content exclusion", + "displayTitle": "Organization permissions for \"Copilot content exclusion\"", + "permissions": [ + { + "category": "copilot", + "slug": "get-copilot-content-exclusion-rules-for-an-organization", + "subcategory": "copilot-content-exclusion-management", + "verb": "get", + "requestPath": "/orgs/{org}/copilot/content_exclusion", + "additional-permissions": false, + "access": "read" + }, + { + "category": "copilot", + "slug": "set-copilot-content-exclusion-rules-for-an-organization", + "subcategory": "copilot-content-exclusion-management", + "verb": "put", + "requestPath": "/orgs/{org}/copilot/content_exclusion", + "additional-permissions": false, + "access": "write" + } + ] + }, "organization_custom_org_roles": { "title": "Custom organization roles", "displayTitle": "Organization permissions for \"Custom organization roles\"", diff --git a/src/github-apps/data/fpt-2022-11-28/fine-grained-pat.json b/src/github-apps/data/fpt-2022-11-28/fine-grained-pat.json index ad360ed06e39..554eaa68ca40 100644 --- a/src/github-apps/data/fpt-2022-11-28/fine-grained-pat.json +++ b/src/github-apps/data/fpt-2022-11-28/fine-grained-pat.json @@ -2150,6 +2150,18 @@ "verb": "delete", "requestPath": "/orgs/{org}/copilot/billing/selected_users" }, + { + "slug": "get-copilot-content-exclusion-rules-for-an-organization", + "subcategory": "copilot-content-exclusion-management", + "verb": "get", + "requestPath": "/orgs/{org}/copilot/content_exclusion" + }, + { + "slug": "set-copilot-content-exclusion-rules-for-an-organization", + "subcategory": "copilot-content-exclusion-management", + "verb": "put", + "requestPath": "/orgs/{org}/copilot/content_exclusion" + }, { "slug": "get-copilot-metrics-for-an-organization", "subcategory": "copilot-metrics", diff --git a/src/github-apps/data/fpt-2022-11-28/server-to-server-permissions.json b/src/github-apps/data/fpt-2022-11-28/server-to-server-permissions.json index 05de203d8faf..d3e6f0b1d26b 100644 --- a/src/github-apps/data/fpt-2022-11-28/server-to-server-permissions.json +++ b/src/github-apps/data/fpt-2022-11-28/server-to-server-permissions.json @@ -1470,6 +1470,34 @@ } ] }, + "org_copilot_content_exclusion": { + "title": "Copilot content exclusion", + "displayTitle": "Organization permissions for \"Copilot content exclusion\"", + "permissions": [ + { + "category": "copilot", + "slug": "get-copilot-content-exclusion-rules-for-an-organization", + "subcategory": "copilot-content-exclusion-management", + "verb": "get", + "requestPath": "/orgs/{org}/copilot/content_exclusion", + "access": "read", + "user-to-server": true, + "server-to-server": true, + "additional-permissions": false + }, + { + "category": "copilot", + "slug": "set-copilot-content-exclusion-rules-for-an-organization", + "subcategory": "copilot-content-exclusion-management", + "verb": "put", + "requestPath": "/orgs/{org}/copilot/content_exclusion", + "access": "write", + "user-to-server": true, + "server-to-server": true, + "additional-permissions": false + } + ] + }, "organization_custom_org_roles": { "title": "Custom organization roles", "displayTitle": "Organization permissions for \"Custom organization roles\"", diff --git a/src/github-apps/data/fpt-2022-11-28/server-to-server-rest.json b/src/github-apps/data/fpt-2022-11-28/server-to-server-rest.json index 1c4433edc563..0077792c9f48 100644 --- a/src/github-apps/data/fpt-2022-11-28/server-to-server-rest.json +++ b/src/github-apps/data/fpt-2022-11-28/server-to-server-rest.json @@ -2120,6 +2120,18 @@ "verb": "delete", "requestPath": "/orgs/{org}/copilot/billing/selected_users" }, + { + "slug": "get-copilot-content-exclusion-rules-for-an-organization", + "subcategory": "copilot-content-exclusion-management", + "verb": "get", + "requestPath": "/orgs/{org}/copilot/content_exclusion" + }, + { + "slug": "set-copilot-content-exclusion-rules-for-an-organization", + "subcategory": "copilot-content-exclusion-management", + "verb": "put", + "requestPath": "/orgs/{org}/copilot/content_exclusion" + }, { "slug": "get-copilot-metrics-for-an-organization", "subcategory": "copilot-metrics", diff --git a/src/github-apps/data/fpt-2022-11-28/user-to-server-rest.json b/src/github-apps/data/fpt-2022-11-28/user-to-server-rest.json index 1ad695905991..eaeab1189f92 100644 --- a/src/github-apps/data/fpt-2022-11-28/user-to-server-rest.json +++ b/src/github-apps/data/fpt-2022-11-28/user-to-server-rest.json @@ -2386,6 +2386,18 @@ "verb": "delete", "requestPath": "/orgs/{org}/copilot/billing/selected_users" }, + { + "slug": "get-copilot-content-exclusion-rules-for-an-organization", + "subcategory": "copilot-content-exclusion-management", + "verb": "get", + "requestPath": "/orgs/{org}/copilot/content_exclusion" + }, + { + "slug": "set-copilot-content-exclusion-rules-for-an-organization", + "subcategory": "copilot-content-exclusion-management", + "verb": "put", + "requestPath": "/orgs/{org}/copilot/content_exclusion" + }, { "slug": "get-copilot-metrics-for-an-organization", "subcategory": "copilot-metrics", diff --git a/src/github-apps/data/ghec-2022-11-28/fine-grained-pat-permissions.json b/src/github-apps/data/ghec-2022-11-28/fine-grained-pat-permissions.json index 620df02ffe35..9edc25fbf1b2 100644 --- a/src/github-apps/data/ghec-2022-11-28/fine-grained-pat-permissions.json +++ b/src/github-apps/data/ghec-2022-11-28/fine-grained-pat-permissions.json @@ -1085,6 +1085,30 @@ } ] }, + "org_copilot_content_exclusion": { + "title": "Copilot content exclusion", + "displayTitle": "Organization permissions for \"Copilot content exclusion\"", + "permissions": [ + { + "category": "copilot", + "slug": "get-copilot-content-exclusion-rules-for-an-organization", + "subcategory": "copilot-content-exclusion-management", + "verb": "get", + "requestPath": "/orgs/{org}/copilot/content_exclusion", + "additional-permissions": false, + "access": "read" + }, + { + "category": "copilot", + "slug": "set-copilot-content-exclusion-rules-for-an-organization", + "subcategory": "copilot-content-exclusion-management", + "verb": "put", + "requestPath": "/orgs/{org}/copilot/content_exclusion", + "additional-permissions": false, + "access": "write" + } + ] + }, "organization_custom_org_roles": { "title": "Custom organization roles", "displayTitle": "Organization permissions for \"Custom organization roles\"", diff --git a/src/github-apps/data/ghec-2022-11-28/fine-grained-pat.json b/src/github-apps/data/ghec-2022-11-28/fine-grained-pat.json index f3aa0cfbf3bf..097807823737 100644 --- a/src/github-apps/data/ghec-2022-11-28/fine-grained-pat.json +++ b/src/github-apps/data/ghec-2022-11-28/fine-grained-pat.json @@ -2158,6 +2158,18 @@ "verb": "delete", "requestPath": "/orgs/{org}/copilot/billing/selected_users" }, + { + "slug": "get-copilot-content-exclusion-rules-for-an-organization", + "subcategory": "copilot-content-exclusion-management", + "verb": "get", + "requestPath": "/orgs/{org}/copilot/content_exclusion" + }, + { + "slug": "set-copilot-content-exclusion-rules-for-an-organization", + "subcategory": "copilot-content-exclusion-management", + "verb": "put", + "requestPath": "/orgs/{org}/copilot/content_exclusion" + }, { "slug": "get-copilot-metrics-for-an-organization", "subcategory": "copilot-metrics", diff --git a/src/github-apps/data/ghec-2022-11-28/server-to-server-permissions.json b/src/github-apps/data/ghec-2022-11-28/server-to-server-permissions.json index 47375ea90f4d..4a2553ed6bc0 100644 --- a/src/github-apps/data/ghec-2022-11-28/server-to-server-permissions.json +++ b/src/github-apps/data/ghec-2022-11-28/server-to-server-permissions.json @@ -187,6 +187,78 @@ } ] }, + "enterprise_ai_controls": { + "title": "Enterprise AI controls", + "displayTitle": "Enterprise permissions for \"Enterprise AI controls\"", + "permissions": [ + { + "category": "copilot", + "slug": "get-copilot-content-exclusion-rules-for-an-enterprise", + "subcategory": "copilot-content-exclusion-management", + "verb": "get", + "requestPath": "/enterprises/{enterprise}/copilot/content_exclusion", + "access": "read", + "user-to-server": true, + "server-to-server": true, + "additional-permissions": false + }, + { + "category": "copilot", + "slug": "set-copilot-content-exclusion-rules-for-an-enterprise", + "subcategory": "copilot-content-exclusion-management", + "verb": "put", + "requestPath": "/enterprises/{enterprise}/copilot/content_exclusion", + "access": "write", + "user-to-server": true, + "server-to-server": true, + "additional-permissions": false + }, + { + "category": "copilot", + "slug": "get-custom-agents-for-an-enterprise", + "subcategory": "copilot-custom-agents", + "verb": "get", + "requestPath": "/enterprises/{enterprise}/copilot/custom-agents", + "access": "read", + "user-to-server": true, + "server-to-server": true, + "additional-permissions": false + }, + { + "category": "copilot", + "slug": "get-the-source-organization-for-custom-agents-in-an-enterprise", + "subcategory": "copilot-custom-agents", + "verb": "get", + "requestPath": "/enterprises/{enterprise}/copilot/custom-agents/source", + "access": "read", + "user-to-server": true, + "server-to-server": true, + "additional-permissions": false + }, + { + "category": "copilot", + "slug": "set-the-source-organization-for-custom-agents-in-an-enterprise", + "subcategory": "copilot-custom-agents", + "verb": "put", + "requestPath": "/enterprises/{enterprise}/copilot/custom-agents/source", + "access": "write", + "user-to-server": true, + "server-to-server": true, + "additional-permissions": false + }, + { + "category": "copilot", + "slug": "delete-the-custom-agents-source-for-an-enterprise", + "subcategory": "copilot-custom-agents", + "verb": "delete", + "requestPath": "/enterprises/{enterprise}/copilot/custom-agents/source", + "access": "write", + "user-to-server": true, + "server-to-server": true, + "additional-permissions": false + } + ] + }, "enterprise_copilot_metrics": { "title": "Enterprise Copilot metrics", "displayTitle": "Enterprise permissions for \"Enterprise Copilot metrics\"", @@ -2150,6 +2222,34 @@ } ] }, + "org_copilot_content_exclusion": { + "title": "Copilot content exclusion", + "displayTitle": "Organization permissions for \"Copilot content exclusion\"", + "permissions": [ + { + "category": "copilot", + "slug": "get-copilot-content-exclusion-rules-for-an-organization", + "subcategory": "copilot-content-exclusion-management", + "verb": "get", + "requestPath": "/orgs/{org}/copilot/content_exclusion", + "access": "read", + "user-to-server": true, + "server-to-server": true, + "additional-permissions": false + }, + { + "category": "copilot", + "slug": "set-copilot-content-exclusion-rules-for-an-organization", + "subcategory": "copilot-content-exclusion-management", + "verb": "put", + "requestPath": "/orgs/{org}/copilot/content_exclusion", + "access": "write", + "user-to-server": true, + "server-to-server": true, + "additional-permissions": false + } + ] + }, "organization_custom_org_roles": { "title": "Custom organization roles", "displayTitle": "Organization permissions for \"Custom organization roles\"", diff --git a/src/github-apps/data/ghec-2022-11-28/server-to-server-rest.json b/src/github-apps/data/ghec-2022-11-28/server-to-server-rest.json index a057062e3a7a..11a6a08603ae 100644 --- a/src/github-apps/data/ghec-2022-11-28/server-to-server-rest.json +++ b/src/github-apps/data/ghec-2022-11-28/server-to-server-rest.json @@ -2122,6 +2122,42 @@ } ], "copilot": [ + { + "slug": "get-copilot-content-exclusion-rules-for-an-enterprise", + "subcategory": "copilot-content-exclusion-management", + "verb": "get", + "requestPath": "/enterprises/{enterprise}/copilot/content_exclusion" + }, + { + "slug": "set-copilot-content-exclusion-rules-for-an-enterprise", + "subcategory": "copilot-content-exclusion-management", + "verb": "put", + "requestPath": "/enterprises/{enterprise}/copilot/content_exclusion" + }, + { + "slug": "get-custom-agents-for-an-enterprise", + "subcategory": "copilot-custom-agents", + "verb": "get", + "requestPath": "/enterprises/{enterprise}/copilot/custom-agents" + }, + { + "slug": "get-the-source-organization-for-custom-agents-in-an-enterprise", + "subcategory": "copilot-custom-agents", + "verb": "get", + "requestPath": "/enterprises/{enterprise}/copilot/custom-agents/source" + }, + { + "slug": "set-the-source-organization-for-custom-agents-in-an-enterprise", + "subcategory": "copilot-custom-agents", + "verb": "put", + "requestPath": "/enterprises/{enterprise}/copilot/custom-agents/source" + }, + { + "slug": "delete-the-custom-agents-source-for-an-enterprise", + "subcategory": "copilot-custom-agents", + "verb": "delete", + "requestPath": "/enterprises/{enterprise}/copilot/custom-agents/source" + }, { "slug": "get-copilot-enterprise-usage-metrics-for-a-specific-day", "subcategory": "copilot-usage-metrics", @@ -2182,6 +2218,18 @@ "verb": "delete", "requestPath": "/orgs/{org}/copilot/billing/selected_users" }, + { + "slug": "get-copilot-content-exclusion-rules-for-an-organization", + "subcategory": "copilot-content-exclusion-management", + "verb": "get", + "requestPath": "/orgs/{org}/copilot/content_exclusion" + }, + { + "slug": "set-copilot-content-exclusion-rules-for-an-organization", + "subcategory": "copilot-content-exclusion-management", + "verb": "put", + "requestPath": "/orgs/{org}/copilot/content_exclusion" + }, { "slug": "get-copilot-metrics-for-an-organization", "subcategory": "copilot-metrics", diff --git a/src/github-apps/data/ghec-2022-11-28/user-to-server-rest.json b/src/github-apps/data/ghec-2022-11-28/user-to-server-rest.json index 5ced6190c6ad..ee0659b9658c 100644 --- a/src/github-apps/data/ghec-2022-11-28/user-to-server-rest.json +++ b/src/github-apps/data/ghec-2022-11-28/user-to-server-rest.json @@ -2370,6 +2370,42 @@ } ], "copilot": [ + { + "slug": "get-copilot-content-exclusion-rules-for-an-enterprise", + "subcategory": "copilot-content-exclusion-management", + "verb": "get", + "requestPath": "/enterprises/{enterprise}/copilot/content_exclusion" + }, + { + "slug": "set-copilot-content-exclusion-rules-for-an-enterprise", + "subcategory": "copilot-content-exclusion-management", + "verb": "put", + "requestPath": "/enterprises/{enterprise}/copilot/content_exclusion" + }, + { + "slug": "get-custom-agents-for-an-enterprise", + "subcategory": "copilot-custom-agents", + "verb": "get", + "requestPath": "/enterprises/{enterprise}/copilot/custom-agents" + }, + { + "slug": "get-the-source-organization-for-custom-agents-in-an-enterprise", + "subcategory": "copilot-custom-agents", + "verb": "get", + "requestPath": "/enterprises/{enterprise}/copilot/custom-agents/source" + }, + { + "slug": "set-the-source-organization-for-custom-agents-in-an-enterprise", + "subcategory": "copilot-custom-agents", + "verb": "put", + "requestPath": "/enterprises/{enterprise}/copilot/custom-agents/source" + }, + { + "slug": "delete-the-custom-agents-source-for-an-enterprise", + "subcategory": "copilot-custom-agents", + "verb": "delete", + "requestPath": "/enterprises/{enterprise}/copilot/custom-agents/source" + }, { "slug": "get-copilot-enterprise-usage-metrics-for-a-specific-day", "subcategory": "copilot-usage-metrics", @@ -2430,6 +2466,18 @@ "verb": "delete", "requestPath": "/orgs/{org}/copilot/billing/selected_users" }, + { + "slug": "get-copilot-content-exclusion-rules-for-an-organization", + "subcategory": "copilot-content-exclusion-management", + "verb": "get", + "requestPath": "/orgs/{org}/copilot/content_exclusion" + }, + { + "slug": "set-copilot-content-exclusion-rules-for-an-organization", + "subcategory": "copilot-content-exclusion-management", + "verb": "put", + "requestPath": "/orgs/{org}/copilot/content_exclusion" + }, { "slug": "get-copilot-metrics-for-an-organization", "subcategory": "copilot-metrics", diff --git a/src/github-apps/lib/config.json b/src/github-apps/lib/config.json index 4470102afcf8..59f6cee1c5b7 100644 --- a/src/github-apps/lib/config.json +++ b/src/github-apps/lib/config.json @@ -60,5 +60,5 @@ "2022-11-28" ] }, - "sha": "951b2951cf3bed81c9e881f8f470cfda20350d34" + "sha": "884c183f5163e1155700894ac68dd891e8668fd5" } \ No newline at end of file diff --git a/src/rest/data/fpt-2022-11-28/schema.json b/src/rest/data/fpt-2022-11-28/schema.json index 3bb4d41d8a4c..6b219e0a1f17 100644 --- a/src/rest/data/fpt-2022-11-28/schema.json +++ b/src/rest/data/fpt-2022-11-28/schema.json @@ -264876,6 +264876,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -265201,6 +265210,18 @@ ], "default": "disabled" }, + { + "type": "string", + "name": "secret_scanning_extended_metadata", + "in": "body", + "description": "

The enablement status of secret scanning extended metadata

", + "enum": [ + "enabled", + "disabled", + "not_set" + ], + "default": "disabled" + }, { "type": "string", "name": "private_vulnerability_reporting", @@ -265533,6 +265554,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -265984,6 +266014,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -266369,6 +266408,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -266693,6 +266741,18 @@ ], "default": "disabled" }, + { + "type": "string", + "name": "secret_scanning_extended_metadata", + "in": "body", + "description": "

The enablement status of secret scanning extended metadata

", + "enum": [ + "enabled", + "disabled", + "not_set" + ], + "default": "disabled" + }, { "type": "string", "name": "private_vulnerability_reporting", @@ -267021,6 +267081,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -267630,6 +267699,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -268851,6 +268929,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -269234,6 +269321,17 @@ "not_set" ] }, + { + "type": "string", + "name": "secret_scanning_extended_metadata", + "in": "body", + "description": "

The enablement status of secret scanning extended metadata

", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, { "type": "string", "name": "private_vulnerability_reporting", @@ -269573,6 +269671,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -270016,6 +270123,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -270508,6 +270624,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -270887,6 +271012,17 @@ "not_set" ] }, + { + "type": "string", + "name": "secret_scanning_extended_metadata", + "in": "body", + "description": "

The enablement status of secret scanning extended metadata

", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, { "type": "string", "name": "private_vulnerability_reporting", @@ -271222,6 +271358,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -271832,6 +271977,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -273010,6 +273164,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -335628,6 +335791,192 @@ ] }, "copilot": { + "copilot-content-exclusion-management": [ + { + "serverUrl": "https://api.github.com", + "verb": "get", + "requestPath": "/orgs/{org}/copilot/content_exclusion", + "title": "Get Copilot content exclusion rules for an organization", + "category": "copilot", + "subcategory": "copilot-content-exclusion-management", + "parameters": [ + { + "name": "org", + "description": "

The organization name. The name is not case sensitive.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "bodyParameters": [], + "descriptionHTML": "

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Gets information about an organization's Copilot content exclusion path rules.\nTo configure these settings, go to the organization's settings on GitHub.\nFor more information, see \"Excluding content from GitHub Copilot.\"

\n

Organization owners can view details about Copilot content exclusion rules for the organization.

\n

OAuth app tokens and personal access tokens (classic) need either the copilot or read:org scopes to use this endpoint.

\n

Caution

\n

\n
    \n
  • At this time, the API does not support comments. This endpoint will not return any comments in the existing rules.
    • \n
  • At this time, the API does not support duplicate keys. If your content exclusion configuration contains duplicate keys, the API will return only the last occurrence of that key. For example, if duplicate entries are present, only the final value will be included in the response.
    • \n
\n
", + "codeExamples": [ + { + "key": "default", + "request": { + "description": "Example", + "acceptHeader": "application/vnd.github.v3+json", + "parameters": { + "org": "ORG" + } + }, + "response": { + "statusCode": "200", + "contentType": "application/json", + "description": "

OK

", + "example": { + "octo-repo": [ + "/src/some-dir/kernel.rs" + ] + }, + "schema": { + "title": "Copilot Organization Content Exclusion Details", + "description": "List all Copilot Content Exclusion rules for an organization.", + "type": "object", + "additionalProperties": { + "type": "array", + "items": { + "type": "string", + "description": "The path to the file that will be excluded." + } + } + } + } + } + ], + "statusCodes": [ + { + "httpStatusCode": "200", + "description": "

OK

" + }, + { + "httpStatusCode": "401", + "description": "

Requires authentication

" + }, + { + "httpStatusCode": "403", + "description": "

Forbidden

" + }, + { + "httpStatusCode": "404", + "description": "

Resource not found

" + }, + { + "httpStatusCode": "500", + "description": "

Internal Error

" + } + ], + "previews": [], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": true, + "permissions": [ + { + "\"Copilot content exclusion\" organization permissions": "read" + } + ] + } + }, + { + "serverUrl": "https://api.github.com", + "verb": "put", + "requestPath": "/orgs/{org}/copilot/content_exclusion", + "title": "Set Copilot content exclusion rules for an organization", + "category": "copilot", + "subcategory": "copilot-content-exclusion-management", + "parameters": [ + { + "name": "org", + "description": "

The organization name. The name is not case sensitive.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "bodyParameters": [], + "descriptionHTML": "

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Sets Copilot content exclusion path rules for an organization.\nTo configure these settings, go to the organization's settings on GitHub.\nFor more information, see \"Excluding content from GitHub Copilot.\"

\n

Organization owners can set Copilot content exclusion rules for the organization.

\n

OAuth app tokens and personal access tokens (classic) need the copilot scope to use this endpoint.

\n

Caution

\n

\n
    \n
  • At this time, the API does not support comments. When using this endpoint, any existing comments in your rules will be deleted.
    • \n
  • At this time, the API does not support duplicate keys. If you submit content exclusions through the API with duplicate keys, only the last occurrence will be saved. Earlier entries with the same key will be overwritten.
    • \n
\n
", + "codeExamples": [ + { + "key": "default", + "request": { + "contentType": "application/json", + "description": "Example of content exclusion paths", + "acceptHeader": "application/vnd.github.v3+json", + "bodyParameters": { + "octo-repo": [ + "/src/some-dir/kernel.rs" + ] + }, + "parameters": { + "org": "ORG" + } + }, + "response": { + "statusCode": "200", + "contentType": "application/json", + "description": "

Success

", + "example": { + "message": "Content exclusion rules updated successfully." + }, + "schema": { + "type": "object", + "properties": { + "message": { + "type": "string" + } + } + } + } + } + ], + "statusCodes": [ + { + "httpStatusCode": "200", + "description": "

Success

" + }, + { + "httpStatusCode": "401", + "description": "

Requires authentication

" + }, + { + "httpStatusCode": "403", + "description": "

Forbidden

" + }, + { + "httpStatusCode": "404", + "description": "

Resource not found

" + }, + { + "httpStatusCode": "413", + "description": "

Payload Too Large

" + }, + { + "httpStatusCode": "422", + "description": "

Validation failed, or the endpoint has been spammed.

" + }, + { + "httpStatusCode": "500", + "description": "

Internal Error

" + } + ], + "previews": [], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": true, + "permissions": [ + { + "\"Copilot content exclusion\" organization permissions": "write" + } + ] + } + } + ], "copilot-metrics": [ { "serverUrl": "https://api.github.com", @@ -339284,6 +339633,14 @@ ] } }, + { + "name": "assignee", + "in": "query", + "description": "

Filter alerts by assignees.\nProvide a comma-separated list of user handles (e.g., octocat or octocat,hubot) to return alerts assigned to any of the specified users.\nUse * to list alerts with at least one assignee or none to list alerts with no assignees.

", + "schema": { + "type": "string" + } + }, { "name": "scope", "in": "query", @@ -339506,6 +339863,28 @@ "dismissed_reason": "tolerable_risk", "dismissed_comment": "This alert is accurate but we use a sanitizer.", "fixed_at": null, + "assignees": [ + { + "login": "octocat", + "id": 1, + "node_id": "MDQ6VXNlcjE=", + "avatar_url": "https://github.com/images/error/octocat_happy.gif", + "gravatar_id": "", + "url": "https://api.github.com/users/octocat", + "html_url": "https://github.com/octocat", + "followers_url": "https://api.github.com/users/octocat/followers", + "following_url": "https://api.github.com/users/octocat/following{/other_user}", + "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", + "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", + "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", + "organizations_url": "https://api.github.com/users/octocat/orgs", + "repos_url": "https://api.github.com/users/octocat/repos", + "events_url": "https://api.github.com/users/octocat/events{/privacy}", + "received_events_url": "https://api.github.com/users/octocat/received_events", + "type": "User", + "site_admin": false + } + ], "repository": { "id": 217723378, "node_id": "MDEwOlJlcG9zaXRvcnkyMTc3MjMzNzg=", @@ -339691,6 +340070,7 @@ "dismissed_reason": null, "dismissed_comment": null, "fixed_at": null, + "assignees": [], "repository": { "id": 664700648, "node_id": "MDEwOlJlcG9zaXRvcnk2NjQ3MDA2NDg=", @@ -341432,6 +341812,14 @@ ] } }, + { + "name": "assignee", + "in": "query", + "description": "

Filter alerts by assignees.\nProvide a comma-separated list of user handles (e.g., octocat or octocat,hubot) to return alerts assigned to any of the specified users.\nUse * to list alerts with at least one assignee or none to list alerts with no assignees.

", + "schema": { + "type": "string" + } + }, { "name": "runtime_risk", "in": "query", @@ -341662,6 +342050,28 @@ "dismissed_reason": "tolerable_risk", "dismissed_comment": "This alert is accurate but we use a sanitizer.", "fixed_at": null, + "assignees": [ + { + "login": "octocat", + "id": 1, + "node_id": "MDQ6VXNlcjE=", + "avatar_url": "https://github.com/images/error/octocat_happy.gif", + "gravatar_id": "", + "url": "https://api.github.com/users/octocat", + "html_url": "https://github.com/octocat", + "followers_url": "https://api.github.com/users/octocat/followers", + "following_url": "https://api.github.com/users/octocat/following{/other_user}", + "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", + "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", + "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", + "organizations_url": "https://api.github.com/users/octocat/orgs", + "repos_url": "https://api.github.com/users/octocat/repos", + "events_url": "https://api.github.com/users/octocat/events{/privacy}", + "received_events_url": "https://api.github.com/users/octocat/received_events", + "type": "User", + "site_admin": false + } + ], "repository": { "id": 217723378, "node_id": "MDEwOlJlcG9zaXRvcnkyMTc3MjMzNzg=", @@ -341847,6 +342257,7 @@ "dismissed_reason": null, "dismissed_comment": null, "fixed_at": null, + "assignees": [], "repository": { "id": 664700648, "node_id": "MDEwOlJlcG9zaXRvcnk2NjQ3MDA2NDg=", @@ -343596,6 +344007,14 @@ ] } }, + { + "name": "assignee", + "in": "query", + "description": "

Filter alerts by assignees.\nProvide a comma-separated list of user handles (e.g., octocat or octocat,hubot) to return alerts assigned to any of the specified users.\nUse * to list alerts with at least one assignee or none to list alerts with no assignees.

", + "schema": { + "type": "string" + } + }, { "name": "scope", "in": "query", @@ -343818,7 +344237,29 @@ }, "dismissed_reason": "tolerable_risk", "dismissed_comment": "This alert is accurate but we use a sanitizer.", - "fixed_at": null + "fixed_at": null, + "assignees": [ + { + "login": "octocat", + "id": 1, + "node_id": "MDQ6VXNlcjE=", + "avatar_url": "https://github.com/images/error/octocat_happy.gif", + "gravatar_id": "", + "url": "https://api.github.com/users/octocat", + "html_url": "https://github.com/octocat", + "followers_url": "https://api.github.com/users/octocat/followers", + "following_url": "https://api.github.com/users/octocat/following{/other_user}", + "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", + "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", + "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", + "organizations_url": "https://api.github.com/users/octocat/orgs", + "repos_url": "https://api.github.com/users/octocat/repos", + "events_url": "https://api.github.com/users/octocat/events{/privacy}", + "received_events_url": "https://api.github.com/users/octocat/received_events", + "type": "User", + "site_admin": false + } + ] }, { "number": 1, @@ -343936,7 +344377,8 @@ "dismissed_by": null, "dismissed_reason": null, "dismissed_comment": null, - "fixed_at": null + "fixed_at": null, + "assignees": [] } ], "schema": { @@ -345150,7 +345592,29 @@ "dismissed_by": null, "dismissed_reason": null, "dismissed_comment": null, - "fixed_at": null + "fixed_at": null, + "assignees": [ + { + "login": "octocat", + "id": 1, + "node_id": "MDQ6VXNlcjE=", + "avatar_url": "https://github.com/images/error/octocat_happy.gif", + "gravatar_id": "", + "url": "https://api.github.com/users/octocat", + "html_url": "https://github.com/octocat", + "followers_url": "https://api.github.com/users/octocat/followers", + "following_url": "https://api.github.com/users/octocat/following{/other_user}", + "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", + "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", + "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", + "organizations_url": "https://api.github.com/users/octocat/orgs", + "repos_url": "https://api.github.com/users/octocat/repos", + "events_url": "https://api.github.com/users/octocat/events{/privacy}", + "received_events_url": "https://api.github.com/users/octocat/received_events", + "type": "User", + "site_admin": false + } + ] }, "schema": { "type": "object", @@ -346402,7 +346866,8 @@ }, "dismissed_reason": "tolerable_risk", "dismissed_comment": "This alert is accurate but we use a sanitizer.", - "fixed_at": null + "fixed_at": null, + "assignees": [] }, "schema": { "type": "object", @@ -348750,7 +349215,7 @@ "type": "array", "name": "selected_repository_ids", "in": "body", - "description": "

An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can manage the list of selected repositories using the List selected repositories for an organization secret, Set selected repositories for an organization secret, and Remove selected repository from an organization secret endpoints. Use integers when possible, as strings are supported only to maintain backwards compatibility and may be removed in the future.

" + "description": "

An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can manage the list of selected repositories using the List selected repositories for an organization secret, Set selected repositories for an organization secret, and Remove selected repository from an organization secret endpoints.

" } ], "descriptionHTML": "

Creates or updates an organization secret with an encrypted value. Encrypt your secret using\nLibSodium. For more information, see \"Encrypting secrets for the REST API.\"

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

", @@ -542067,7 +542532,7 @@ "schema": { "type": "string", "minLength": 1, - "maxLength": 64, + "maxLength": 128, "pattern": "^[a-zA-Z0-9._-]+$" } } @@ -562597,6 +563062,10 @@ "httpStatusCode": "404", "description": "

Resource not found

" }, + { + "httpStatusCode": "422", + "description": "

Validation failed, or the endpoint has been spammed.

" + }, { "httpStatusCode": "500", "description": "

Internal Error

" @@ -566614,6 +567083,10 @@ "httpStatusCode": "404", "description": "

Resource not found

" }, + { + "httpStatusCode": "422", + "description": "

Validation failed, or the endpoint has been spammed.

" + }, { "httpStatusCode": "500", "description": "

Internal Error

" @@ -788176,6 +788649,10 @@ "httpStatusCode": "404", "description": "

Resource not found

" }, + { + "httpStatusCode": "422", + "description": "

Validation failed, or the endpoint has been spammed.

" + }, { "httpStatusCode": "500", "description": "

Internal Error

" @@ -792111,6 +792588,10 @@ "httpStatusCode": "404", "description": "

Resource not found

" }, + { + "httpStatusCode": "422", + "description": "

Validation failed, or the endpoint has been spammed.

" + }, { "httpStatusCode": "500", "description": "

Internal Error

" @@ -838932,6 +839413,10 @@ { "httpStatusCode": "204", "description": "

No Content

" + }, + { + "httpStatusCode": "422", + "description": "

Unprocessable entity if you attempt to modify an enterprise team at the organization level.

" } ], "previews": [], @@ -848185,6 +848670,10 @@ { "httpStatusCode": "200", "description": "

OK

" + }, + { + "httpStatusCode": "422", + "description": "

Unprocessable entity if you attempt to modify an enterprise team at the organization level.

" } ], "previews": [], diff --git a/src/rest/data/ghec-2022-11-28/schema.json b/src/rest/data/ghec-2022-11-28/schema.json index e6019d9cffc3..7573af1b959e 100644 --- a/src/rest/data/ghec-2022-11-28/schema.json +++ b/src/rest/data/ghec-2022-11-28/schema.json @@ -281561,6 +281561,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -281886,6 +281895,18 @@ ], "default": "disabled" }, + { + "type": "string", + "name": "secret_scanning_extended_metadata", + "in": "body", + "description": "

The enablement status of secret scanning extended metadata

", + "enum": [ + "enabled", + "disabled", + "not_set" + ], + "default": "disabled" + }, { "type": "string", "name": "private_vulnerability_reporting", @@ -282218,6 +282239,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -282669,6 +282699,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -283054,6 +283093,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -283378,6 +283426,18 @@ ], "default": "disabled" }, + { + "type": "string", + "name": "secret_scanning_extended_metadata", + "in": "body", + "description": "

The enablement status of secret scanning extended metadata

", + "enum": [ + "enabled", + "disabled", + "not_set" + ], + "default": "disabled" + }, { "type": "string", "name": "private_vulnerability_reporting", @@ -283706,6 +283766,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -284315,6 +284384,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -285536,6 +285614,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -285919,6 +286006,17 @@ "not_set" ] }, + { + "type": "string", + "name": "secret_scanning_extended_metadata", + "in": "body", + "description": "

The enablement status of secret scanning extended metadata

", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, { "type": "string", "name": "private_vulnerability_reporting", @@ -286258,6 +286356,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -286701,6 +286808,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -287193,6 +287309,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -287572,6 +287697,17 @@ "not_set" ] }, + { + "type": "string", + "name": "secret_scanning_extended_metadata", + "in": "body", + "description": "

The enablement status of secret scanning extended metadata

", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, { "type": "string", "name": "private_vulnerability_reporting", @@ -287907,6 +288043,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -288517,6 +288662,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -289695,6 +289849,15 @@ "not_set" ] }, + "secret_scanning_extended_metadata": { + "type": "string", + "description": "The enablement status of secret scanning extended metadata", + "enum": [ + "enabled", + "disabled", + "not_set" + ] + }, "private_vulnerability_reporting": { "type": "string", "description": "The enablement status of private vulnerability reporting", @@ -352589,6 +352752,923 @@ ] }, "copilot": { + "copilot-content-exclusion-management": [ + { + "serverUrl": "https://api.github.com", + "verb": "get", + "requestPath": "/enterprises/{enterprise}/copilot/content_exclusion", + "title": "Get Copilot content exclusion rules for an enterprise", + "category": "copilot", + "subcategory": "copilot-content-exclusion-management", + "parameters": [ + { + "name": "enterprise", + "description": "

The slug version of the enterprise name.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "bodyParameters": [], + "descriptionHTML": "

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Gets information about an enterprise's Copilot content exclusion path rules.\nTo configure these settings, go to the enterprise's settings on GitHub.\nFor more information, see \"Excluding content from GitHub Copilot.\"

\n

Enterprise owners can view details about Copilot content exclusion rules for the enterprise.

\n

OAuth app tokens and personal access tokens (classic) need either the read:enterprise or copilot scopes to use this endpoint.

\n

Caution

\n

\n
    \n
  • At this time, the API does not support comments. This endpoint will not return any comments in the existing rules.
    • \n
  • At this time, the API does not support duplicate keys. If your content exclusion configuration contains duplicate keys, the API will return only the last occurrence of that key. For example, if duplicate entries are present, only the final value will be included in the response.
    • \n
\n
", + "codeExamples": [ + { + "key": "default", + "request": { + "description": "Example", + "acceptHeader": "application/vnd.github.v3+json", + "parameters": { + "enterprise": "ENTERPRISE" + } + }, + "response": { + "statusCode": "200", + "contentType": "application/json", + "description": "

OK

", + "example": { + "git@github.com:*/copilot": [ + "/__tests__/**" + ], + "octo-org/octo-repo": [ + "/src/some-dir/kernel.rs" + ] + }, + "schema": { + "title": "Copilot Enterprise Content Exclusion Details", + "description": "List all Copilot Content Exclusion rules for an enterprise.", + "type": "object", + "additionalProperties": { + "type": "array", + "items": { + "type": "string", + "description": "The path to the file that will be excluded." + } + } + } + } + } + ], + "statusCodes": [ + { + "httpStatusCode": "200", + "description": "

OK

" + }, + { + "httpStatusCode": "401", + "description": "

Requires authentication

" + }, + { + "httpStatusCode": "403", + "description": "

Forbidden

" + }, + { + "httpStatusCode": "404", + "description": "

Resource not found

" + }, + { + "httpStatusCode": "500", + "description": "

Internal Error

" + } + ], + "previews": [], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": false, + "permissions": [ + { + "\"Enterprise AI controls\" enterprise permissions": "read" + } + ], + "disabledForPatV2": true + } + }, + { + "serverUrl": "https://api.github.com", + "verb": "put", + "requestPath": "/enterprises/{enterprise}/copilot/content_exclusion", + "title": "Set Copilot content exclusion rules for an enterprise", + "category": "copilot", + "subcategory": "copilot-content-exclusion-management", + "parameters": [ + { + "name": "enterprise", + "description": "

The slug version of the enterprise name.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "bodyParameters": [], + "descriptionHTML": "

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Sets Copilot content exclusion path rules for an enterprise.\nTo configure these settings, go to the enterprise's settings on GitHub.\nFor more information, see \"Excluding content from GitHub Copilot.\"

\n

Enterprise owners can set Copilot content exclusion rules for the enterprise.

\n

OAuth app tokens and personal access tokens (classic) need either the admin:enterprise or copilot scopes to use this endpoint.

\n

Caution

\n

\n
    \n
  • At this time, the API does not support comments. When using this endpoint, any existing comments in your rules will be deleted.
    • \n
  • At this time, the API does not support duplicate keys. If you submit content exclusions through the API with duplicate keys, only the last occurrence will be saved. Earlier entries with the same key will be overwritten.
    • \n
\n
", + "codeExamples": [ + { + "key": "default", + "request": { + "contentType": "application/json", + "description": "Example of content exclusion paths", + "acceptHeader": "application/vnd.github.v3+json", + "bodyParameters": { + "git@github.com:*/copilot": [ + "/__tests__/**" + ], + "octo-org/octo-repo": [ + "/src/some-dir/kernel.rs" + ] + }, + "parameters": { + "enterprise": "ENTERPRISE" + } + }, + "response": { + "statusCode": "200", + "contentType": "application/json", + "description": "

Success

", + "example": { + "message": "Content exclusion rules updated successfully." + }, + "schema": { + "type": "object", + "properties": { + "message": { + "type": "string" + } + } + } + } + } + ], + "statusCodes": [ + { + "httpStatusCode": "200", + "description": "

Success

" + }, + { + "httpStatusCode": "401", + "description": "

Requires authentication

" + }, + { + "httpStatusCode": "403", + "description": "

Forbidden

" + }, + { + "httpStatusCode": "404", + "description": "

Resource not found

" + }, + { + "httpStatusCode": "413", + "description": "

Payload Too Large

" + }, + { + "httpStatusCode": "422", + "description": "

Validation failed, or the endpoint has been spammed.

" + }, + { + "httpStatusCode": "500", + "description": "

Internal Error

" + } + ], + "previews": [], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": false, + "permissions": [ + { + "\"Enterprise AI controls\" enterprise permissions": "write" + } + ], + "disabledForPatV2": true + } + }, + { + "serverUrl": "https://api.github.com", + "verb": "get", + "requestPath": "/orgs/{org}/copilot/content_exclusion", + "title": "Get Copilot content exclusion rules for an organization", + "category": "copilot", + "subcategory": "copilot-content-exclusion-management", + "parameters": [ + { + "name": "org", + "description": "

The organization name. The name is not case sensitive.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "bodyParameters": [], + "descriptionHTML": "

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Gets information about an organization's Copilot content exclusion path rules.\nTo configure these settings, go to the organization's settings on GitHub.\nFor more information, see \"Excluding content from GitHub Copilot.\"

\n

Organization owners can view details about Copilot content exclusion rules for the organization.

\n

OAuth app tokens and personal access tokens (classic) need either the copilot or read:org scopes to use this endpoint.

\n

Caution

\n

\n
    \n
  • At this time, the API does not support comments. This endpoint will not return any comments in the existing rules.
    • \n
  • At this time, the API does not support duplicate keys. If your content exclusion configuration contains duplicate keys, the API will return only the last occurrence of that key. For example, if duplicate entries are present, only the final value will be included in the response.
    • \n
\n
", + "codeExamples": [ + { + "key": "default", + "request": { + "description": "Example", + "acceptHeader": "application/vnd.github.v3+json", + "parameters": { + "org": "ORG" + } + }, + "response": { + "statusCode": "200", + "contentType": "application/json", + "description": "

OK

", + "example": { + "octo-repo": [ + "/src/some-dir/kernel.rs" + ] + }, + "schema": { + "title": "Copilot Organization Content Exclusion Details", + "description": "List all Copilot Content Exclusion rules for an organization.", + "type": "object", + "additionalProperties": { + "type": "array", + "items": { + "type": "string", + "description": "The path to the file that will be excluded." + } + } + } + } + } + ], + "statusCodes": [ + { + "httpStatusCode": "200", + "description": "

OK

" + }, + { + "httpStatusCode": "401", + "description": "

Requires authentication

" + }, + { + "httpStatusCode": "403", + "description": "

Forbidden

" + }, + { + "httpStatusCode": "404", + "description": "

Resource not found

" + }, + { + "httpStatusCode": "500", + "description": "

Internal Error

" + } + ], + "previews": [], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": true, + "permissions": [ + { + "\"Copilot content exclusion\" organization permissions": "read" + } + ] + } + }, + { + "serverUrl": "https://api.github.com", + "verb": "put", + "requestPath": "/orgs/{org}/copilot/content_exclusion", + "title": "Set Copilot content exclusion rules for an organization", + "category": "copilot", + "subcategory": "copilot-content-exclusion-management", + "parameters": [ + { + "name": "org", + "description": "

The organization name. The name is not case sensitive.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "bodyParameters": [], + "descriptionHTML": "

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Sets Copilot content exclusion path rules for an organization.\nTo configure these settings, go to the organization's settings on GitHub.\nFor more information, see \"Excluding content from GitHub Copilot.\"

\n

Organization owners can set Copilot content exclusion rules for the organization.

\n

OAuth app tokens and personal access tokens (classic) need the copilot scope to use this endpoint.

\n

Caution

\n

\n
    \n
  • At this time, the API does not support comments. When using this endpoint, any existing comments in your rules will be deleted.
    • \n
  • At this time, the API does not support duplicate keys. If you submit content exclusions through the API with duplicate keys, only the last occurrence will be saved. Earlier entries with the same key will be overwritten.
    • \n
\n
", + "codeExamples": [ + { + "key": "default", + "request": { + "contentType": "application/json", + "description": "Example of content exclusion paths", + "acceptHeader": "application/vnd.github.v3+json", + "bodyParameters": { + "octo-repo": [ + "/src/some-dir/kernel.rs" + ] + }, + "parameters": { + "org": "ORG" + } + }, + "response": { + "statusCode": "200", + "contentType": "application/json", + "description": "

Success

", + "example": { + "message": "Content exclusion rules updated successfully." + }, + "schema": { + "type": "object", + "properties": { + "message": { + "type": "string" + } + } + } + } + } + ], + "statusCodes": [ + { + "httpStatusCode": "200", + "description": "

Success

" + }, + { + "httpStatusCode": "401", + "description": "

Requires authentication

" + }, + { + "httpStatusCode": "403", + "description": "

Forbidden

" + }, + { + "httpStatusCode": "404", + "description": "

Resource not found

" + }, + { + "httpStatusCode": "413", + "description": "

Payload Too Large

" + }, + { + "httpStatusCode": "422", + "description": "

Validation failed, or the endpoint has been spammed.

" + }, + { + "httpStatusCode": "500", + "description": "

Internal Error

" + } + ], + "previews": [], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": true, + "permissions": [ + { + "\"Copilot content exclusion\" organization permissions": "write" + } + ] + } + } + ], + "copilot-custom-agents": [ + { + "serverUrl": "https://api.github.com", + "verb": "get", + "requestPath": "/enterprises/{enterprise}/copilot/custom-agents", + "title": "Get custom agents for an enterprise", + "category": "copilot", + "subcategory": "copilot-custom-agents", + "parameters": [ + { + "name": "enterprise", + "description": "

The slug version of the enterprise name.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "per_page", + "description": "

The number of results per page (max 100). For more information, see \"Using pagination in the REST API.\"

", + "in": "query", + "schema": { + "type": "integer", + "default": 30 + } + }, + { + "name": "page", + "description": "

The page number of the results to fetch. For more information, see \"Using pagination in the REST API.\"

", + "in": "query", + "schema": { + "type": "integer", + "default": 1 + } + } + ], + "bodyParameters": [], + "descriptionHTML": "

Gets the list of all custom agents defined in the /agents/*.md files in the .github-private repository for the enterprise.

\n

If no source repository has been configured, returns null for custom_agents.

\n

Enterprise owners with read access to AI Controls can use this endpoint.

\n

OAuth app tokens and personal access tokens (classic) need the admin:enterprise scope to use this endpoint.

", + "codeExamples": [ + { + "key": "with_agents", + "request": { + "description": "Example 1: Status Code 200", + "acceptHeader": "application/vnd.github.v3+json", + "parameters": { + "enterprise": "ENTERPRISE" + } + }, + "response": { + "statusCode": "200", + "contentType": "application/json", + "description": "

Response with custom agents

", + "example": { + "custom_agents": [ + { + "name": "Security Reviewer", + "file_path": "agents/security_reviewer.md", + "url": "https://github.com/my-org/.github-private/blob/main/agents/security_reviewer.md" + }, + { + "name": "Code Documenter", + "file_path": "agents/code_documenter.md", + "url": "https://github.com/my-org/.github-private/blob/main/agents/code_documenter.md" + } + ] + }, + "schema": { + "type": "object", + "properties": { + "custom_agents": { + "type": [ + "array", + "null" + ], + "description": "List of custom agents defined in the repository. Returns `null` if no source repository is configured.", + "items": { + "type": "object", + "properties": { + "name": { + "type": "string", + "description": "The display name of the custom agent (derived from filename)." + }, + "file_path": { + "type": "string", + "description": "The path to the agent definition file." + }, + "url": { + "type": "string", + "description": "The URL to view the agent definition file." + } + } + } + } + } + } + } + }, + { + "key": "no_source", + "request": { + "description": "Example 2: Status Code 200", + "acceptHeader": "application/vnd.github.v3+json", + "parameters": { + "enterprise": "ENTERPRISE" + } + }, + "response": { + "statusCode": "200", + "contentType": "application/json", + "description": "

Response when no source repository configured

", + "example": { + "custom_agents": null + }, + "schema": { + "type": "object", + "properties": { + "custom_agents": { + "type": [ + "array", + "null" + ], + "description": "List of custom agents defined in the repository. Returns `null` if no source repository is configured.", + "items": { + "type": "object", + "properties": { + "name": { + "type": "string", + "description": "The display name of the custom agent (derived from filename)." + }, + "file_path": { + "type": "string", + "description": "The path to the agent definition file." + }, + "url": { + "type": "string", + "description": "The URL to view the agent definition file." + } + } + } + } + } + } + } + } + ], + "statusCodes": [ + { + "httpStatusCode": "200", + "description": "

Success

" + }, + { + "httpStatusCode": "401", + "description": "

Requires authentication

" + }, + { + "httpStatusCode": "403", + "description": "

Forbidden

" + }, + { + "httpStatusCode": "404", + "description": "

Not found or source repository not found

" + }, + { + "httpStatusCode": "500", + "description": "

Internal Error

" + } + ], + "previews": [], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": false, + "permissions": [ + { + "\"Enterprise AI controls\" enterprise permissions": "read" + } + ], + "disabledForPatV2": true + } + }, + { + "serverUrl": "https://api.github.com", + "verb": "get", + "requestPath": "/enterprises/{enterprise}/copilot/custom-agents/source", + "title": "Get the source organization for custom agents in an enterprise", + "category": "copilot", + "subcategory": "copilot-custom-agents", + "parameters": [ + { + "name": "enterprise", + "description": "

The slug version of the enterprise name.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "bodyParameters": [], + "descriptionHTML": "

Gets the organization and repository configured as the source for custom agent definitions in an enterprise.

\n

Custom agents are enterprise-defined AI agents stored as markdown files in a special repository.\nAn enterprise admin configures one organization as the \"source\" and that org must have a repo named\n.github-private containing agent definitions in /agents/*.md.

\n

Enterprise owners with read access to AI Controls can use this endpoint.

\n

OAuth app tokens and personal access tokens (classic) need the admin:enterprise scope to use this endpoint.

", + "codeExamples": [ + { + "key": "default", + "request": { + "description": "Example", + "acceptHeader": "application/vnd.github.v3+json", + "parameters": { + "enterprise": "ENTERPRISE" + } + }, + "response": { + "statusCode": "200", + "contentType": "application/json", + "description": "

Response

", + "example": { + "organization": { + "id": 1, + "login": "octocat-org" + }, + "repository": { + "id": 123, + "name": ".github-private", + "full_name": "octocat-org/.github-private" + } + }, + "schema": { + "type": "object", + "required": [ + "organization", + "repository" + ], + "properties": { + "organization": { + "type": [ + "object", + "null" + ], + "required": [ + "id", + "login" + ], + "properties": { + "id": { + "type": "integer", + "description": "Unique identifier of the organization" + }, + "login": { + "type": "string", + "description": "Login of the organization" + } + } + }, + "repository": { + "type": [ + "object", + "null" + ], + "required": [ + "id", + "name", + "full_name" + ], + "properties": { + "id": { + "type": "integer", + "description": "Unique identifier of the repository" + }, + "name": { + "type": "string", + "description": "Name of the repository" + }, + "full_name": { + "type": "string", + "description": "Full name of the repository including owner" + } + } + } + } + } + } + } + ], + "statusCodes": [ + { + "httpStatusCode": "200", + "description": "

OK

" + }, + { + "httpStatusCode": "403", + "description": "

Forbidden

" + }, + { + "httpStatusCode": "404", + "description": "

Resource not found

" + } + ], + "previews": [], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": false, + "permissions": [ + { + "\"Enterprise AI controls\" enterprise permissions": "read" + } + ], + "disabledForPatV2": true + } + }, + { + "serverUrl": "https://api.github.com", + "verb": "put", + "requestPath": "/enterprises/{enterprise}/copilot/custom-agents/source", + "title": "Set the source organization for custom agents in an enterprise", + "category": "copilot", + "subcategory": "copilot-custom-agents", + "parameters": [ + { + "name": "enterprise", + "description": "

The slug version of the enterprise name.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "bodyParameters": [ + { + "type": "integer", + "name": "organization_id", + "in": "body", + "description": "

The ID of the organization to use as the custom agents source.

", + "isRequired": true + }, + { + "type": "boolean", + "name": "create_ruleset", + "in": "body", + "description": "

Whether to create a ruleset to protect agent definition files. Defaults to true.

", + "default": true + } + ], + "descriptionHTML": "

Sets an organization as the source for custom agent definitions in the enterprise.\nThe organization must have a .github-private repository containing agent definitions.

\n

By default, this endpoint also creates an enterprise-level ruleset to protect\nagent definition files (agents/.md and .github/agents/.md). You can opt out\nof ruleset creation by setting create_ruleset to false.

\n

Enterprise owners with write access to AI Controls can use this endpoint.

\n

OAuth app tokens and personal access tokens (classic) need the admin:enterprise scope to use this endpoint.

", + "codeExamples": [ + { + "key": "without_ruleset", + "request": { + "contentType": "application/json", + "description": "Set source organization without creating a ruleset", + "acceptHeader": "application/vnd.github.v3+json", + "bodyParameters": { + "organization_id": 123, + "create_ruleset": false + }, + "parameters": { + "enterprise": "ENTERPRISE" + } + }, + "response": { + "statusCode": "200", + "contentType": "application/json", + "description": "

Response without ruleset

", + "example": { + "organization": { + "id": 123, + "login": "my-org", + "avatar_url": "https://avatars.githubusercontent.com/u/123" + }, + "repository": { + "id": 456, + "name": ".github-private", + "full_name": "my-org/.github-private" + } + }, + "schema": { + "type": "object", + "properties": { + "organization": { + "type": "object", + "properties": { + "id": { + "type": "integer", + "description": "The ID of the organization." + }, + "login": { + "type": "string", + "description": "The login name of the organization." + }, + "avatar_url": { + "type": "string", + "description": "The avatar URL of the organization." + } + } + }, + "repository": { + "type": "object", + "properties": { + "id": { + "type": "integer", + "description": "The ID of the .github-private repository." + }, + "name": { + "type": "string", + "description": "The name of the repository." + }, + "full_name": { + "type": "string", + "description": "The full name of the repository (owner/name)." + } + } + }, + "ruleset": { + "type": "object", + "description": "The created or existing ruleset (if create_ruleset was true).", + "properties": { + "id": { + "type": "integer", + "description": "The ID of the ruleset." + }, + "name": { + "type": "string", + "description": "The name of the ruleset." + }, + "enforcement": { + "type": "string", + "description": "The enforcement level of the ruleset." + } + } + } + } + } + } + } + ], + "statusCodes": [ + { + "httpStatusCode": "200", + "description": "

Success

" + }, + { + "httpStatusCode": "401", + "description": "

Requires authentication

" + }, + { + "httpStatusCode": "403", + "description": "

Forbidden

" + }, + { + "httpStatusCode": "404", + "description": "

Resource not found

" + }, + { + "httpStatusCode": "422", + "description": "

Validation failed

" + }, + { + "httpStatusCode": "500", + "description": "

Internal Error

" + } + ], + "previews": [], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": false, + "permissions": [ + { + "\"Enterprise AI controls\" enterprise permissions": "write" + } + ], + "disabledForPatV2": true + } + }, + { + "serverUrl": "https://api.github.com", + "verb": "delete", + "requestPath": "/enterprises/{enterprise}/copilot/custom-agents/source", + "title": "Delete the custom agents source for an enterprise", + "category": "copilot", + "subcategory": "copilot-custom-agents", + "parameters": [ + { + "name": "enterprise", + "description": "

The slug version of the enterprise name.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "bodyParameters": [], + "descriptionHTML": "

Removes the custom agents source configuration for the enterprise.\nThis effectively disables custom agents for the enterprise by removing\nthe reference to the source organization's .github-private repository.

\n

Note: This does not delete the .github-private repository or any agent\ndefinition files. It only removes the association between the enterprise\nand the source repository.

\n

Enterprise owners with write access to AI Controls can use this endpoint.

\n

OAuth app tokens and personal access tokens (classic) need the admin:enterprise scope to use this endpoint.

", + "codeExamples": [ + { + "key": "default", + "request": { + "description": "Example", + "acceptHeader": "application/vnd.github.v3+json", + "parameters": { + "enterprise": "ENTERPRISE" + } + }, + "response": { + "statusCode": "204", + "description": "

No Content - The custom agents source was successfully removed.

" + } + } + ], + "statusCodes": [ + { + "httpStatusCode": "204", + "description": "

No Content - The custom agents source was successfully removed.

" + }, + { + "httpStatusCode": "403", + "description": "

Forbidden - The user does not have enterprise admin access.

" + }, + { + "httpStatusCode": "404", + "description": "

Not found - Enterprise not found, feature not enabled, or no custom agents source is configured.

" + } + ], + "previews": [], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": false, + "permissions": [ + { + "\"Enterprise AI controls\" enterprise permissions": "write" + } + ], + "disabledForPatV2": true + } + } + ], "copilot-metrics": [ { "serverUrl": "https://api.github.com", @@ -362203,6 +363283,14 @@ ] } }, + { + "name": "assignee", + "in": "query", + "description": "

Filter alerts by assignees.\nProvide a comma-separated list of user handles (e.g., octocat or octocat,hubot) to return alerts assigned to any of the specified users.\nUse * to list alerts with at least one assignee or none to list alerts with no assignees.

", + "schema": { + "type": "string" + } + }, { "name": "scope", "in": "query", @@ -362425,6 +363513,28 @@ "dismissed_reason": "tolerable_risk", "dismissed_comment": "This alert is accurate but we use a sanitizer.", "fixed_at": null, + "assignees": [ + { + "login": "octocat", + "id": 1, + "node_id": "MDQ6VXNlcjE=", + "avatar_url": "https://github.com/images/error/octocat_happy.gif", + "gravatar_id": "", + "url": "https://api.github.com/users/octocat", + "html_url": "https://github.com/octocat", + "followers_url": "https://api.github.com/users/octocat/followers", + "following_url": "https://api.github.com/users/octocat/following{/other_user}", + "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", + "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", + "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", + "organizations_url": "https://api.github.com/users/octocat/orgs", + "repos_url": "https://api.github.com/users/octocat/repos", + "events_url": "https://api.github.com/users/octocat/events{/privacy}", + "received_events_url": "https://api.github.com/users/octocat/received_events", + "type": "User", + "site_admin": false + } + ], "repository": { "id": 217723378, "node_id": "MDEwOlJlcG9zaXRvcnkyMTc3MjMzNzg=", @@ -362610,6 +363720,7 @@ "dismissed_reason": null, "dismissed_comment": null, "fixed_at": null, + "assignees": [], "repository": { "id": 664700648, "node_id": "MDEwOlJlcG9zaXRvcnk2NjQ3MDA2NDg=", @@ -364351,6 +365462,14 @@ ] } }, + { + "name": "assignee", + "in": "query", + "description": "

Filter alerts by assignees.\nProvide a comma-separated list of user handles (e.g., octocat or octocat,hubot) to return alerts assigned to any of the specified users.\nUse * to list alerts with at least one assignee or none to list alerts with no assignees.

", + "schema": { + "type": "string" + } + }, { "name": "runtime_risk", "in": "query", @@ -364581,6 +365700,28 @@ "dismissed_reason": "tolerable_risk", "dismissed_comment": "This alert is accurate but we use a sanitizer.", "fixed_at": null, + "assignees": [ + { + "login": "octocat", + "id": 1, + "node_id": "MDQ6VXNlcjE=", + "avatar_url": "https://github.com/images/error/octocat_happy.gif", + "gravatar_id": "", + "url": "https://api.github.com/users/octocat", + "html_url": "https://github.com/octocat", + "followers_url": "https://api.github.com/users/octocat/followers", + "following_url": "https://api.github.com/users/octocat/following{/other_user}", + "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", + "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", + "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", + "organizations_url": "https://api.github.com/users/octocat/orgs", + "repos_url": "https://api.github.com/users/octocat/repos", + "events_url": "https://api.github.com/users/octocat/events{/privacy}", + "received_events_url": "https://api.github.com/users/octocat/received_events", + "type": "User", + "site_admin": false + } + ], "repository": { "id": 217723378, "node_id": "MDEwOlJlcG9zaXRvcnkyMTc3MjMzNzg=", @@ -364766,6 +365907,7 @@ "dismissed_reason": null, "dismissed_comment": null, "fixed_at": null, + "assignees": [], "repository": { "id": 664700648, "node_id": "MDEwOlJlcG9zaXRvcnk2NjQ3MDA2NDg=", @@ -366515,6 +367657,14 @@ ] } }, + { + "name": "assignee", + "in": "query", + "description": "

Filter alerts by assignees.\nProvide a comma-separated list of user handles (e.g., octocat or octocat,hubot) to return alerts assigned to any of the specified users.\nUse * to list alerts with at least one assignee or none to list alerts with no assignees.

", + "schema": { + "type": "string" + } + }, { "name": "scope", "in": "query", @@ -366737,7 +367887,29 @@ }, "dismissed_reason": "tolerable_risk", "dismissed_comment": "This alert is accurate but we use a sanitizer.", - "fixed_at": null + "fixed_at": null, + "assignees": [ + { + "login": "octocat", + "id": 1, + "node_id": "MDQ6VXNlcjE=", + "avatar_url": "https://github.com/images/error/octocat_happy.gif", + "gravatar_id": "", + "url": "https://api.github.com/users/octocat", + "html_url": "https://github.com/octocat", + "followers_url": "https://api.github.com/users/octocat/followers", + "following_url": "https://api.github.com/users/octocat/following{/other_user}", + "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", + "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", + "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", + "organizations_url": "https://api.github.com/users/octocat/orgs", + "repos_url": "https://api.github.com/users/octocat/repos", + "events_url": "https://api.github.com/users/octocat/events{/privacy}", + "received_events_url": "https://api.github.com/users/octocat/received_events", + "type": "User", + "site_admin": false + } + ] }, { "number": 1, @@ -366855,7 +368027,8 @@ "dismissed_by": null, "dismissed_reason": null, "dismissed_comment": null, - "fixed_at": null + "fixed_at": null, + "assignees": [] } ], "schema": { @@ -368069,7 +369242,29 @@ "dismissed_by": null, "dismissed_reason": null, "dismissed_comment": null, - "fixed_at": null + "fixed_at": null, + "assignees": [ + { + "login": "octocat", + "id": 1, + "node_id": "MDQ6VXNlcjE=", + "avatar_url": "https://github.com/images/error/octocat_happy.gif", + "gravatar_id": "", + "url": "https://api.github.com/users/octocat", + "html_url": "https://github.com/octocat", + "followers_url": "https://api.github.com/users/octocat/followers", + "following_url": "https://api.github.com/users/octocat/following{/other_user}", + "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", + "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", + "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", + "organizations_url": "https://api.github.com/users/octocat/orgs", + "repos_url": "https://api.github.com/users/octocat/repos", + "events_url": "https://api.github.com/users/octocat/events{/privacy}", + "received_events_url": "https://api.github.com/users/octocat/received_events", + "type": "User", + "site_admin": false + } + ] }, "schema": { "type": "object", @@ -369321,7 +370516,8 @@ }, "dismissed_reason": "tolerable_risk", "dismissed_comment": "This alert is accurate but we use a sanitizer.", - "fixed_at": null + "fixed_at": null, + "assignees": [] }, "schema": { "type": "object", @@ -371669,7 +372865,7 @@ "type": "array", "name": "selected_repository_ids", "in": "body", - "description": "

An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can manage the list of selected repositories using the List selected repositories for an organization secret, Set selected repositories for an organization secret, and Remove selected repository from an organization secret endpoints. Use integers when possible, as strings are supported only to maintain backwards compatibility and may be removed in the future.

" + "description": "

An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can manage the list of selected repositories using the List selected repositories for an organization secret, Set selected repositories for an organization secret, and Remove selected repository from an organization secret endpoints.

" } ], "descriptionHTML": "

Creates or updates an organization secret with an encrypted value. Encrypt your secret using\nLibSodium. For more information, see \"Encrypting secrets for the REST API.\"

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

", @@ -590093,7 +591289,7 @@ "schema": { "type": "string", "minLength": 1, - "maxLength": 64, + "maxLength": 128, "pattern": "^[a-zA-Z0-9._-]+$" } } @@ -615338,6 +616534,10 @@ "httpStatusCode": "404", "description": "

Resource not found

" }, + { + "httpStatusCode": "422", + "description": "

Validation failed, or the endpoint has been spammed.

" + }, { "httpStatusCode": "500", "description": "

Internal Error

" @@ -619358,6 +620558,10 @@ "httpStatusCode": "404", "description": "

Resource not found

" }, + { + "httpStatusCode": "422", + "description": "

Validation failed, or the endpoint has been spammed.

" + }, { "httpStatusCode": "500", "description": "

Internal Error

" @@ -842100,6 +843304,10 @@ "httpStatusCode": "404", "description": "

Resource not found

" }, + { + "httpStatusCode": "422", + "description": "

Validation failed, or the endpoint has been spammed.

" + }, { "httpStatusCode": "500", "description": "

Internal Error

" @@ -846038,6 +847246,10 @@ "httpStatusCode": "404", "description": "

Resource not found

" }, + { + "httpStatusCode": "422", + "description": "

Validation failed, or the endpoint has been spammed.

" + }, { "httpStatusCode": "500", "description": "

Internal Error

" @@ -901185,6 +902397,10 @@ { "httpStatusCode": "204", "description": "

No Content

" + }, + { + "httpStatusCode": "422", + "description": "

Unprocessable entity if you attempt to modify an enterprise team at the organization level.

" } ], "previews": [], @@ -910340,521 +911556,529 @@ { "httpStatusCode": "200", "description": "

OK

" - } - ], - "previews": [], - "progAccess": { - "userToServerRest": true, - "serverToServer": true, - "fineGrainedPat": true, - "permissions": [ - { - "\"Members\" organization permissions": "write" - } - ] - } - }, - { - "serverUrl": "https://api.github.com", - "verb": "get", - "requestPath": "/orgs/{org}/external-groups", - "title": "List external groups available to an organization", - "category": "teams", - "subcategory": "external-groups", - "parameters": [ - { - "name": "org", - "description": "

The organization name. The name is not case sensitive.

", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, - { - "name": "per_page", - "description": "

The number of results per page (max 100). For more information, see \"Using pagination in the REST API.\"

", - "in": "query", - "schema": { - "type": "integer", - "default": 30 - } - }, - { - "name": "page", - "description": "

Page token

", - "in": "query", - "schema": { - "type": "integer" - } - }, - { - "name": "display_name", - "description": "

Limits the list to groups containing the text in the group name

", - "in": "query", - "schema": { - "type": "string" - } - } - ], - "bodyParameters": [], - "descriptionHTML": "

Lists external groups provisioned on the enterprise that are available to an organization. You can query the groups using the display_name parameter, only groups with a group_name containing the text provided in the display_name parameter will be returned. You can also limit your page results using the per_page parameter. GitHub Enterprise Cloud generates a url-encoded page token using a cursor value for where the next page begins. For more information on cursor pagination, see \"Offset and Cursor Pagination explained.\"

\n

You can manage team membership with your identity provider using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see \"GitHub's products\" in the GitHub Help documentation.

", - "codeExamples": [ - { - "key": "default", - "request": { - "description": "Example", - "acceptHeader": "application/vnd.github.v3+json", - "parameters": { - "org": "ORG" - } - }, - "response": { - "statusCode": "200", - "contentType": "application/json", - "description": "

Response

", - "example": { - "groups": [ - { - "group_id": "123", - "group_name": "Octocat admins", - "updated_at": "2021-01-24T11:31:04-06:00" - }, - { - "group_id": "456", - "group_name": "Octocat docs members", - "updated_at": "2021-03-24T11:31:04-06:00" - } - ] - }, - "schema": { - "title": "ExternalGroups", - "description": "A list of external groups available to be connected to a team", - "type": "object", - "properties": { - "groups": { - "description": "An array of external groups available to be mapped to a team", - "type": "array", - "items": { - "type": "object", - "required": [ - "group_id", - "group_name", - "updated_at" - ], - "properties": { - "group_id": { - "description": "The internal ID of the group", - "type": "integer", - "examples": [ - 1 - ] - }, - "group_name": { - "description": "The display name of the group", - "type": "string", - "examples": [ - "group-azuread-test" - ] - }, - "updated_at": { - "description": "The time of the last update for this group", - "type": "string", - "examples": [ - "2019-06-03 22:27:15:000 -700" - ] - } - } - }, - "examples": [ - { - "group_id": 1, - "group_name": "group-azuread-test", - "updated_at": "2021-01-03 22:27:15:000 -700" - }, - { - "group_id": 2, - "group_name": "group-azuread-test2", - "updated_at": "2021-06-03 22:27:15:000 -700" - } - ] - } - } - } - } - } - ], - "statusCodes": [ - { - "httpStatusCode": "200", - "description": "

OK

" - } - ], - "previews": [], - "progAccess": { - "userToServerRest": true, - "serverToServer": true, - "fineGrainedPat": true, - "permissions": [ - { - "\"Members\" organization permissions": "write" - } - ] - } - }, - { - "serverUrl": "https://api.github.com", - "verb": "get", - "requestPath": "/orgs/{org}/teams/{team_slug}/external-groups", - "title": "List a connection between an external group and a team", - "category": "teams", - "subcategory": "external-groups", - "parameters": [ - { - "name": "org", - "description": "

The organization name. The name is not case sensitive.

", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, - { - "name": "team_slug", - "description": "

The slug of the team name.

", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - } - ], - "bodyParameters": [], - "descriptionHTML": "

Lists a connection between a team and an external group.

\n

You can manage team membership with your identity provider using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see \"GitHub's products\" in the GitHub Help documentation.

", - "codeExamples": [ - { - "key": "default", - "request": { - "description": "Example", - "acceptHeader": "application/vnd.github.v3+json", - "parameters": { - "org": "ORG", - "team_slug": "TEAM_SLUG" - } - }, - "response": { - "statusCode": "200", - "contentType": "application/json", - "description": "

Response

", - "example": { - "groups": [ - { - "group_id": "123", - "group_name": "Octocat admins", - "updated_at": "2021-01-24T11:31:04-06:00" - }, - { - "group_id": "456", - "group_name": "Octocat docs members", - "updated_at": "2021-03-24T11:31:04-06:00" - } - ] - }, - "schema": { - "title": "ExternalGroups", - "description": "A list of external groups available to be connected to a team", - "type": "object", - "properties": { - "groups": { - "description": "An array of external groups available to be mapped to a team", - "type": "array", - "items": { - "type": "object", - "required": [ - "group_id", - "group_name", - "updated_at" - ], - "properties": { - "group_id": { - "description": "The internal ID of the group", - "type": "integer", - "examples": [ - 1 - ] - }, - "group_name": { - "description": "The display name of the group", - "type": "string", - "examples": [ - "group-azuread-test" - ] - }, - "updated_at": { - "description": "The time of the last update for this group", - "type": "string", - "examples": [ - "2019-06-03 22:27:15:000 -700" - ] - } - } - }, - "examples": [ - { - "group_id": 1, - "group_name": "group-azuread-test", - "updated_at": "2021-01-03 22:27:15:000 -700" - }, - { - "group_id": 2, - "group_name": "group-azuread-test2", - "updated_at": "2021-06-03 22:27:15:000 -700" - } - ] - } - } - } - } - } - ], - "statusCodes": [ - { - "httpStatusCode": "200", - "description": "

OK

" - } - ], - "previews": [], - "progAccess": { - "userToServerRest": true, - "serverToServer": true, - "fineGrainedPat": true, - "permissions": [ - { - "\"Members\" organization permissions": "write" - } - ] - } - }, - { - "serverUrl": "https://api.github.com", - "verb": "patch", - "requestPath": "/orgs/{org}/teams/{team_slug}/external-groups", - "title": "Update the connection between an external group and a team", - "category": "teams", - "subcategory": "external-groups", - "parameters": [ - { - "name": "org", - "description": "

The organization name. The name is not case sensitive.

", - "in": "path", - "required": true, - "schema": { - "type": "string" - } + } + ], + "previews": [], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": true, + "permissions": [ + { + "\"Members\" organization permissions": "write" + } + ] + } + }, + { + "serverUrl": "https://api.github.com", + "verb": "get", + "requestPath": "/orgs/{org}/external-groups", + "title": "List external groups available to an organization", + "category": "teams", + "subcategory": "external-groups", + "parameters": [ + { + "name": "org", + "description": "

The organization name. The name is not case sensitive.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "per_page", + "description": "

The number of results per page (max 100). For more information, see \"Using pagination in the REST API.\"

", + "in": "query", + "schema": { + "type": "integer", + "default": 30 + } + }, + { + "name": "page", + "description": "

Page token

", + "in": "query", + "schema": { + "type": "integer" + } + }, + { + "name": "display_name", + "description": "

Limits the list to groups containing the text in the group name

", + "in": "query", + "schema": { + "type": "string" + } + } + ], + "bodyParameters": [], + "descriptionHTML": "

Lists external groups provisioned on the enterprise that are available to an organization. You can query the groups using the display_name parameter, only groups with a group_name containing the text provided in the display_name parameter will be returned. You can also limit your page results using the per_page parameter. GitHub Enterprise Cloud generates a url-encoded page token using a cursor value for where the next page begins. For more information on cursor pagination, see \"Offset and Cursor Pagination explained.\"

\n

You can manage team membership with your identity provider using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see \"GitHub's products\" in the GitHub Help documentation.

", + "codeExamples": [ + { + "key": "default", + "request": { + "description": "Example", + "acceptHeader": "application/vnd.github.v3+json", + "parameters": { + "org": "ORG" + } + }, + "response": { + "statusCode": "200", + "contentType": "application/json", + "description": "

Response

", + "example": { + "groups": [ + { + "group_id": "123", + "group_name": "Octocat admins", + "updated_at": "2021-01-24T11:31:04-06:00" + }, + { + "group_id": "456", + "group_name": "Octocat docs members", + "updated_at": "2021-03-24T11:31:04-06:00" + } + ] + }, + "schema": { + "title": "ExternalGroups", + "description": "A list of external groups available to be connected to a team", + "type": "object", + "properties": { + "groups": { + "description": "An array of external groups available to be mapped to a team", + "type": "array", + "items": { + "type": "object", + "required": [ + "group_id", + "group_name", + "updated_at" + ], + "properties": { + "group_id": { + "description": "The internal ID of the group", + "type": "integer", + "examples": [ + 1 + ] + }, + "group_name": { + "description": "The display name of the group", + "type": "string", + "examples": [ + "group-azuread-test" + ] + }, + "updated_at": { + "description": "The time of the last update for this group", + "type": "string", + "examples": [ + "2019-06-03 22:27:15:000 -700" + ] + } + } + }, + "examples": [ + { + "group_id": 1, + "group_name": "group-azuread-test", + "updated_at": "2021-01-03 22:27:15:000 -700" + }, + { + "group_id": 2, + "group_name": "group-azuread-test2", + "updated_at": "2021-06-03 22:27:15:000 -700" + } + ] + } + } + } + } + } + ], + "statusCodes": [ + { + "httpStatusCode": "200", + "description": "

OK

" + } + ], + "previews": [], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": true, + "permissions": [ + { + "\"Members\" organization permissions": "write" + } + ] + } + }, + { + "serverUrl": "https://api.github.com", + "verb": "get", + "requestPath": "/orgs/{org}/teams/{team_slug}/external-groups", + "title": "List a connection between an external group and a team", + "category": "teams", + "subcategory": "external-groups", + "parameters": [ + { + "name": "org", + "description": "

The organization name. The name is not case sensitive.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "team_slug", + "description": "

The slug of the team name.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "bodyParameters": [], + "descriptionHTML": "

Lists a connection between a team and an external group.

\n

You can manage team membership with your identity provider using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see \"GitHub's products\" in the GitHub Help documentation.

", + "codeExamples": [ + { + "key": "default", + "request": { + "description": "Example", + "acceptHeader": "application/vnd.github.v3+json", + "parameters": { + "org": "ORG", + "team_slug": "TEAM_SLUG" + } + }, + "response": { + "statusCode": "200", + "contentType": "application/json", + "description": "

Response

", + "example": { + "groups": [ + { + "group_id": "123", + "group_name": "Octocat admins", + "updated_at": "2021-01-24T11:31:04-06:00" + }, + { + "group_id": "456", + "group_name": "Octocat docs members", + "updated_at": "2021-03-24T11:31:04-06:00" + } + ] + }, + "schema": { + "title": "ExternalGroups", + "description": "A list of external groups available to be connected to a team", + "type": "object", + "properties": { + "groups": { + "description": "An array of external groups available to be mapped to a team", + "type": "array", + "items": { + "type": "object", + "required": [ + "group_id", + "group_name", + "updated_at" + ], + "properties": { + "group_id": { + "description": "The internal ID of the group", + "type": "integer", + "examples": [ + 1 + ] + }, + "group_name": { + "description": "The display name of the group", + "type": "string", + "examples": [ + "group-azuread-test" + ] + }, + "updated_at": { + "description": "The time of the last update for this group", + "type": "string", + "examples": [ + "2019-06-03 22:27:15:000 -700" + ] + } + } + }, + "examples": [ + { + "group_id": 1, + "group_name": "group-azuread-test", + "updated_at": "2021-01-03 22:27:15:000 -700" + }, + { + "group_id": 2, + "group_name": "group-azuread-test2", + "updated_at": "2021-06-03 22:27:15:000 -700" + } + ] + } + } + } + } + } + ], + "statusCodes": [ + { + "httpStatusCode": "200", + "description": "

OK

" + }, + { + "httpStatusCode": "422", + "description": "

Unprocessable entity if you attempt to modify an enterprise team at the organization level.

" + } + ], + "previews": [], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": true, + "permissions": [ + { + "\"Members\" organization permissions": "write" + } + ] + } + }, + { + "serverUrl": "https://api.github.com", + "verb": "patch", + "requestPath": "/orgs/{org}/teams/{team_slug}/external-groups", + "title": "Update the connection between an external group and a team", + "category": "teams", + "subcategory": "external-groups", + "parameters": [ + { + "name": "org", + "description": "

The organization name. The name is not case sensitive.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "team_slug", + "description": "

The slug of the team name.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "bodyParameters": [ + { + "type": "integer", + "name": "group_id", + "in": "body", + "description": "

External Group Id

", + "isRequired": true + } + ], + "descriptionHTML": "

Creates a connection between a team and an external group. Only one external group can be linked to a team.

\n

You can manage team membership with your identity provider using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see \"GitHub's products\" in the GitHub Help documentation.

", + "codeExamples": [ + { + "key": "default", + "request": { + "contentType": "application/json", + "description": "Example", + "acceptHeader": "application/vnd.github.v3+json", + "bodyParameters": { + "group_id": 123 + }, + "parameters": { + "org": "ORG", + "team_slug": "TEAM_SLUG" + } + }, + "response": { + "statusCode": "200", + "contentType": "application/json", + "description": "

Response

", + "example": { + "group_id": "123", + "group_name": "Octocat admins", + "updated_at": "2021-01-24T11:31:04-06:00", + "teams": [ + { + "team_id": 1, + "team_name": "team-test" + }, + { + "team_id": 2, + "team_name": "team-test2" + } + ], + "members": [ + { + "member_id": 1, + "member_login": "mona-lisa_eocsaxrs", + "member_name": "Mona Lisa", + "member_email": "mona_lisa@github.com" + }, + { + "member_id": 2, + "member_login": "octo-lisa_eocsaxrs", + "member_name": "Octo Lisa", + "member_email": "octo_lisa@github.com" + } + ] + }, + "schema": { + "title": "ExternalGroup", + "description": "Information about an external group's usage and its members", + "type": "object", + "required": [ + "group_id", + "group_name", + "teams", + "members" + ], + "properties": { + "group_id": { + "description": "The internal ID of the group", + "type": "integer", + "examples": [ + 1 + ] + }, + "group_name": { + "description": "The display name for the group", + "type": "string", + "examples": [ + "group-azuread-test" + ] + }, + "updated_at": { + "description": "The date when the group was last updated_at", + "type": "string", + "examples": [ + "2021-01-03 22:27:15:000 -700" + ] + }, + "teams": { + "description": "An array of teams linked to this group", + "type": "array", + "items": { + "type": "object", + "required": [ + "team_id", + "team_name" + ], + "properties": { + "team_id": { + "description": "The id for a team", + "type": "integer", + "examples": [ + 1 + ] + }, + "team_name": { + "description": "The name of the team", + "type": "string", + "examples": [ + "team-test" + ] + } + } + }, + "examples": [ + { + "team_id": 1, + "team_name": "team-test" + }, + { + "team_id": 2, + "team_name": "team-test2" + } + ] + }, + "members": { + "description": "An array of external members linked to this group", + "type": "array", + "items": { + "type": "object", + "required": [ + "member_id", + "member_login", + "member_name", + "member_email" + ], + "properties": { + "member_id": { + "description": "The internal user ID of the identity", + "type": "integer", + "examples": [ + 1 + ] + }, + "member_login": { + "description": "The handle/login for the user", + "type": "string", + "examples": [ + "mona-lisa_eocsaxrs" + ] + }, + "member_name": { + "description": "The user display name/profile name", + "type": "string", + "examples": [ + "Mona Lisa" + ] + }, + "member_email": { + "description": "An email attached to a user", + "type": "string", + "examples": [ + "mona_lisa@github.com" + ] + } + } + }, + "examples": [ + { + "member_id": 1, + "member_login": "mona-lisa_eocsaxrs", + "member_name": "Mona Lisa", + "member_email": "mona_lisa@github.com" + }, + { + "member_id": 2, + "member_login": "octo-lisa_eocsaxrs", + "member_name": "Octo Lisa", + "member_email": "octo_lisa@github.com" + } + ] + } + } + } + } + } + ], + "statusCodes": [ + { + "httpStatusCode": "200", + "description": "

OK

" }, { - "name": "team_slug", - "description": "

The slug of the team name.

", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - } - ], - "bodyParameters": [ - { - "type": "integer", - "name": "group_id", - "in": "body", - "description": "

External Group Id

", - "isRequired": true - } - ], - "descriptionHTML": "

Creates a connection between a team and an external group. Only one external group can be linked to a team.

\n

You can manage team membership with your identity provider using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see \"GitHub's products\" in the GitHub Help documentation.

", - "codeExamples": [ - { - "key": "default", - "request": { - "contentType": "application/json", - "description": "Example", - "acceptHeader": "application/vnd.github.v3+json", - "bodyParameters": { - "group_id": 123 - }, - "parameters": { - "org": "ORG", - "team_slug": "TEAM_SLUG" - } - }, - "response": { - "statusCode": "200", - "contentType": "application/json", - "description": "

Response

", - "example": { - "group_id": "123", - "group_name": "Octocat admins", - "updated_at": "2021-01-24T11:31:04-06:00", - "teams": [ - { - "team_id": 1, - "team_name": "team-test" - }, - { - "team_id": 2, - "team_name": "team-test2" - } - ], - "members": [ - { - "member_id": 1, - "member_login": "mona-lisa_eocsaxrs", - "member_name": "Mona Lisa", - "member_email": "mona_lisa@github.com" - }, - { - "member_id": 2, - "member_login": "octo-lisa_eocsaxrs", - "member_name": "Octo Lisa", - "member_email": "octo_lisa@github.com" - } - ] - }, - "schema": { - "title": "ExternalGroup", - "description": "Information about an external group's usage and its members", - "type": "object", - "required": [ - "group_id", - "group_name", - "teams", - "members" - ], - "properties": { - "group_id": { - "description": "The internal ID of the group", - "type": "integer", - "examples": [ - 1 - ] - }, - "group_name": { - "description": "The display name for the group", - "type": "string", - "examples": [ - "group-azuread-test" - ] - }, - "updated_at": { - "description": "The date when the group was last updated_at", - "type": "string", - "examples": [ - "2021-01-03 22:27:15:000 -700" - ] - }, - "teams": { - "description": "An array of teams linked to this group", - "type": "array", - "items": { - "type": "object", - "required": [ - "team_id", - "team_name" - ], - "properties": { - "team_id": { - "description": "The id for a team", - "type": "integer", - "examples": [ - 1 - ] - }, - "team_name": { - "description": "The name of the team", - "type": "string", - "examples": [ - "team-test" - ] - } - } - }, - "examples": [ - { - "team_id": 1, - "team_name": "team-test" - }, - { - "team_id": 2, - "team_name": "team-test2" - } - ] - }, - "members": { - "description": "An array of external members linked to this group", - "type": "array", - "items": { - "type": "object", - "required": [ - "member_id", - "member_login", - "member_name", - "member_email" - ], - "properties": { - "member_id": { - "description": "The internal user ID of the identity", - "type": "integer", - "examples": [ - 1 - ] - }, - "member_login": { - "description": "The handle/login for the user", - "type": "string", - "examples": [ - "mona-lisa_eocsaxrs" - ] - }, - "member_name": { - "description": "The user display name/profile name", - "type": "string", - "examples": [ - "Mona Lisa" - ] - }, - "member_email": { - "description": "An email attached to a user", - "type": "string", - "examples": [ - "mona_lisa@github.com" - ] - } - } - }, - "examples": [ - { - "member_id": 1, - "member_login": "mona-lisa_eocsaxrs", - "member_name": "Mona Lisa", - "member_email": "mona_lisa@github.com" - }, - { - "member_id": 2, - "member_login": "octo-lisa_eocsaxrs", - "member_name": "Octo Lisa", - "member_email": "octo_lisa@github.com" - } - ] - } - } - } - } - } - ], - "statusCodes": [ - { - "httpStatusCode": "200", - "description": "

OK

" + "httpStatusCode": "422", + "description": "

Unprocessable entity if you attempt to modify an enterprise team at the organization level.

" } ], "previews": [], @@ -910919,6 +912143,10 @@ { "httpStatusCode": "204", "description": "

No Content

" + }, + { + "httpStatusCode": "422", + "description": "

Unprocessable entity if you attempt to modify an enterprise team at the organization level.

" } ], "previews": [], @@ -911283,6 +912511,10 @@ { "httpStatusCode": "200", "description": "

OK

" + }, + { + "httpStatusCode": "422", + "description": "

Unprocessable entity if you attempt to modify an enterprise team at the organization level.

" } ], "previews": [], @@ -913390,6 +914622,10 @@ { "httpStatusCode": "200", "description": "

OK

" + }, + { + "httpStatusCode": "422", + "description": "

Unprocessable entity if you attempt to modify an enterprise team at the organization level.

" } ], "previews": [], @@ -913577,6 +914813,10 @@ { "httpStatusCode": "200", "description": "

OK

" + }, + { + "httpStatusCode": "422", + "description": "

Unprocessable entity if you attempt to modify an enterprise team at the organization level.

" } ], "previews": [], diff --git a/src/rest/data/ghes-3.14-2022-11-28/schema.json b/src/rest/data/ghes-3.14-2022-11-28/schema.json index 8ee24cd692dc..0fb2b87d12dc 100644 --- a/src/rest/data/ghes-3.14-2022-11-28/schema.json +++ b/src/rest/data/ghes-3.14-2022-11-28/schema.json @@ -382167,8 +382167,7 @@ "site_admin": false }, "dismissed_reason": "tolerable_risk", - "dismissed_comment": "This alert is accurate but we use a sanitizer.", - "fixed_at": null + "dismissed_comment": "This alert is accurate but we use a sanitizer." }, "schema": { "type": "object", @@ -383407,7 +383406,7 @@ "type": "array", "name": "selected_repository_ids", "in": "body", - "description": "

An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can manage the list of selected repositories using the List selected repositories for an organization secret, Set selected repositories for an organization secret, and Remove selected repository from an organization secret endpoints. Use integers when possible, as strings are supported only to maintain backwards compatibility and may be removed in the future.

" + "description": "

An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can manage the list of selected repositories using the List selected repositories for an organization secret, Set selected repositories for an organization secret, and Remove selected repository from an organization secret endpoints.

" } ], "descriptionHTML": "

Creates or updates an organization secret with an encrypted value. Encrypt your secret using\nLibSodium. For more information, see \"Encrypting secrets for the REST API.\"

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

", diff --git a/src/rest/data/ghes-3.15-2022-11-28/schema.json b/src/rest/data/ghes-3.15-2022-11-28/schema.json index 249ac3ca4b5d..7d8f91826d7d 100644 --- a/src/rest/data/ghes-3.15-2022-11-28/schema.json +++ b/src/rest/data/ghes-3.15-2022-11-28/schema.json @@ -386526,8 +386526,7 @@ "site_admin": false }, "dismissed_reason": "tolerable_risk", - "dismissed_comment": "This alert is accurate but we use a sanitizer.", - "fixed_at": null + "dismissed_comment": "This alert is accurate but we use a sanitizer." }, "schema": { "type": "object", @@ -387766,7 +387765,7 @@ "type": "array", "name": "selected_repository_ids", "in": "body", - "description": "

An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can manage the list of selected repositories using the List selected repositories for an organization secret, Set selected repositories for an organization secret, and Remove selected repository from an organization secret endpoints. Use integers when possible, as strings are supported only to maintain backwards compatibility and may be removed in the future.

" + "description": "

An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can manage the list of selected repositories using the List selected repositories for an organization secret, Set selected repositories for an organization secret, and Remove selected repository from an organization secret endpoints.

" } ], "descriptionHTML": "

Creates or updates an organization secret with an encrypted value. Encrypt your secret using\nLibSodium. For more information, see \"Encrypting secrets for the REST API.\"

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

", diff --git a/src/rest/data/ghes-3.16-2022-11-28/schema.json b/src/rest/data/ghes-3.16-2022-11-28/schema.json index ddf977594d54..bcb9375c5e97 100644 --- a/src/rest/data/ghes-3.16-2022-11-28/schema.json +++ b/src/rest/data/ghes-3.16-2022-11-28/schema.json @@ -389249,12 +389249,7 @@ "url": "https://api.github.com/repos/octocat/hello-world/dependabot/alerts/1", "html_url": "https://github.com/octocat/hello-world/security/dependabot/1", "created_at": "2022-06-14T15:21:52Z", - "updated_at": "2022-06-14T15:21:52Z", - "dismissed_at": null, - "dismissed_by": null, - "dismissed_reason": null, - "dismissed_comment": null, - "fixed_at": null + "updated_at": "2022-06-14T15:21:52Z" }, "schema": { "type": "object", @@ -390318,8 +390313,7 @@ "site_admin": false }, "dismissed_reason": "tolerable_risk", - "dismissed_comment": "This alert is accurate but we use a sanitizer.", - "fixed_at": null + "dismissed_comment": "This alert is accurate but we use a sanitizer." }, "schema": { "type": "object", @@ -391578,7 +391572,7 @@ "type": "array", "name": "selected_repository_ids", "in": "body", - "description": "

An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can manage the list of selected repositories using the List selected repositories for an organization secret, Set selected repositories for an organization secret, and Remove selected repository from an organization secret endpoints. Use integers when possible, as strings are supported only to maintain backwards compatibility and may be removed in the future.

" + "description": "

An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can manage the list of selected repositories using the List selected repositories for an organization secret, Set selected repositories for an organization secret, and Remove selected repository from an organization secret endpoints.

" } ], "descriptionHTML": "

Creates or updates an organization secret with an encrypted value. Encrypt your secret using\nLibSodium. For more information, see \"Encrypting secrets for the REST API.\"

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

", diff --git a/src/rest/data/ghes-3.17-2022-11-28/schema.json b/src/rest/data/ghes-3.17-2022-11-28/schema.json index f1539829a2a8..899cebb6ec75 100644 --- a/src/rest/data/ghes-3.17-2022-11-28/schema.json +++ b/src/rest/data/ghes-3.17-2022-11-28/schema.json @@ -390202,12 +390202,7 @@ "url": "https://api.github.com/repos/octocat/hello-world/dependabot/alerts/1", "html_url": "https://github.com/octocat/hello-world/security/dependabot/1", "created_at": "2022-06-14T15:21:52Z", - "updated_at": "2022-06-14T15:21:52Z", - "dismissed_at": null, - "dismissed_by": null, - "dismissed_reason": null, - "dismissed_comment": null, - "fixed_at": null + "updated_at": "2022-06-14T15:21:52Z" }, "schema": { "type": "object", @@ -391271,8 +391266,7 @@ "site_admin": false }, "dismissed_reason": "tolerable_risk", - "dismissed_comment": "This alert is accurate but we use a sanitizer.", - "fixed_at": null + "dismissed_comment": "This alert is accurate but we use a sanitizer." }, "schema": { "type": "object", @@ -392531,7 +392525,7 @@ "type": "array", "name": "selected_repository_ids", "in": "body", - "description": "

An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can manage the list of selected repositories using the List selected repositories for an organization secret, Set selected repositories for an organization secret, and Remove selected repository from an organization secret endpoints. Use integers when possible, as strings are supported only to maintain backwards compatibility and may be removed in the future.

" + "description": "

An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can manage the list of selected repositories using the List selected repositories for an organization secret, Set selected repositories for an organization secret, and Remove selected repository from an organization secret endpoints.

" } ], "descriptionHTML": "

Creates or updates an organization secret with an encrypted value. Encrypt your secret using\nLibSodium. For more information, see \"Encrypting secrets for the REST API.\"

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

", diff --git a/src/rest/data/ghes-3.18-2022-11-28/schema.json b/src/rest/data/ghes-3.18-2022-11-28/schema.json index 02a771c3c665..b0545e64cd56 100644 --- a/src/rest/data/ghes-3.18-2022-11-28/schema.json +++ b/src/rest/data/ghes-3.18-2022-11-28/schema.json @@ -390421,12 +390421,7 @@ "url": "https://api.github.com/repos/octocat/hello-world/dependabot/alerts/1", "html_url": "https://github.com/octocat/hello-world/security/dependabot/1", "created_at": "2022-06-14T15:21:52Z", - "updated_at": "2022-06-14T15:21:52Z", - "dismissed_at": null, - "dismissed_by": null, - "dismissed_reason": null, - "dismissed_comment": null, - "fixed_at": null + "updated_at": "2022-06-14T15:21:52Z" }, "schema": { "type": "object", @@ -391490,8 +391485,7 @@ "site_admin": false }, "dismissed_reason": "tolerable_risk", - "dismissed_comment": "This alert is accurate but we use a sanitizer.", - "fixed_at": null + "dismissed_comment": "This alert is accurate but we use a sanitizer." }, "schema": { "type": "object", @@ -393652,7 +393646,7 @@ "type": "array", "name": "selected_repository_ids", "in": "body", - "description": "

An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can manage the list of selected repositories using the List selected repositories for an organization secret, Set selected repositories for an organization secret, and Remove selected repository from an organization secret endpoints. Use integers when possible, as strings are supported only to maintain backwards compatibility and may be removed in the future.

" + "description": "

An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can manage the list of selected repositories using the List selected repositories for an organization secret, Set selected repositories for an organization secret, and Remove selected repository from an organization secret endpoints.

" } ], "descriptionHTML": "

Creates or updates an organization secret with an encrypted value. Encrypt your secret using\nLibSodium. For more information, see \"Encrypting secrets for the REST API.\"

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

", diff --git a/src/rest/data/ghes-3.19-2022-11-28/schema.json b/src/rest/data/ghes-3.19-2022-11-28/schema.json index 37ee711842aa..9afbc0b8dc94 100644 --- a/src/rest/data/ghes-3.19-2022-11-28/schema.json +++ b/src/rest/data/ghes-3.19-2022-11-28/schema.json @@ -396937,12 +396937,7 @@ "url": "https://api.github.com/repos/octocat/hello-world/dependabot/alerts/1", "html_url": "https://github.com/octocat/hello-world/security/dependabot/1", "created_at": "2022-06-14T15:21:52Z", - "updated_at": "2022-06-14T15:21:52Z", - "dismissed_at": null, - "dismissed_by": null, - "dismissed_reason": null, - "dismissed_comment": null, - "fixed_at": null + "updated_at": "2022-06-14T15:21:52Z" }, "schema": { "type": "object", @@ -398006,8 +398001,7 @@ "site_admin": false }, "dismissed_reason": "tolerable_risk", - "dismissed_comment": "This alert is accurate but we use a sanitizer.", - "fixed_at": null + "dismissed_comment": "This alert is accurate but we use a sanitizer." }, "schema": { "type": "object", @@ -400168,7 +400162,7 @@ "type": "array", "name": "selected_repository_ids", "in": "body", - "description": "

An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can manage the list of selected repositories using the List selected repositories for an organization secret, Set selected repositories for an organization secret, and Remove selected repository from an organization secret endpoints. Use integers when possible, as strings are supported only to maintain backwards compatibility and may be removed in the future.

" + "description": "

An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can manage the list of selected repositories using the List selected repositories for an organization secret, Set selected repositories for an organization secret, and Remove selected repository from an organization secret endpoints.

" } ], "descriptionHTML": "

Creates or updates an organization secret with an encrypted value. Encrypt your secret using\nLibSodium. For more information, see \"Encrypting secrets for the REST API.\"

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

", diff --git a/src/rest/data/ghes-3.20-2022-11-28/schema.json b/src/rest/data/ghes-3.20-2022-11-28/schema.json index be1a099ab5ad..66f356084ed7 100644 --- a/src/rest/data/ghes-3.20-2022-11-28/schema.json +++ b/src/rest/data/ghes-3.20-2022-11-28/schema.json @@ -397498,12 +397498,7 @@ "url": "https://api.github.com/repos/octocat/hello-world/dependabot/alerts/1", "html_url": "https://github.com/octocat/hello-world/security/dependabot/1", "created_at": "2022-06-14T15:21:52Z", - "updated_at": "2022-06-14T15:21:52Z", - "dismissed_at": null, - "dismissed_by": null, - "dismissed_reason": null, - "dismissed_comment": null, - "fixed_at": null + "updated_at": "2022-06-14T15:21:52Z" }, "schema": { "type": "object", @@ -398567,8 +398562,7 @@ "site_admin": false }, "dismissed_reason": "tolerable_risk", - "dismissed_comment": "This alert is accurate but we use a sanitizer.", - "fixed_at": null + "dismissed_comment": "This alert is accurate but we use a sanitizer." }, "schema": { "type": "object", @@ -400729,7 +400723,7 @@ "type": "array", "name": "selected_repository_ids", "in": "body", - "description": "

An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can manage the list of selected repositories using the List selected repositories for an organization secret, Set selected repositories for an organization secret, and Remove selected repository from an organization secret endpoints. Use integers when possible, as strings are supported only to maintain backwards compatibility and may be removed in the future.

" + "description": "

An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can manage the list of selected repositories using the List selected repositories for an organization secret, Set selected repositories for an organization secret, and Remove selected repository from an organization secret endpoints.

" } ], "descriptionHTML": "

Creates or updates an organization secret with an encrypted value. Encrypt your secret using\nLibSodium. For more information, see \"Encrypting secrets for the REST API.\"

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

", diff --git a/src/rest/lib/config.json b/src/rest/lib/config.json index 3ed1d35571f9..d7deac68c5eb 100644 --- a/src/rest/lib/config.json +++ b/src/rest/lib/config.json @@ -53,5 +53,5 @@ ] } }, - "sha": "951b2951cf3bed81c9e881f8f470cfda20350d34" + "sha": "884c183f5163e1155700894ac68dd891e8668fd5" } \ No newline at end of file diff --git a/src/webhooks/lib/config.json b/src/webhooks/lib/config.json index 2e75a5b0ae3d..a54d095efb68 100644 --- a/src/webhooks/lib/config.json +++ b/src/webhooks/lib/config.json @@ -1,3 +1,3 @@ { - "sha": "951b2951cf3bed81c9e881f8f470cfda20350d34" + "sha": "884c183f5163e1155700894ac68dd891e8668fd5" } \ No newline at end of file From bf7e629d352265e0bf868a01b4390729b940a1e2 Mon Sep 17 00:00:00 2001 From: Copilot <198982749+Copilot@users.noreply.github.com> Date: Thu, 26 Feb 2026 16:32:25 +0000 Subject: [PATCH 6/9] Remove topics frontmatter from education content (#59857) Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: subatoi <32935794+subatoi@users.noreply.github.com> --- .../get-started-with-github-classroom/about-github-classroom.md | 2 -- .../teach-with-github-classroom/about-assignments.md | 2 -- ...nitor-students-progress-with-the-assignment-overview-page.md | 2 -- 3 files changed, 6 deletions(-) diff --git a/content/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/about-github-classroom.md b/content/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/about-github-classroom.md index c30db7a5cc95..bd5b29d96f39 100644 --- a/content/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/about-github-classroom.md +++ b/content/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/about-github-classroom.md @@ -2,8 +2,6 @@ title: About GitHub Classroom intro: 'Teachers and school administrators can use {% data variables.product.prodname_classroom %} to create virtual classrooms, make and edit assignments, automatically grade assignment submissions, and more.' type: overview -topics: - - Fundamentals versions: fpt: '*' --- diff --git a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/about-assignments.md b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/about-assignments.md index a55d481dbebd..39ca39c45809 100644 --- a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/about-assignments.md +++ b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/about-assignments.md @@ -3,8 +3,6 @@ title: About assignments intro: 'You can use individual or group assignments in {% data variables.product.prodname_classroom %} to teach students and grade their work.' shortTitle: About assignments type: overview -topics: - - Fundamentals versions: fpt: '*' --- diff --git a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/monitor-students-progress-with-the-assignment-overview-page.md b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/monitor-students-progress-with-the-assignment-overview-page.md index d16ae6deeeda..a3c6c934e0c5 100644 --- a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/monitor-students-progress-with-the-assignment-overview-page.md +++ b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/monitor-students-progress-with-the-assignment-overview-page.md @@ -5,8 +5,6 @@ intro: You can use the assignment overview page to track the progress of each st versions: fpt: '*' permissions: 'Organization owners who are admins for a classroom can create and manage group assignments for a classroom. {% data reusables.classroom.classroom-admins-link %}' -topics: - - Education --- ## About the assignment overview page From 0e5ca742fe9500c6735522267c941d43786b93eb Mon Sep 17 00:00:00 2001 From: Felix Guntrip Date: Thu, 26 Feb 2026 16:46:39 +0000 Subject: [PATCH 7/9] Add small section introducing using REST API to modify Copilot Content Exclusions (#59793) Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: Sunbrye Ly <56200261+sunbrye@users.noreply.github.com> --- .../exclude-content-from-copilot.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/content/copilot/how-tos/configure-content-exclusion/exclude-content-from-copilot.md b/content/copilot/how-tos/configure-content-exclusion/exclude-content-from-copilot.md index ad47be253bd7..82574e04c2fa 100644 --- a/content/copilot/how-tos/configure-content-exclusion/exclude-content-from-copilot.md +++ b/content/copilot/how-tos/configure-content-exclusion/exclude-content-from-copilot.md @@ -24,7 +24,7 @@ redirect_from: topics: - Copilot contentType: how-tos -category: +category: - Configure Copilot --- @@ -194,6 +194,12 @@ You can verify that content exclusions you have configured are working as expect If the file is excluded, {% data variables.copilot.copilot_chat_short %} will not be able to use the file to generate a response. The file will not be listed as a reference in {% data variables.product.prodname_copilot_short %}'s response. +## Manage content exclusions with the REST API + +Organization owners and enterprise owners can also manage content exclusions programmatically using the {% data variables.product.github %} REST API. + +For more information, see [AUTOTITLE](/rest/copilot/copilot-content-exclusion-management). + ## Further reading * [AUTOTITLE](/copilot/concepts/content-exclusion-for-github-copilot) From b0aef490f0dff646c769f491b9b1d3b257e90118 Mon Sep 17 00:00:00 2001 From: Sam Browning <106113886+sabrowning1@users.noreply.github.com> Date: Thu, 26 Feb 2026 11:52:15 -0500 Subject: [PATCH 8/9] Update content for GA of AI Controls and agent control plane (#59680) --- .../explore-trial-code-scanning.md | 4 ++-- .../concepts/agents/enterprise-management.md | 16 +++++++++++----- .../manage-agents/manage-copilot-code-review.md | 3 +-- .../manage-agents/monitor-agentic-activity.md | 3 +-- .../manage-agents/prepare-for-custom-agents.md | 2 -- .../manage-enterprise-policies.md | 8 +++----- .../how-tos/set-up/set-up-for-enterprise.md | 4 ++-- .../roll-out-at-scale/establish-ai-managers.md | 2 +- 8 files changed, 21 insertions(+), 21 deletions(-) diff --git a/content/code-security/tutorials/trialing-github-advanced-security/explore-trial-code-scanning.md b/content/code-security/tutorials/trialing-github-advanced-security/explore-trial-code-scanning.md index b2181850b424..cc7439086e34 100644 --- a/content/code-security/tutorials/trialing-github-advanced-security/explore-trial-code-scanning.md +++ b/content/code-security/tutorials/trialing-github-advanced-security/explore-trial-code-scanning.md @@ -84,11 +84,11 @@ Most enterprises put automatic checks in place to block the use of dependencies This allows you to update the configuration in a single location, but use the workflow in many repositories. You may want to use this central repository to maintain other workflows. For more information, see [AUTOTITLE](/actions/sharing-automations/reusing-workflows). -### {% data variables.product.prodname_copilot_short %} review +### {% data variables.copilot.copilot_code-review_short %} > [!NOTE] > -> * If you get a {% data variables.product.prodname_copilot_short %} subscription from an organization, you will only be able to participate in the {% data variables.release-phases.public_preview %} on the {% data variables.product.github %} website if an owner of your organization or enterprise has enabled **Copilot in GitHub.com > Opt in to preview features** in the **{% data variables.product.prodname_copilot %} policies** page of the organization or enterprise settings. See [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization#enabling-copilot-features-in-your-organization) and [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise#copilot-in-githubcom){% ifversion fpt or ghes %} in the {% data variables.product.prodname_ghe_cloud %} documentation{% endif %}. +> * If you get a {% data variables.product.prodname_copilot_short %} subscription from an organization, you will only be able to participate in the {% data variables.release-phases.public_preview %} on the {% data variables.product.github %} website if an owner of your organization or enterprise has enabled {% data variables.copilot.copilot_code-review_short %}. See [AUTOTITLE](/enterprise-cloud@latest/copilot/how-tos/administer-copilot/manage-for-organization/manage-policies#opting-in-to-previews-or-feedback) and [AUTOTITLE](/enterprise-cloud@latest/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-enterprise-policies){% ifversion fpt or ghes %} in the {% data variables.product.prodname_ghe_cloud %} documentation{% endif %}. By default, users request a review from {% data variables.product.prodname_copilot_short %} in the same way as they do from human reviewers. However, you can update or create an organization-level branch ruleset to automatically add {% data variables.product.prodname_copilot_short %} as a reviewer to all pull requests made to selected branches in all or selected repositories. See [AUTOTITLE](/enterprise-cloud@latest/copilot/how-tos/agents/copilot-code-review/automatic-code-review){% ifversion fpt or ghes %} in the {% data variables.product.prodname_ghe_cloud %} documentation{% endif %}. diff --git a/content/copilot/concepts/agents/enterprise-management.md b/content/copilot/concepts/agents/enterprise-management.md index 9e0334a5e522..a2cb43759e6c 100644 --- a/content/copilot/concepts/agents/enterprise-management.md +++ b/content/copilot/concepts/agents/enterprise-management.md @@ -11,21 +11,23 @@ category: - Learn about Copilot --- -{% data reusables.enterprise-accounts.ai-controls-preview-note %} - ## Overview -The AI Controls view provides a centralized platform where you can manage and monitor agents across your enterprise. From this agent control plane, you can: +The AI Controls view provides a centralized platform where you can manage and monitor AI policies and agents across your enterprise. From the "Agents" page, you can: * Manage the enterprise-level availability of agents like {% data variables.copilot.copilot_coding_agent %}, {% data variables.copilot.copilot_code-review_short %}, and {% data variables.copilot.copilot_custom_agents %} * Control who can manage your enterprise-level {% data variables.copilot.custom_agents_short %} -* View a list of agent sessions in your enterprise over the last 24 hours +* View and filter a list of agent sessions in your enterprise over the last 24 hours * Find a detailed record of agentic audit log events ## {% data variables.copilot.copilot_custom_agents %} {% data variables.copilot.copilot_custom_agents %} are specialized versions of {% data variables.copilot.copilot_coding_agent %} that you can configure with tailored prompts, tools, and context, making them excel at specific tasks. {% data variables.copilot.custom_agents_caps_short %} can be defined and managed at the enterprise level for greater control and compliance, or at the organization and repository levels to allow teams the flexibility to build for their specific needs. -Before you start configuring agentic settings for your enterprise, you should have a strong understanding of {% data variables.copilot.custom_agents_short %}. To learn more, see [AUTOTITLE](/copilot/concepts/agents/coding-agent/about-custom-agents). +You can manage your enterprise-level {% data variables.copilot.custom_agents_short %}: +* From the AI Controls view +* Using the REST API. See [AUTOTITLE](/rest/copilot/copilot-custom-agents). + +For more detailed information on {% data variables.copilot.custom_agents_short %}, see [AUTOTITLE](/copilot/concepts/agents/coding-agent/about-custom-agents). ## Agent sessions @@ -39,3 +41,7 @@ For billing information on agent sessions, see [AUTOTITLE](/billing/concepts/pro ## Next steps To get started with {% data variables.copilot.custom_agents_short %}, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents). + +## Further reading + +* [AUTOTITLE](/copilot/concepts/agents/about-third-party-agents) diff --git a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/manage-copilot-code-review.md b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/manage-copilot-code-review.md index 6aa4a43b1407..f2ae584f323d 100644 --- a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/manage-copilot-code-review.md +++ b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/manage-copilot-code-review.md @@ -11,7 +11,7 @@ shortTitle: 'Manage {% data variables.copilot.copilot_code-review_short %}' redirect_from: - /copilot/how-tos/administer-copilot/manage-for-enterprise/manage-copilot-code-review contentType: how-tos -category: +category: - Manage Copilot for a team --- @@ -28,7 +28,6 @@ You can allow your members to use {% data variables.copilot.copilot_code-review_ > [!NOTE] > > {% data reusables.copilot.code-review.preview-note %} -> * To participate in the {% data variables.release-phases.public_preview %}, you must first enable **{% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_dotcom_the_website %} > Opt in to preview features** from the "{% data variables.product.prodname_copilot_short %}" page of your enterprise's AI Controls. {% data reusables.enterprise-accounts.policy-enablement-next-steps %} diff --git a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/monitor-agentic-activity.md b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/monitor-agentic-activity.md index 51b6229be007..1fc18c9de922 100644 --- a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/monitor-agentic-activity.md +++ b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/monitor-agentic-activity.md @@ -12,13 +12,12 @@ category: - Manage Copilot for a team --- -{% data reusables.enterprise-accounts.ai-controls-preview-note %} - ## Viewing active and recent agentic sessions in your enterprise {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.ai-controls-tab %} 1. Towards the top of the page, in the "Agent sessions" section, you will see the three most recent agent sessions in your enterprise. To view all agent sessions from the last 24 hours, click **View all**. +1. To see available filters for agent sessions, click the search bar at the top of the list, then press Space. Use the dropdown menu that appears to create your filter criteria. ## Tracking agentic activity in your enterprise through the audit log diff --git a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents.md b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents.md index 9caafaae8f38..2886842b7e0b 100644 --- a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents.md +++ b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents.md @@ -13,8 +13,6 @@ category: - Manage Copilot for a team --- -{% data reusables.enterprise-accounts.ai-controls-preview-note %} - Enterprise-level {% data variables.copilot.custom_agents_short %} are defined in a specific repository within an organization in your enterprise. Before you can create and use {% data variables.copilot.custom_agents_short %}, you need to create this repository and configure the relevant enterprise settings. ## Creating a repository for your {% data variables.copilot.custom_agents_short %} diff --git a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-enterprise-policies.md b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-enterprise-policies.md index 7dc4b4802652..a4f5d98baa7c 100644 --- a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-enterprise-policies.md +++ b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-enterprise-policies.md @@ -16,7 +16,7 @@ redirect_from: - /copilot/how-tos/administer/enterprises/manage-enterprise-policies - /copilot/how-tos/administer/manage-for-enterprise/manage-enterprise-policies contentType: how-tos -category: +category: - Manage Copilot for a team --- @@ -41,11 +41,9 @@ Enterprise owners can define a policy for the whole enterprise, or delegate the {% data reusables.copilot.mcp-servers-policy-note %} -## Opting in to previews or feedback +## Opting in to feedback collection -If your enterprise has a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} plan and you enable "{% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_dotcom_the_website %}" from the "{% data variables.product.prodname_copilot_short %}" page of the "AI Controls" tab, two additional options are displayed: - - {% data reusables.copilot.policies-for-dotcom %} +If you enable "{% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_dotcom_the_website %}" from the "{% data variables.product.prodname_copilot_short %}" page of the "AI Controls" tab, you can also opt in to user feedback collection to help {% data variables.product.github %} improve {% data variables.product.prodname_copilot_short %} features. ## Further reading diff --git a/content/copilot/how-tos/set-up/set-up-for-enterprise.md b/content/copilot/how-tos/set-up/set-up-for-enterprise.md index 2e864c7a25d9..9da8809e3eb9 100644 --- a/content/copilot/how-tos/set-up/set-up-for-enterprise.md +++ b/content/copilot/how-tos/set-up/set-up-for-enterprise.md @@ -16,7 +16,7 @@ redirect_from: - /copilot/get-started/setting-up-github-copilot/setting-up-github-copilot-for-your-enterprise - /copilot/how-tos/set-up/setting-up-github-copilot-for-your-enterprise contentType: how-tos -category: +category: - Configure Copilot --- @@ -27,7 +27,7 @@ category: 1. Click the **{% octicon "check-circle" aria-hidden="true" aria-label="check-circle" %} Getting Started** tab. 1. Under "Next steps", click **Verify your payment method**. This will enable {% data variables.product.prodname_copilot %} in your enterprise. -After you've completed these steps, you will be able to confirm that {% data variables.product.prodname_copilot %} is enabled in your enterprise's **{% octicon "law" aria-hidden="true" aria-label="law" %} Policies** tab. +After you've completed these steps, you will be able to confirm that {% data variables.product.prodname_copilot %} is enabled in your enterprise's **{% octicon "law" aria-hidden="true" aria-label="law" %} AI Controls** tab. ## 2. Set policies diff --git a/content/copilot/tutorials/roll-out-at-scale/establish-ai-managers.md b/content/copilot/tutorials/roll-out-at-scale/establish-ai-managers.md index 76770af801fa..730d6c8628c8 100644 --- a/content/copilot/tutorials/roll-out-at-scale/establish-ai-managers.md +++ b/content/copilot/tutorials/roll-out-at-scale/establish-ai-managers.md @@ -11,7 +11,7 @@ contentType: tutorials --- > [!NOTE] -> Enterprise custom roles, enterprise teams, and the AI Controls view are in public preview and subject to change. +> Enterprise custom roles and enterprise teams are in public preview and subject to change. ## Overview From 5b59580cdcb8dfe26b257afc52df46c56ccad7a5 Mon Sep 17 00:00:00 2001 From: Copilot <198982749+Copilot@users.noreply.github.com> Date: Thu, 26 Feb 2026 16:48:41 +0000 Subject: [PATCH 9/9] Remove topics frontmatter from discussions content (#59856) Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: subatoi <32935794+subatoi@users.noreply.github.com> --- .../viewing-insights-for-your-discussions.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/content/discussions/managing-discussions-for-your-community/viewing-insights-for-your-discussions.md b/content/discussions/managing-discussions-for-your-community/viewing-insights-for-your-discussions.md index 07aea8acd308..ed0ceef59ebf 100644 --- a/content/discussions/managing-discussions-for-your-community/viewing-insights-for-your-discussions.md +++ b/content/discussions/managing-discussions-for-your-community/viewing-insights-for-your-discussions.md @@ -6,8 +6,6 @@ versions: fpt: '*' ghes: '*' ghec: '*' -topics: - - Discussions shortTitle: View discussions insights ---