diff --git a/assets/images/help/billing/cost-center-example-2.png b/assets/images/help/billing/cost-center-example-2.png deleted file mode 100644 index 815f39ec036e..000000000000 Binary files a/assets/images/help/billing/cost-center-example-2.png and /dev/null differ diff --git a/content/admin/concepts/identity-and-access-management/setup-user.md b/content/admin/concepts/identity-and-access-management/setup-user.md index 01c32140c5a7..32a7375c3949 100644 --- a/content/admin/concepts/identity-and-access-management/setup-user.md +++ b/content/admin/concepts/identity-and-access-management/setup-user.md @@ -1,6 +1,6 @@ --- title: Setup user -intro: 'The setup user is used to configure authentication and provisioning for {% data variables.product.prodname_emus %}.' +intro: 'The setup user is used only to configure authentication and provisioning for {% data variables.product.prodname_emus %}.' versions: ghec: '*' topics: @@ -11,25 +11,37 @@ topics: ## How should I use the setup user? -The setup user is **only** intended to be used for: +The setup user is an administrative account. It is **only** intended to be used for: * Configuring authentication and provisioning * SCIM provisioning via its {% data variables.product.pat_generic %} -* Regaining access to your enterprise in the event of an issue with your identity provider, by utilizing the enterprise's recovery codes +* Regaining access to your enterprise in the event of an issue with your identity provider -For other enterprise administration tasks, such as creating organizations, use a provisioned managed user account with the appropriate administrative role. +For other enterprise administration tasks, such as creating organizations, use a **provisioned managed user account** with the appropriate administrative role. -## How do I sign in as the setup user? +## What is the setup user's username? + +If you use **{% data variables.product.prodname_dotcom_the_website %}**, the username is your enterprise's shortcode, suffixed with `_admin`. For example: `fabrikam_admin`. -After we create your enterprise, you will receive an **email** inviting you to choose a password for the setup user. +If you use **{% data variables.enterprise.data_residency_site %}**, the username is a randomly generated shortcode, suffixed with `_admin`. + +## How do I sign in as the setup user? -When you create the password, you should enable two-factor authentication (2FA) for the account. +After we create your enterprise, you will receive an **email** inviting you to choose a password for the setup user. -Unlike provisioned managed users, the setup user cannot sign in via SSO. Instead, the following applies: +When you create the password, we strongly recommend that you **enable two-factor authentication (2FA)** for the account and **save your recovery codes**. -* **With 2FA enabled**: All subsequent login attempts for the setup user account will require a successful 2FA challenge response. After completing the 2FA challenge, you will be prompted for a recovery code. You can skip this prompt and navigate directly to {% data variables.product.prodname_dotcom_the_website %} to access the setup user account. However, accessing your enterprise settings will always require a recovery code. -* **Without 2FA enabled**: You must provide a recovery code every time you sign in. +Unlike provisioned managed users, the setup user cannot sign in via SSO. -We strongly recommend enabling 2FA on the setup user to avoid needing a recovery code for every sign-in attempt. To avoid being locked out of your account, after enabling single sign-on, **save your recovery codes**. See [AUTOTITLE](/admin/managing-iam/managing-recovery-codes-for-your-enterprise/downloading-your-enterprise-accounts-single-sign-on-recovery-codes#downloading-codes-for-an-enterprise-with-enterprise-managed-users). +- **Without 2FA enabled**, you must provide a recovery code **every** time you sign in. +- If **2FA is enabled**, you can sign in with a successful 2FA challenge response. You only need to provide a recovery code to access enterprise settings. {% data reusables.enterprise-accounts.emu-password-reset-session %} + +## Can I delete the setup user? + +The setup user **cannot** be deleted, because it is essential for maintaining authentication and provisioning. The only way to remove the setup user is to delete your enterprise account. See [AUTOTITLE](/admin/managing-your-enterprise-account/deleting-an-enterprise-account). + +## Further reading + +- [AUTOTITLE](/admin/managing-iam/managing-recovery-codes-for-your-enterprise/downloading-your-enterprise-accounts-single-sign-on-recovery-codes#downloading-codes-for-an-enterprise-with-enterprise-managed-users) \ No newline at end of file diff --git a/content/copilot/concepts/agents/copilot-cli/about-copilot-cli.md b/content/copilot/concepts/agents/copilot-cli/about-copilot-cli.md index de0155789ea3..ae34d00660e8 100644 --- a/content/copilot/concepts/agents/copilot-cli/about-copilot-cli.md +++ b/content/copilot/concepts/agents/copilot-cli/about-copilot-cli.md @@ -22,8 +22,6 @@ The command-line interface (CLI) for {% data variables.product.prodname_copilot {% data variables.copilot.copilot_cli %} gives you quick access to a powerful AI agent, without having to leave your terminal. It can help you complete tasks more quickly by working on your behalf, and you can work iteratively with {% data variables.copilot.copilot_cli %} to build the code you need. -{% data reusables.cli.preview-note-cli %} - ## Supported operating systems * Linux diff --git a/content/copilot/concepts/agents/copilot-cli/autopilot.md b/content/copilot/concepts/agents/copilot-cli/autopilot.md index f7b959f92009..b6f827e3210d 100644 --- a/content/copilot/concepts/agents/copilot-cli/autopilot.md +++ b/content/copilot/concepts/agents/copilot-cli/autopilot.md @@ -30,14 +30,14 @@ In autopilot mode, {% data variables.product.prodname_copilot_short %} keeps on To switch into autopilot mode during an interactive session, press Shift+Tab and cycle through the available modes until you reach autopilot mode, then enter your prompt. Use the same keypress to switch from autopilot mode back to the standard interactive mode. -### Benefits of autopilot mode +## Benefits of autopilot mode * **Hands-off automation:** {% data variables.product.prodname_copilot_short %} completes tasks without needing your input after the initial instruction. * **Efficiency:** Ideal for well-defined tasks like writing tests, refactoring files, or fixing CI failures. Autopilot is particularly suited for large tasks that require long-running, multi-step sessions. * **Batch operations:** Useful for scripting and CI workflows where you want {% data variables.product.prodname_copilot_short %} to run to completion. * **Safety:** Autopilot mode allows {% data variables.product.prodname_copilot_short %} to take multiple self-directed steps to finish your task. `--max-autopilot-continues` limits how many steps it can take before stopping, to avoid infinite loops. Also, in autopilot mode, {% data variables.product.prodname_copilot_short %} cannot carry out any actions that require permission unless you explicitly grant it full permissions. -### Things to consider +## Things to consider * **Task suitability:** Autopilot mode is best for well-defined tasks. It is not ideal for open-ended exploration, feature development without a clear goal, or tasks where you want to guide the ongoing work. @@ -47,11 +47,11 @@ To switch into autopilot mode during an interactive session, press ShiftShift+Tab to switch into plan mode and work with {% data variables.copilot.copilot_cli_short %} to create an implementation plan. +1. Recognize that the completed plan contains multiple elements and looks like a good candidate for `/fleet`. +1. Select the **Accept plan and build on autopilot + /fleet** option that's displayed when the plan is complete. + +For more information about autopilot mode, see [AUTOTITLE](/copilot/concepts/agents/copilot-cli/autopilot). + +## Further reading + +* [AUTOTITLE](/copilot/how-tos/copilot-cli/speeding-up-task-completion) diff --git a/content/copilot/concepts/agents/copilot-cli/index.md b/content/copilot/concepts/agents/copilot-cli/index.md index 7c73a42601e2..c2e93a5b7d6a 100644 --- a/content/copilot/concepts/agents/copilot-cli/index.md +++ b/content/copilot/concepts/agents/copilot-cli/index.md @@ -12,5 +12,6 @@ children: - /about-cli-plugins - /comparing-cli-features - /autopilot + - /fleet contentType: concepts --- diff --git a/content/copilot/get-started/features.md b/content/copilot/get-started/features.md index fdb685d201cd..c5580ce50b49 100644 --- a/content/copilot/get-started/features.md +++ b/content/copilot/get-started/features.md @@ -37,7 +37,7 @@ An autonomous AI agent that can make code changes for you. You can assign a {% d You can use third-party coding agents alongside {% data variables.copilot.copilot_coding_agent %}. See [AUTOTITLE](/free-pro-team@latest/copilot/concepts/agents/about-third-party-agents). -### {% data variables.copilot.copilot_cli_short %} ({% data variables.release-phases.public_preview %}) +### {% data variables.copilot.copilot_cli_short %} A command line interface that lets you use {% data variables.product.prodname_copilot_short %} from within the terminal. You can get answers to questions, or you can ask {% data variables.product.prodname_copilot_short %} to make changes to your local files. You can also use {% data variables.copilot.copilot_cli_short %} to interact with {% data variables.product.prodname_dotcom_the_website %}—for example, listing your open pull requests, or asking {% data variables.product.prodname_copilot_short %} to create an issue. See [AUTOTITLE](/copilot/concepts/agents/about-copilot-cli). 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 8121d149238b..862bfafad1e7 100644 --- a/content/copilot/how-tos/copilot-cli/cli-best-practices.md +++ b/content/copilot/how-tos/copilot-cli/cli-best-practices.md @@ -414,6 +414,12 @@ Run the linter and write all errors to `migration-checklist.md` as a checklist. Then fix each issue one by one, checking them off as you go. ``` +### Autonomous task completion + +Switch into autopilot mode to allow {% data variables.product.prodname_copilot_short %} to work autonomously on a task until it is complete. This is ideal for long-running tasks that don't require constant supervision. For more information, see [AUTOTITLE](/copilot/concepts/agents/copilot-cli/autopilot). + +Optionally, you can usually speed up large tasks by using the `/fleet` slash command at the start of your prompt to allow {% data variables.product.prodname_copilot_short %} to break the task into parallel subtasks that are run by subagents. For more information, see [AUTOTITLE](/copilot/concepts/agents/copilot-cli/fleet). + ## 7. Team guidelines ### Recommended repository setup diff --git a/content/copilot/how-tos/copilot-cli/customize-copilot/add-custom-instructions.md b/content/copilot/how-tos/copilot-cli/customize-copilot/add-custom-instructions.md index c4c7312ef6cd..9aa27fd130bf 100644 --- a/content/copilot/how-tos/copilot-cli/customize-copilot/add-custom-instructions.md +++ b/content/copilot/how-tos/copilot-cli/customize-copilot/add-custom-instructions.md @@ -75,10 +75,7 @@ You can also set the `COPILOT_CUSTOM_INSTRUCTIONS_DIRS` environment variable to {% data reusables.copilot.custom-instructions-note %} -{% data variables.copilot.copilot_cli_short %} caches instructions after they have been read. If you edit an instructions file, and you want to ensure that the changes are used, you must do one of the following: - -* Restart {% data variables.copilot.copilot_cli_short %}. -* Use `/resume SESSION-ID`. You can use the `/session` command to find the ID of the current session. +If you make changes to your custom instructions during a CLI session, your changes are available for use by {% data variables.product.prodname_copilot_short %} the next time you submit a prompt in the current, or future, sessions. ## Further reading diff --git a/content/copilot/how-tos/copilot-cli/index.md b/content/copilot/how-tos/copilot-cli/index.md index 6ee000da2409..78cb0e398d4d 100644 --- a/content/copilot/how-tos/copilot-cli/index.md +++ b/content/copilot/how-tos/copilot-cli/index.md @@ -16,7 +16,7 @@ introLinks: overview: /copilot/concepts/agents/copilot-cli/about-copilot-cli quickstart: /copilot/how-tos/copilot-cli/cli-getting-started children: - # Top-level articles and sub-categories in the Copilot How-to's are listed at the top of this list. + # Top-level articles and sub-categories in the Copilot How-to's are listed at the top of this list. # This sets the order we show them in the side nav. # All content from other directories and in any sub-directories can be added in any order underneath. - /cli-getting-started @@ -25,10 +25,12 @@ children: - /customize-copilot - /use-copilot-cli - /automate-with-actions + - /speeding-up-task-completion - /content/copilot/concepts/agents/copilot-cli/about-copilot-cli - /content/copilot/concepts/agents/copilot-cli/comparing-cli-features - /content/copilot/concepts/agents/copilot-cli/about-cli-plugins - /content/copilot/concepts/agents/copilot-cli/autopilot + - /content/copilot/concepts/agents/copilot-cli/fleet - /set-up-copilot-cli/install-copilot-cli - /set-up-copilot-cli/configure-copilot-cli - /customize-copilot/add-custom-instructions diff --git a/content/copilot/how-tos/copilot-cli/set-up-copilot-cli/configure-copilot-cli.md b/content/copilot/how-tos/copilot-cli/set-up-copilot-cli/configure-copilot-cli.md index 76ee4991d4c6..7cb3a3bdc97f 100644 --- a/content/copilot/how-tos/copilot-cli/set-up-copilot-cli/configure-copilot-cli.md +++ b/content/copilot/how-tos/copilot-cli/set-up-copilot-cli/configure-copilot-cli.md @@ -13,8 +13,6 @@ category: - Configure Copilot CLI # Copilot CLI bespoke page --- -{% data reusables.cli.preview-note-cli %} - ## Introduction {% data variables.copilot.copilot_cli_short %} has several configuration options that control what it can access and do on your behalf. @@ -76,9 +74,9 @@ The first time that {% data variables.product.prodname_copilot_short %} needs to ``` 1. Choose from one of the three options: - + * `1. Yes` - + Choose this option to allow {% data variables.product.prodname_copilot_short %} to run this particular command, this time only. The next time it needs to use this tool, it will ask you again. * `2. Yes, and approve TOOL for the rest of the running session` @@ -177,7 +175,7 @@ Use `'MCP_SERVER_NAME'` to allow or deny a specific tool from the specified MCP `MCP_SERVER_NAME` is the name of an MCP server that you have configured. -Tools from the server are specified in parentheses, using the tool name that is registered with the MCP server. +Tools from the server are specified in parentheses, using the tool name that is registered with the MCP server. Using the server name without specifying a tool allows or denies all tools from that server. @@ -230,7 +228,7 @@ To disallow access to the temp directory, use `--disallow-temp-dir`. ## Setting URL permissions -URL permissions control which external URLs {% data variables.product.prodname_copilot_short %} can access. By default, all URLs require approval before access is granted. +URL permissions control which external URLs {% data variables.product.prodname_copilot_short %} can access. By default, all URLs require approval before access is granted. URL permissions apply to the `web_fetch` tool and a curated list of shell commands that access the network (such as `curl`, `wget`, and `fetch`). For shell commands, URLs are extracted using regex patterns. diff --git a/content/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli.md b/content/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli.md index 7adc1594511d..c72582150af8 100644 --- a/content/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli.md +++ b/content/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli.md @@ -24,8 +24,6 @@ category: - Configure Copilot CLI # Copilot CLI bespoke page --- -{% data reusables.cli.preview-note-cli %} - To find out about {% data variables.copilot.copilot_cli_short %} before you install it, see [AUTOTITLE](/copilot/concepts/agents/about-copilot-cli). ## Prerequisites diff --git a/content/copilot/how-tos/copilot-cli/speeding-up-task-completion.md b/content/copilot/how-tos/copilot-cli/speeding-up-task-completion.md new file mode 100644 index 000000000000..ef153d0366f5 --- /dev/null +++ b/content/copilot/how-tos/copilot-cli/speeding-up-task-completion.md @@ -0,0 +1,50 @@ +--- +title: Speeding up task completion with the `/fleet` command +shortTitle: Speeding up task completion +intro: Learn how you can speed up the completion of a multi-step implementation plan by using the `/fleet` slash command. +versions: + feature: copilot +topics: + - Copilot + - CLI +contentType: how-tos +category: + - Author and optimize with Copilot # Copilot discovery page + - Build with Copilot CLI # Copilot CLI bespoke page +--- + +Where a task involves multiple operations, some or all of which can be worked on in parallel, the `/fleet` slash command can speed up task completion. When you use this command, {% data variables.product.prodname_copilot_short %} assigns separate parts of the work to subagents. + +For more information, see [AUTOTITLE](/copilot/concepts/agents/copilot-cli/fleet). + +## Using the `/fleet` slash command + +To use the `/fleet` slash command, enter the command followed by your prompt. + +### Typical workflow + +Typically, you'll use the `/fleet` slash command after creating an implementation plan. + +1. In an interactive CLI session, press Shift+Tab to switch into plan mode. +1. Enter a prompt describing the feature you want to add or the change you want to make. +1. Work with {% data variables.product.prodname_copilot_short %} in plan mode to create an implementation plan. +1. Once the plan is complete, select one of the following options: + + * **Accept plan and build on autopilot + /fleet** to allow {% data variables.product.prodname_copilot_short %} to use subagents and work autonomously to implement the plan without any further input. + * **Exit plan mode and I will prompt myself** and then enter a prompt such as `/fleet implement the plan`. {% data variables.product.prodname_copilot_short %} will start working on the plan, using subagents to run parts of the work in parallel where possible. It may ask you to answer questions or make decisions as it works through the plan. + +### Monitoring progress + +Use the `/tasks` slash command to see a list of background tasks relating to the current session. This will include any subtasks handled by subagents when you use the `/fleet` command. + +Use up and down keyboard keys to navigate through the list of background tasks. For each subagent task, you can: + +* Press Enter to view details. When the subtask is complete, you will see a summary of what was done. +* Press k to kill the process. +* Press r to remove completed or killed subtasks from the list. + +Press Esc to exit the task list and return to the main CLI prompt. + +## Further reading + +* [AUTOTITLE](/copilot/reference/cli-command-reference#slash-commands-in-the-interactive-interface) 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 e9be2d3cccbd..6b2d9a164d60 100644 --- a/content/copilot/how-tos/copilot-cli/use-copilot-cli.md +++ b/content/copilot/how-tos/copilot-cli/use-copilot-cli.md @@ -19,8 +19,6 @@ category: The command-line interface (CLI) for {% data variables.product.prodname_copilot %} allows you to use {% data variables.product.prodname_copilot_short %} directly from your terminal. For more information, see [AUTOTITLE](/copilot/concepts/agents/about-copilot-cli). -{% data reusables.cli.preview-note-cli %} - ## Prerequisite Install {% data variables.copilot.copilot_cli_short %}. See [AUTOTITLE](/copilot/how-tos/set-up/install-copilot-cli). @@ -157,9 +155,14 @@ Alternatively, prefix a prompt with `&` to delegate it: ### Resume an interactive session -You can use the `--resume` command line option or the `/resume` slash command to cycle through and resume local and remote interactive sessions, allowing you to pick up right where you left off with your existing context. You can kick off a {% data variables.copilot.copilot_coding_agent %} session on {% data variables.product.github %}, and then use {% data variables.copilot.copilot_cli %} to bring that session to your local environment. +You can use the `--resume` command-line option or the `/resume` slash command to select and resume an interactive CLI session, allowing you to pick up right where you left off, with the saved context. You can kick off a {% data variables.copilot.copilot_coding_agent %} session on {% data variables.product.github %}, and then use {% data variables.copilot.copilot_cli %} to bring that session to your local environment. -You can quickly resume the most recently closed local session by using the `--continue` command line option. +> [!TIP] +> To quickly resume the most recently closed local session, enter this in your terminal: +> +> ```shell +> copilot --continue +> ``` ### Use custom instructions diff --git a/content/copilot/reference/cli-command-reference.md b/content/copilot/reference/cli-command-reference.md index 46a31d7fbdcb..3a7cb4e54f85 100644 --- a/content/copilot/reference/cli-command-reference.md +++ b/content/copilot/reference/cli-command-reference.md @@ -8,7 +8,7 @@ category: - Author and optimize with Copilot # Copilot discovery page - Build with Copilot CLI # Copilot CLI bespoke landing page topics: - - Copilot + - Copilot contentType: reference --- @@ -71,8 +71,8 @@ contentType: reference | `/diff` | Review the changes made in the current directory. | | `/exit`, `/quit` | Exit the CLI. | | `/experimental [on\|off]` | Toggle or turn on/off experimental features. | -| `/share [file\|gist] [PATH]` | Share the session to a Markdown file or GitHub gist. | | `/feedback` | Provide feedback about the CLI. | +| `/fleet [PROMPT]` | Enable parallel subagent execution of parts of a task. See [AUTOTITLE](/copilot/concepts/agents/copilot-cli/fleet). | | `/help` | Show the help for interactive commands. | | `/ide` | Connect to an IDE workspace. | | `/init` | Initialize {% data variables.product.prodname_copilot_short %} custom instructions and agentic features for this repository. | @@ -86,10 +86,11 @@ contentType: reference | `/plugin [marketplace\|install\|uninstall\|update\|list] [ARGS...]` | Manage plugins and plugin marketplaces. | | `/rename NAME` | Rename the current session (alias for `/session rename`). | | `/reset-allowed-tools` | Reset the list of allowed tools. | -| `/resume [SESSION-ID]` | Switch to a different session (optionally specify a session ID). | +| `/resume [SESSION-ID]` | Switch to a different session by choosing from a list (optionally specify a session ID). | | `/review [PROMPT]` | Run the code review agent to analyze changes. | -| `/session [checkpoints [n]\|files\|plan\|rename NAME]` | Show session information and a workspace summary. Use the subcommands for details. | -| `/skills [list\|info\|add\|remove\|reload] [ARGS...]` | Manage skills for enhanced capabilities. | +| `/session [checkpoints [n]\|files\|plan\|rename NAME]` | Show session information and a workspace summary. Use the subcommands for details. | +| `/share [file\|gist] [PATH]` | Share the session to a Markdown file or GitHub gist. | +| `/skills [list\|info\|add\|remove\|reload] [ARGS...]` | Manage skills for enhanced capabilities. | | `/terminal-setup` | Configure the terminal for multiline input support (Shift+Enter and Ctrl+Enter). | | `/theme [show\|set\|list] [auto\|THEME-ID]` | View or configure the terminal theme. | | `/usage` | Display session usage metrics and statistics. | @@ -114,7 +115,7 @@ For a complete list of available slash commands enter `/help` in the CLI's inter | `--allow-tool [TOOLS...]` | Tools the CLI has permission to use. Will not prompt for permission. | | `--allow-url [URLS...]` | Allow access to specific URLs or domains. | | `--alt-screen [VALUE]` | Use the terminal alternate screen buffer (`on` or `off`). | -| `--autopilot` | Enable autopilot continuation in prompt mode. | +| `--autopilot` | Enable autopilot continuation in prompt mode. See [AUTOTITLE](/copilot/concepts/agents/copilot-cli/autopilot). | | `--available-tools [TOOLS...]` | Only these tools will be available to the model. | | `--banner` | Show the startup banner. | | `--bash-env [VALUE]` | Enable `BASH_ENV` support for bash shells (`on` or `off`). | @@ -133,7 +134,7 @@ For a complete list of available slash commands enter `/help` in the CLI's inter | `-i PROMPT`, `--interactive PROMPT` | Start an interactive session and automatically execute this prompt. | | `--log-dir DIRECTORY` | Set the log file directory (default: `~/.copilot/logs/`). | | `--log-level LEVEL` | Set the log level (choices: `none`, `error`, `warning`, `info`, `debug`, `all`, `default`). | -| `--max-autopilot-continues COUNT` | Maximum number of continuation messages in autopilot mode (default: unlimited). | +| `--max-autopilot-continues COUNT` | Maximum number of continuation messages in autopilot mode (default: unlimited). See [AUTOTITLE](/copilot/concepts/agents/copilot-cli/autopilot). | | `--model MODEL` | Set the AI model you want to use. | | `--no-alt-screen` | Disable the terminal alternate screen buffer. | | `--no-ask-user` | Disable the `ask_user` tool (the agent works autonomously without asking questions). | @@ -144,7 +145,7 @@ For a complete list of available slash commands enter `/help` in the CLI's inter | `--no-experimental` | Disable experimental features. | | `-p PROMPT`, `--prompt PROMPT` | Execute a prompt programmatically (exits after completion). | | `--plain-diff` | Disable rich diff rendering (syntax highlighting via the diff tool specified by your git config). | -| `--resume [SESSION-ID]` | Resume from a previous session (optionally specify a session ID). | +| `--resume [SESSION-ID]` | Resume a previous interactive session by choosing from a list (optionally specify a session ID). | | `-s`, `--silent` | Output only the agent response (without usage statistics), useful for scripting with `-p`. | | `--screen-reader` | Enable screen reader optimizations. | | `--share [PATH]` | Share a session to a Markdown file after completion of a programmatic session (default path: `./copilot-session-.md`). | diff --git a/content/copilot/responsible-use/copilot-cli.md b/content/copilot/responsible-use/copilot-cli.md index f2ea20e44ab2..16edea64fd93 100644 --- a/content/copilot/responsible-use/copilot-cli.md +++ b/content/copilot/responsible-use/copilot-cli.md @@ -19,8 +19,6 @@ category: - Learn about Copilot CLI --- -{% data reusables.cli.preview-note-cli %} - ## About {% data variables.copilot.copilot_cli %} {% data variables.copilot.copilot_cli %} provides a chat-like interface in the terminal that can autonomously create and modify files on your computer and execute commands. You can ask {% data variables.product.prodname_copilot_short %} to perform any action on the files in the active directory. diff --git a/data/features/secret-scanning-alert-experimental-list-toggle.yml b/data/features/secret-scanning-alert-experimental-list-toggle.yml deleted file mode 100644 index c9729245eca6..000000000000 --- a/data/features/secret-scanning-alert-experimental-list-toggle.yml +++ /dev/null @@ -1,3 +0,0 @@ -# Documentation for secret scanning experimental alert list, the top-right toggle was removed in 3.17 in favor of the left sidebar item -versions: - ghes: '>=3.16 <3.17' diff --git a/data/reusables/cli/billable-prus.md b/data/reusables/cli/billable-prus.md new file mode 100644 index 000000000000..160537124bc1 --- /dev/null +++ b/data/reusables/cli/billable-prus.md @@ -0,0 +1 @@ +The billable premium request usage is determined using a multiplier. The multiplier varies depending on which model you use. Use the `/model` slash command to see the currently selected model and its multiplier, and change the model if required. For more information, see [AUTOTITLE](/copilot/concepts/billing/copilot-requests) and [AUTOTITLE](/copilot/concepts/billing/billing-for-individuals#about-premium-requests). diff --git a/data/reusables/code-scanning/what-is-codeql-cli.md b/data/reusables/code-scanning/what-is-codeql-cli.md deleted file mode 100644 index dd8f518c5b3e..000000000000 --- a/data/reusables/code-scanning/what-is-codeql-cli.md +++ /dev/null @@ -1 +0,0 @@ -The {% data variables.product.prodname_codeql_cli %} is a standalone, command-line tool that you can use to analyze code. Its main purpose is to generate a database representation of a codebase, a {% data variables.product.prodname_codeql %} database. Once the database is ready, you can query it interactively, or run a suite of queries to generate a set of results in SARIF format and upload the results to {% data variables.product.github %}. diff --git a/data/reusables/copilot/code-review/manage-static-analysis-tools.md b/data/reusables/copilot/code-review/manage-static-analysis-tools.md deleted file mode 100644 index 148d1ea3d2b0..000000000000 --- a/data/reusables/copilot/code-review/manage-static-analysis-tools.md +++ /dev/null @@ -1,6 +0,0 @@ -1. Edit or create a ruleset for {% data variables.copilot.copilot_code-review_short %}: - * If you have **configured a ruleset for automatic reviews** from {% data variables.copilot.copilot_code-review_short %}, click the name of that ruleset. - * If you **do not have an existing ruleset** for {% data variables.copilot.copilot_code-review_short %}, select the **New ruleset** {% octicon "triangle-down" aria-hidden="true" aria-label="triangle" %} dropdown menu, then click **New branch ruleset** and give your ruleset a name. -1. In the "Rules" section, select **Manage static analysis tools in {% data variables.copilot.copilot_code-review_short %}**. -1. To update the tools that {% data variables.copilot.copilot_code-review_short %} will use, select the **Select tools** {% octicon "triangle-down" aria-hidden="true" aria-label="triangle-down" %} dropdown menu, then select or deselect the available tools. -1. To apply your selections, at the bottom of the page, click **Create** or **Save changes**. \ No newline at end of file diff --git a/data/reusables/copilot/mcp-custom-agents-org-enterprise-only.md b/data/reusables/copilot/mcp-custom-agents-org-enterprise-only.md deleted file mode 100644 index 87faccc849e9..000000000000 --- a/data/reusables/copilot/mcp-custom-agents-org-enterprise-only.md +++ /dev/null @@ -1,2 +0,0 @@ -> [!NOTE] -> MCP servers can only be configured directly within {% data variables.copilot.copilot_custom_agent_short %} profiles at the organization and enterprise level. Repository-level {% data variables.copilot.custom_agents_short %} cannot have MCP servers configured directly in their profiles, but can use tools from MCP servers configured in the repository's settings. diff --git a/data/reusables/copilot/org-copilot-usage-metrics.md b/data/reusables/copilot/org-copilot-usage-metrics.md deleted file mode 100644 index 37ce071b9cfd..000000000000 --- a/data/reusables/copilot/org-copilot-usage-metrics.md +++ /dev/null @@ -1 +0,0 @@ -> [!NOTE] The {% data variables.product.prodname_copilot_short %} usage metrics dashboard reports data at the enterprise level. Organization-level metrics are available through the {% data variables.product.prodname_copilot_short %} usage metrics APIs only. See [AUTOTITLE](/rest/copilot/copilot-usage-metrics). diff --git a/data/reusables/enterprise-migration-tool/ado2gh-binary-generate-script.md b/data/reusables/enterprise-migration-tool/ado2gh-binary-generate-script.md deleted file mode 100644 index 7bddcab02c35..000000000000 --- a/data/reusables/enterprise-migration-tool/ado2gh-binary-generate-script.md +++ /dev/null @@ -1 +0,0 @@ -If you downloaded {% data variables.product.prodname_ado2gh %} as a standalone binary rather than as an extension for the {% data variables.product.prodname_cli %}, you will need to update your generated script to run the binary instead of `gh ado2gh`. diff --git a/data/reusables/enterprise-migration-tool/ado2gh-binary.md b/data/reusables/enterprise-migration-tool/ado2gh-binary.md deleted file mode 100644 index d647134abb6a..000000000000 --- a/data/reusables/enterprise-migration-tool/ado2gh-binary.md +++ /dev/null @@ -1 +0,0 @@ -Alternatively, you can download a standalone binary from the [releases page](https://github.com/github/gh-ado2gh/releases) for the `github/gh-ado2gh` repository. You can run this binary directly, without needing {% data variables.product.prodname_cli %} or using the `gh` prefix. diff --git a/data/reusables/secret-scanning/regular-expression-generator-overview.md b/data/reusables/secret-scanning/regular-expression-generator-overview.md deleted file mode 100644 index 6659f4177ec0..000000000000 --- a/data/reusables/secret-scanning/regular-expression-generator-overview.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.secret-scanning.copilot-secret-scanning %}'s {% data variables.secret-scanning.custom-pattern-regular-expression-generator %} uses a generative AI model where you input a text description of the type of pattern you would like to detect, including optional example strings that should be detected. The model returns up to three regular expressions for you to review. diff --git a/data/reusables/security-advisory/global-advisories.md b/data/reusables/security-advisory/global-advisories.md deleted file mode 100644 index eb7f891d62e7..000000000000 --- a/data/reusables/security-advisory/global-advisories.md +++ /dev/null @@ -1 +0,0 @@ -Security advisories in the {% data variables.product.prodname_advisory_database %} at [github.com/advisories](https://github.com/advisories) are considered global advisories. Anyone can suggest improvements on any global security advisory in the {% data variables.product.prodname_advisory_database %}. You can edit or add any detail, including additionally affected ecosystems, severity level or description of who is impacted. The {% data variables.product.prodname_security %} curation team will review the submitted improvements and publish them onto the {% data variables.product.prodname_advisory_database %} if accepted. diff --git a/src/graphql/data/fpt/changelog.json b/src/graphql/data/fpt/changelog.json index 19e30caf4e88..1852ab165561 100644 --- a/src/graphql/data/fpt/changelog.json +++ b/src/graphql/data/fpt/changelog.json @@ -1,4 +1,19 @@ [ + { + "schemaChanges": [ + { + "title": "The GraphQL schema includes these changes:", + "changes": [ + "

Input field requireExplicitValues of type Boolean was added to input object type CreateRepositoryCustomPropertyInput

", + "

Field requireExplicitValues was added to object type RepositoryCustomProperty

", + "

Input field requireExplicitValues of type Boolean was added to input object type UpdateRepositoryCustomPropertyInput

" + ] + } + ], + "previewChanges": [], + "upcomingChanges": [], + "date": "2026-02-25" + }, { "schemaChanges": [ { diff --git a/src/graphql/data/fpt/schema.docs.graphql b/src/graphql/data/fpt/schema.docs.graphql index 65ea3c3011d3..9946fe130e4a 100644 --- a/src/graphql/data/fpt/schema.docs.graphql +++ b/src/graphql/data/fpt/schema.docs.graphql @@ -8791,6 +8791,11 @@ input CreateRepositoryCustomPropertyInput { """ regex: String + """ + Whether this repository custom property requires explicit values. + """ + requireExplicitValues: Boolean + """ Whether the custom property is required. """ @@ -52330,6 +52335,11 @@ type RepositoryCustomProperty implements Node { """ regex: String + """ + Whether this repository custom property requires explicit values. + """ + requireExplicitValues: Boolean + """ Whether the custom property is required. """ @@ -66684,6 +66694,11 @@ input UpdateRepositoryCustomPropertyInput { """ repositoryCustomPropertyId: ID! @possibleTypes(concreteTypes: ["RepositoryCustomProperty"]) + """ + Whether this repository custom property requires explicit values. + """ + requireExplicitValues: Boolean + """ Whether the updated custom property is required. """ diff --git a/src/graphql/data/fpt/schema.json b/src/graphql/data/fpt/schema.json index 5601da233375..a658ea18230d 100644 --- a/src/graphql/data/fpt/schema.json +++ b/src/graphql/data/fpt/schema.json @@ -69154,6 +69154,14 @@ "kind": "scalars", "href": "/graphql/reference/scalars#string" }, + { + "name": "requireExplicitValues", + "description": "

Whether this repository custom property requires explicit values.

", + "type": "Boolean", + "id": "boolean", + "kind": "scalars", + "href": "/graphql/reference/scalars#boolean" + }, { "name": "required", "description": "

Whether the custom property is required.

", @@ -101748,6 +101756,14 @@ "kind": "scalars", "href": "/graphql/reference/scalars#string" }, + { + "name": "requireExplicitValues", + "description": "

Whether this repository custom property requires explicit values.

", + "type": "Boolean", + "id": "boolean", + "kind": "scalars", + "href": "/graphql/reference/scalars#boolean" + }, { "name": "required", "description": "

Whether the custom property is required.

", @@ -111715,6 +111731,14 @@ "href": "/graphql/reference/scalars#id", "isDeprecated": false }, + { + "name": "requireExplicitValues", + "description": "

Whether this repository custom property requires explicit values.

", + "type": "Boolean", + "id": "boolean", + "kind": "scalars", + "href": "/graphql/reference/scalars#boolean" + }, { "name": "required", "description": "

Whether the updated custom property is required.

", diff --git a/src/graphql/data/ghec/schema.docs.graphql b/src/graphql/data/ghec/schema.docs.graphql index 65ea3c3011d3..9946fe130e4a 100644 --- a/src/graphql/data/ghec/schema.docs.graphql +++ b/src/graphql/data/ghec/schema.docs.graphql @@ -8791,6 +8791,11 @@ input CreateRepositoryCustomPropertyInput { """ regex: String + """ + Whether this repository custom property requires explicit values. + """ + requireExplicitValues: Boolean + """ Whether the custom property is required. """ @@ -52330,6 +52335,11 @@ type RepositoryCustomProperty implements Node { """ regex: String + """ + Whether this repository custom property requires explicit values. + """ + requireExplicitValues: Boolean + """ Whether the custom property is required. """ @@ -66684,6 +66694,11 @@ input UpdateRepositoryCustomPropertyInput { """ repositoryCustomPropertyId: ID! @possibleTypes(concreteTypes: ["RepositoryCustomProperty"]) + """ + Whether this repository custom property requires explicit values. + """ + requireExplicitValues: Boolean + """ Whether the updated custom property is required. """ diff --git a/src/graphql/data/ghec/schema.json b/src/graphql/data/ghec/schema.json index 5601da233375..a658ea18230d 100644 --- a/src/graphql/data/ghec/schema.json +++ b/src/graphql/data/ghec/schema.json @@ -69154,6 +69154,14 @@ "kind": "scalars", "href": "/graphql/reference/scalars#string" }, + { + "name": "requireExplicitValues", + "description": "

Whether this repository custom property requires explicit values.

", + "type": "Boolean", + "id": "boolean", + "kind": "scalars", + "href": "/graphql/reference/scalars#boolean" + }, { "name": "required", "description": "

Whether the custom property is required.

", @@ -101748,6 +101756,14 @@ "kind": "scalars", "href": "/graphql/reference/scalars#string" }, + { + "name": "requireExplicitValues", + "description": "

Whether this repository custom property requires explicit values.

", + "type": "Boolean", + "id": "boolean", + "kind": "scalars", + "href": "/graphql/reference/scalars#boolean" + }, { "name": "required", "description": "

Whether the custom property is required.

", @@ -111715,6 +111731,14 @@ "href": "/graphql/reference/scalars#id", "isDeprecated": false }, + { + "name": "requireExplicitValues", + "description": "

Whether this repository custom property requires explicit values.

", + "type": "Boolean", + "id": "boolean", + "kind": "scalars", + "href": "/graphql/reference/scalars#boolean" + }, { "name": "required", "description": "

Whether the updated custom property is required.

", diff --git a/src/graphql/data/ghes-3.20/graphql_upcoming_changes.public-enterprise.yml b/src/graphql/data/ghes-3.20/graphql_upcoming_changes.public-enterprise.yml index 28a8ac281f31..27010ddb0461 100644 --- a/src/graphql/data/ghes-3.20/graphql_upcoming_changes.public-enterprise.yml +++ b/src/graphql/data/ghes-3.20/graphql_upcoming_changes.public-enterprise.yml @@ -1396,14 +1396,6 @@ upcoming_changes: date: '2025-10-01T00:00:00+00:00' criticality: breaking owner: github/advisory-database - - location: SearchType.ISSUE_ADVANCED - description: '`ISSUE_ADVANCED` will be removed.' - reason: - Search for issues and pull requests will be overridden by advanced search - on November 4, 2025. You can read more about this change on https://github.blog/changelog/2025-03-06-github-issues-projects-api-support-for-issues-advanced-search-and-more/. - date: '2025-11-04' - criticality: breaking - owner: github/issues_advanced_search - location: NotificationThread.list description: '`list` will be removed. Use the `optionalList` field instead.' reason: Null values are possible for this field. diff --git a/src/graphql/data/ghes-3.20/schema.docs-enterprise.graphql b/src/graphql/data/ghes-3.20/schema.docs-enterprise.graphql index 956396362d12..b1a40d160f3d 100644 --- a/src/graphql/data/ghes-3.20/schema.docs-enterprise.graphql +++ b/src/graphql/data/ghes-3.20/schema.docs-enterprise.graphql @@ -248,9 +248,13 @@ input AddAssigneesToAssignableInput { assignableId: ID! @possibleTypes(concreteTypes: ["Issue", "PullRequest"], abstractType: "Assignable") """ - The id of users to add as assignees. + The ids of actors (users or bots) to add as assignees. """ - assigneeIds: [ID!]! @possibleTypes(concreteTypes: ["User"]) + assigneeIds: [ID!]! + @possibleTypes( + concreteTypes: ["Bot", "EnterpriseUserAccount", "Mannequin", "Organization", "User"] + abstractType: "Actor" + ) """ A unique identifier for the client performing the mutation. @@ -1288,6 +1292,56 @@ type AddedToProjectEvent implements Node { ) } +""" +Represents a 'added_to_project_v2' event on a given issue or pull request. +""" +type AddedToProjectV2Event implements Node & ProjectV2Event { + """ + Identifies the actor who performed the event. + """ + actor: Actor + + """ + Identifies the date and time when the object was created. + """ + createdAt: DateTime! + + """ + The Node ID of the AddedToProjectV2Event object + """ + id: ID! + + """ + Project referenced by event. + """ + project: ProjectV2 + + """ + Did this event result from workflow automation? + """ + wasAutomated: Boolean! +} + +""" +Copilot Agentic fields in context of the current viewer. +""" +interface Agentic { + """ + Channel value for subscribing to live updates for session creations. + """ + viewerCopilotAgentCreatesChannel: String + + """ + Channel value for subscribing to live updates for session log updates. + """ + viewerCopilotAgentLogUpdatesChannel: String + + """ + Channel value for subscribing to live updates for session updates. + """ + viewerCopilotAgentUpdatesChannel: String +} + """ An announcement banner for an enterprise or organization. """ @@ -6943,6 +6997,36 @@ type ConvertToDraftEvent implements Node & UniformResourceLocatable { url: URI! } +""" +Represents a 'converted_from_draft' event on a given issue or pull request. +""" +type ConvertedFromDraftEvent implements Node & ProjectV2Event { + """ + Identifies the actor who performed the event. + """ + actor: Actor + + """ + Identifies the date and time when the object was created. + """ + createdAt: DateTime! + + """ + The Node ID of the ConvertedFromDraftEvent object + """ + id: ID! + + """ + Project referenced by event. + """ + project: ProjectV2 + + """ + Did this event result from workflow automation? + """ + wasAutomated: Boolean! +} + """ Represents a 'converted_note_to_issue' event on a given issue or pull request. """ @@ -7015,7 +7099,9 @@ type ConvertedToDiscussionEvent implements Node { } """ -Request Copilot code review for new pull requests automatically if the author has access to Copilot code review. +Request Copilot code review for new pull requests automatically if the author +has access to Copilot code review and their premium requests quota has not +reached the limit. """ type CopilotCodeReviewParameters { """ @@ -7030,7 +7116,9 @@ type CopilotCodeReviewParameters { } """ -Request Copilot code review for new pull requests automatically if the author has access to Copilot code review. +Request Copilot code review for new pull requests automatically if the author +has access to Copilot code review and their premium requests quota has not +reached the limit. """ input CopilotCodeReviewParametersInput { """ @@ -7866,6 +7954,11 @@ input CreateIssueInput { """ projectIds: [ID!] @possibleTypes(concreteTypes: ["Project"]) + """ + An array of Node IDs for Projects V2 associated with this issue. + """ + projectV2Ids: [ID!] @possibleTypes(concreteTypes: ["ProjectV2"]) + """ The Node ID of the repository. """ @@ -8395,6 +8488,76 @@ type CreateRefPayload { ref: Ref } +""" +Autogenerated input type of CreateRepositoryCustomProperty +""" +input CreateRepositoryCustomPropertyInput { + """ + The allowed values for the custom property. + """ + allowedValues: [String!] + + """ + A unique identifier for the client performing the mutation. + """ + clientMutationId: String + + """ + The default value for the custom property if the property is required. + """ + defaultValue: String + + """ + The description of the custom property. + """ + description: String + + """ + The name of the custom property. + """ + propertyName: String! + + """ + The regex pattern that the value of the custom property must match, if the `value_type` is `string`. + """ + regex: String + + """ + Whether the custom property is required. + """ + required: Boolean + + """ + The global relay id of the source in which a new custom property should be created in. + """ + sourceId: ID! @possibleTypes(concreteTypes: ["Enterprise", "Organization"], abstractType: "CustomPropertySource") + + """ + The value type for the custom property. + """ + valueType: CustomPropertyValueType! + + """ + The allowed actors who can edit the values of a custom property. + """ + valuesEditableBy: RepositoryCustomPropertyValuesEditableBy +} + +""" +Autogenerated return type of CreateRepositoryCustomProperty. +""" +type CreateRepositoryCustomPropertyPayload { + """ + A unique identifier for the client performing the mutation. + """ + clientMutationId: String + + """ + The newly created repository custom property. + """ + repositoryCustomProperty: RepositoryCustomProperty +} + """ Autogenerated input type of CreateRepository """ @@ -9166,6 +9329,64 @@ type CrossReferencedEvent implements Node & UniformResourceLocatable { willCloseTarget: Boolean! } +""" +Sources which can have custom properties defined. +""" +union CustomPropertySource = Enterprise | Organization + +""" +A custom property value can be either a string or an array of strings. All +property types support only a single string value, except for the multi-select +type, which supports only a string array. +""" +scalar CustomPropertyValue + +""" +The custom property name and value to be set. +""" +input CustomPropertyValueInput { + """ + The name of the custom property. + """ + propertyName: String! + + """ + The value to set for the custom property. Using a value of null will unset the + property value, reverting to the default value if the property is required. + """ + value: CustomPropertyValue +} + +""" +The allowed value types for a custom property definition. +""" +enum CustomPropertyValueType { + """ + A multi-select value. + """ + MULTI_SELECT + + """ + A single-select value. + """ + SINGLE_SELECT + + """ + A string value. + """ + STRING + + """ + A true/false value. + """ + TRUE_FALSE + + """ + A URL value. + """ + URL +} + """ The Common Vulnerability Scoring System """ @@ -9920,6 +10141,36 @@ type DeleteRefPayload { clientMutationId: String } +""" +Autogenerated input type of DeleteRepositoryCustomProperty +""" +input DeleteRepositoryCustomPropertyInput { + """ + A unique identifier for the client performing the mutation. + """ + clientMutationId: String + + """ + The global relay id of the custom property to be deleted. + """ + id: ID! @possibleTypes(concreteTypes: ["RepositoryCustomProperty"]) +} + +""" +Autogenerated return type of DeleteRepositoryCustomProperty. +""" +type DeleteRepositoryCustomPropertyPayload { + """ + A unique identifier for the client performing the mutation. + """ + clientMutationId: String + + """ + The deleted custom property. + """ + repositoryCustomProperty: RepositoryCustomProperty +} + """ Autogenerated input type of DeleteRepositoryRuleset """ @@ -12932,6 +13183,41 @@ type Enterprise implements Node { """ readmeHTML: HTML! + """ + A list of repository custom properties for this enterprise. + """ + repositoryCustomProperties( + """ + Returns the elements in the list that come after the specified cursor. + """ + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """ + Returns the first _n_ elements from the list. + """ + first: Int + + """ + Returns the last _n_ elements from the list. + """ + last: Int + ): RepositoryCustomPropertyConnection + + """ + Returns a single repository custom property for the current enterprise by name. + """ + repositoryCustomProperty( + """ + The name of the repository custom property to be returned. + """ + propertyName: String! + ): RepositoryCustomProperty + """ The HTTP path for this enterprise. """ @@ -18867,6 +19153,16 @@ type IssueDependenciesSummary { Count of issues this issue is blocking """ blocking: Int! + + """ + Total count of issues this issue is blocked by (open and closed) + """ + totalBlockedBy: Int! + + """ + Total count of issues this issue is blocking (open and closed) + """ + totalBlocking: Int! } """ @@ -19173,7 +19469,7 @@ type IssueTimelineConnection { An item in an issue timeline """ union IssueTimelineItem = - AssignedEvent + | AssignedEvent | ClosedEvent | Commit | CrossReferencedEvent @@ -19212,7 +19508,8 @@ type IssueTimelineItemEdge { An item in an issue timeline """ union IssueTimelineItems = - AddedToProjectEvent + | AddedToProjectEvent + | AddedToProjectV2Event | AssignedEvent | BlockedByAddedEvent | BlockedByRemovedEvent @@ -19221,6 +19518,7 @@ union IssueTimelineItems = | ClosedEvent | CommentDeletedEvent | ConnectedEvent + | ConvertedFromDraftEvent | ConvertedNoteToIssueEvent | ConvertedToDiscussionEvent | CrossReferencedEvent @@ -19239,8 +19537,10 @@ union IssueTimelineItems = | ParentIssueAddedEvent | ParentIssueRemovedEvent | PinnedEvent + | ProjectV2ItemStatusChangedEvent | ReferencedEvent | RemovedFromProjectEvent + | RemovedFromProjectV2Event | RenamedTitleEvent | ReopenedEvent | SubIssueAddedEvent @@ -19319,6 +19619,11 @@ enum IssueTimelineItemsItemType { """ ADDED_TO_PROJECT_EVENT + """ + Represents a 'added_to_project_v2' event on a given issue or pull request. + """ + ADDED_TO_PROJECT_V2_EVENT + """ Represents an 'assigned' event on any assignable object. """ @@ -19359,6 +19664,11 @@ enum IssueTimelineItemsItemType { """ CONNECTED_EVENT + """ + Represents a 'converted_from_draft' event on a given issue or pull request. + """ + CONVERTED_FROM_DRAFT_EVENT + """ Represents a 'converted_note_to_issue' event on a given issue or pull request. """ @@ -19389,6 +19699,21 @@ enum IssueTimelineItemsItemType { """ ISSUE_COMMENT + """ + Represents a 'issue_field_added' event on a given issue. + """ + ISSUE_FIELD_ADDED_EVENT + + """ + Represents a 'issue_field_changed' event on a given issue. + """ + ISSUE_FIELD_CHANGED_EVENT + + """ + Represents a 'issue_field_removed' event on a given issue. + """ + ISSUE_FIELD_REMOVED_EVENT + """ Represents a 'issue_type_added' event on a given issue. """ @@ -19449,6 +19774,11 @@ enum IssueTimelineItemsItemType { """ PINNED_EVENT + """ + Represents a 'project_v2_item_status_changed' event on a given issue or pull request. + """ + PROJECT_V2_ITEM_STATUS_CHANGED_EVENT + """ Represents a 'referenced' event on a given `ReferencedSubject`. """ @@ -19459,6 +19789,11 @@ enum IssueTimelineItemsItemType { """ REMOVED_FROM_PROJECT_EVENT + """ + Represents a 'removed_from_project_v2' event on a given issue or pull request. + """ + REMOVED_FROM_PROJECT_V2_EVENT + """ Represents a 'renamed' event on a given issue or pull request """ @@ -23523,6 +23858,16 @@ type Mutation { input: CreateRepositoryInput! ): CreateRepositoryPayload + """ + Create a repository custom property. + """ + createRepositoryCustomProperty( + """ + Parameters for CreateRepositoryCustomProperty + """ + input: CreateRepositoryCustomPropertyInput! + ): CreateRepositoryCustomPropertyPayload + """ Create a repository ruleset """ @@ -23802,6 +24147,16 @@ type Mutation { input: DeleteRefInput! ): DeleteRefPayload + """ + Delete a repository custom property. + """ + deleteRepositoryCustomProperty( + """ + Parameters for DeleteRepositoryCustomProperty + """ + input: DeleteRepositoryCustomPropertyInput! + ): DeleteRepositoryCustomPropertyPayload + """ Delete a repository ruleset """ @@ -24124,6 +24479,16 @@ type Mutation { input: PinIssueInput! ): PinIssuePayload + """ + Promote a repository custom property to the enterprise level. + """ + promoteRepositoryCustomProperty( + """ + Parameters for PromoteRepositoryCustomProperty + """ + input: PromoteRepositoryCustomPropertyInput! + ): PromoteRepositoryCustomPropertyPayload + """ Regenerates a verifiable domain's verification token. """ @@ -24354,6 +24719,16 @@ type Mutation { input: RevokeMigratorRoleInput! ): RevokeMigratorRolePayload + """ + Set repository custom property values for a repository. + """ + setRepositoryCustomPropertyValues( + """ + Parameters for SetRepositoryCustomPropertyValues + """ + input: SetRepositoryCustomPropertyValuesInput! + ): SetRepositoryCustomPropertyValuesPayload + """ Starts a GitHub Enterprise Importer organization migration. """ @@ -25094,6 +25469,16 @@ type Mutation { input: UpdateRepositoryInput! ): UpdateRepositoryPayload + """ + Update a repository custom property. + """ + updateRepositoryCustomProperty( + """ + Parameters for UpdateRepositoryCustomProperty + """ + input: UpdateRepositoryCustomPropertyInput! + ): UpdateRepositoryCustomPropertyPayload + """ Update a repository ruleset """ @@ -29401,7 +29786,7 @@ type OrgRestoreMemberAuditEntry implements AuditEntry & Node & OrganizationAudit Types of memberships that can be restored for an Organization member. """ union OrgRestoreMemberAuditEntryMembership = - OrgRestoreMemberMembershipOrganizationAuditEntryData + | OrgRestoreMemberMembershipOrganizationAuditEntryData | OrgRestoreMemberMembershipRepositoryAuditEntryData | OrgRestoreMemberMembershipTeamAuditEntryData @@ -31156,6 +31541,41 @@ type Organization implements Actor & MemberStatusable & Node & PackageOwner & Pr name: String! ): Repository + """ + A list of custom properties for this organization. + """ + repositoryCustomProperties( + """ + Returns the elements in the list that come after the specified cursor. + """ + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """ + Returns the first _n_ elements from the list. + """ + first: Int + + """ + Returns the last _n_ elements from the list. + """ + last: Int + ): RepositoryCustomPropertyConnection + + """ + Returns a single custom property from the current organization by name. + """ + repositoryCustomProperty( + """ + The name of the custom property to be returned. + """ + propertyName: String! + ): RepositoryCustomProperty + """ Discussion comments this user has authored. """ @@ -31499,7 +31919,7 @@ type Organization implements Actor & MemberStatusable & Node & PackageOwner & Pr An audit entry in an organization audit log. """ union OrganizationAuditEntry = - MembersCanDeleteReposClearAuditEntry + | MembersCanDeleteReposClearAuditEntry | MembersCanDeleteReposDisableAuditEntry | MembersCanDeleteReposEnableAuditEntry | OauthApplicationCreateAuditEntry @@ -32198,6 +32618,66 @@ enum OrganizationOrderField { LOGIN } +""" +Parameters to be used for the organization_property condition +""" +type OrganizationPropertyConditionTarget { + """ + Array of organization properties that must not match. + """ + exclude: [OrganizationPropertyTargetDefinition!]! + + """ + Array of organization properties that must match + """ + include: [OrganizationPropertyTargetDefinition!]! +} + +""" +Parameters to be used for the organization_property condition +""" +input OrganizationPropertyConditionTargetInput { + """ + Array of organization properties that must not match. + """ + exclude: [OrganizationPropertyTargetDefinitionInput!]! + + """ + Array of organization properties that must match + """ + include: [OrganizationPropertyTargetDefinitionInput!]! +} + +""" +A property that must match +""" +type OrganizationPropertyTargetDefinition { + """ + The name of the property + """ + name: String! + + """ + The values to match for + """ + propertyValues: [String!]! +} + +""" +A property that must match +""" +input OrganizationPropertyTargetDefinitionInput { + """ + The name of the property + """ + name: String! + + """ + The values to match for + """ + propertyValues: [String!]! +} + """ An organization teams hovercard context """ @@ -35024,6 +35504,11 @@ type ProjectV2 implements Closable & Node & Updatable { Ordering options for project v2 items returned from the connection """ orderBy: ProjectV2ItemOrder = {field: POSITION, direction: ASC} + + """ + Search query for filtering items + """ + query: String = "" ): ProjectV2ItemConnection! """ @@ -35397,6 +35882,21 @@ type ProjectV2Edge { node: ProjectV2 } +""" +Represents an event related to a project on the timeline of an issue or pull request. +""" +interface ProjectV2Event { + """ + Project referenced by event. + """ + project: ProjectV2 + + """ + Did this event result from workflow automation? + """ + wasAutomated: Boolean! +} + """ A field inside a project. """ @@ -36319,7 +36819,7 @@ type ProjectV2ItemFieldUserValue { Project field values """ union ProjectV2ItemFieldValue = - ProjectV2ItemFieldDateValue + | ProjectV2ItemFieldDateValue | ProjectV2ItemFieldIterationValue | ProjectV2ItemFieldLabelValue | ProjectV2ItemFieldMilestoneValue @@ -36461,6 +36961,46 @@ enum ProjectV2ItemOrderField { POSITION } +""" +Represents a 'project_v2_item_status_changed' event on a given issue or pull request. +""" +type ProjectV2ItemStatusChangedEvent implements Node & ProjectV2Event { + """ + Identifies the actor who performed the event. + """ + actor: Actor + + """ + Identifies the date and time when the object was created. + """ + createdAt: DateTime! + + """ + The Node ID of the ProjectV2ItemStatusChangedEvent object + """ + id: ID! + + """ + The previous status of the project item. + """ + previousStatus: String! + + """ + Project referenced by event. + """ + project: ProjectV2 + + """ + The new status of the project item. + """ + status: String! + + """ + Did this event result from workflow automation? + """ + wasAutomated: Boolean! +} + """ The type of a project item. """ @@ -37767,6 +38307,36 @@ enum ProjectV2WorkflowsOrderField { UPDATED_AT } +""" +Autogenerated input type of PromoteRepositoryCustomProperty +""" +input PromoteRepositoryCustomPropertyInput { + """ + A unique identifier for the client performing the mutation. + """ + clientMutationId: String + + """ + The ID of the repository custom property to be promoted. + """ + repositoryCustomPropertyId: ID! @possibleTypes(concreteTypes: ["RepositoryCustomProperty"]) +} + +""" +Autogenerated return type of PromoteRepositoryCustomProperty. +""" +type PromoteRepositoryCustomPropertyPayload { + """ + A unique identifier for the client performing the mutation. + """ + clientMutationId: String + + """ + The repository custom property that has been promoted. + """ + repositoryCustomProperty: RepositoryCustomProperty +} + """ A property that must match """ @@ -38748,6 +39318,31 @@ type PullRequest implements Assignable & Closable & Comment & Labelable & Lockab query: String ): AssigneeConnection! + """ + Reviewer actor suggestions based on commit history, past review comments, and integrations. + """ + suggestedReviewerActors( + """ + Returns the elements in the list that come after the specified cursor. + """ + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """ + Returns the first _n_ elements from the list. + """ + first: Int + + """ + Returns the last _n_ elements from the list. + """ + last: Int + ): SuggestedReviewerActorConnection! + """ A list of reviewer suggestions based on commit history and past review comments. """ @@ -39361,11 +39956,6 @@ type PullRequestParameters { """ allowedMergeMethods: [PullRequestAllowedMergeMethods!] - """ - Request Copilot code review for new pull requests automatically if the author has access to Copilot code review. - """ - automaticCopilotCodeReviewEnabled: Boolean! - """ New, reviewable commits pushed will dismiss previous pull request review approvals. """ @@ -39390,6 +39980,13 @@ type PullRequestParameters { All conversations on code must be resolved before a pull request can be merged. """ requiredReviewThreadResolution: Boolean! + + """ + This field is in beta and subject to change. A collection of reviewers and + associated file patterns. Each reviewer has a list of file patterns which + determine the files that reviewer is required to review. + """ + requiredReviewers: [RequiredReviewerConfiguration!] } """ @@ -39402,11 +39999,6 @@ input PullRequestParametersInput { """ allowedMergeMethods: [PullRequestAllowedMergeMethods!] - """ - Request Copilot code review for new pull requests automatically if the author has access to Copilot code review. - """ - automaticCopilotCodeReviewEnabled: Boolean - """ New, reviewable commits pushed will dismiss previous pull request review approvals. """ @@ -39431,6 +40023,13 @@ input PullRequestParametersInput { All conversations on code must be resolved before a pull request can be merged. """ requiredReviewThreadResolution: Boolean! + + """ + This argument is in beta and subject to change. A collection of reviewers and + associated file patterns. Each reviewer has a list of file patterns which + determine the files that reviewer is required to review. + """ + requiredReviewers: [RequiredReviewerConfigurationInput!] } """ @@ -40611,7 +41210,7 @@ type PullRequestTimelineConnection { An item in a pull request timeline """ union PullRequestTimelineItem = - AssignedEvent + | AssignedEvent | BaseRefDeletedEvent | BaseRefForcePushedEvent | ClosedEvent @@ -40664,8 +41263,9 @@ type PullRequestTimelineItemEdge { An item in a pull request timeline """ union PullRequestTimelineItems = - AddedToMergeQueueEvent + | AddedToMergeQueueEvent | AddedToProjectEvent + | AddedToProjectV2Event | AssignedEvent | AutoMergeDisabledEvent | AutoMergeEnabledEvent @@ -40684,6 +41284,7 @@ union PullRequestTimelineItems = | CommentDeletedEvent | ConnectedEvent | ConvertToDraftEvent + | ConvertedFromDraftEvent | ConvertedNoteToIssueEvent | ConvertedToDiscussionEvent | CrossReferencedEvent @@ -40708,6 +41309,7 @@ union PullRequestTimelineItems = | ParentIssueAddedEvent | ParentIssueRemovedEvent | PinnedEvent + | ProjectV2ItemStatusChangedEvent | PullRequestCommit | PullRequestCommitCommentThread | PullRequestReview @@ -40717,6 +41319,7 @@ union PullRequestTimelineItems = | ReferencedEvent | RemovedFromMergeQueueEvent | RemovedFromProjectEvent + | RemovedFromProjectV2Event | RenamedTitleEvent | ReopenedEvent | ReviewDismissedEvent @@ -40803,6 +41406,11 @@ enum PullRequestTimelineItemsItemType { """ ADDED_TO_PROJECT_EVENT + """ + Represents a 'added_to_project_v2' event on a given issue or pull request. + """ + ADDED_TO_PROJECT_V2_EVENT + """ Represents an 'assigned' event on any assignable object. """ @@ -40888,6 +41496,11 @@ enum PullRequestTimelineItemsItemType { """ CONNECTED_EVENT + """ + Represents a 'converted_from_draft' event on a given issue or pull request. + """ + CONVERTED_FROM_DRAFT_EVENT + """ Represents a 'converted_note_to_issue' event on a given issue or pull request. """ @@ -40948,6 +41561,21 @@ enum PullRequestTimelineItemsItemType { """ ISSUE_COMMENT + """ + Represents a 'issue_field_added' event on a given issue. + """ + ISSUE_FIELD_ADDED_EVENT + + """ + Represents a 'issue_field_changed' event on a given issue. + """ + ISSUE_FIELD_CHANGED_EVENT + + """ + Represents a 'issue_field_removed' event on a given issue. + """ + ISSUE_FIELD_REMOVED_EVENT + """ Represents a 'issue_type_added' event on a given issue. """ @@ -41013,6 +41641,11 @@ enum PullRequestTimelineItemsItemType { """ PINNED_EVENT + """ + Represents a 'project_v2_item_status_changed' event on a given issue or pull request. + """ + PROJECT_V2_ITEM_STATUS_CHANGED_EVENT + """ Represents a Git commit part of a pull request. """ @@ -41058,6 +41691,11 @@ enum PullRequestTimelineItemsItemType { """ REMOVED_FROM_PROJECT_EVENT + """ + Represents a 'removed_from_project_v2' event on a given issue or pull request. + """ + REMOVED_FROM_PROJECT_V2_EVENT + """ Represents a 'renamed' event on a given issue or pull request """ @@ -42912,9 +43550,13 @@ input RemoveAssigneesFromAssignableInput { assignableId: ID! @possibleTypes(concreteTypes: ["Issue", "PullRequest"], abstractType: "Assignable") """ - The id of users to remove as assignees. + The ids of actors to remove as assignees. """ - assigneeIds: [ID!]! @possibleTypes(concreteTypes: ["User"]) + assigneeIds: [ID!]! + @possibleTypes( + concreteTypes: ["Bot", "EnterpriseUserAccount", "Mannequin", "Organization", "User"] + abstractType: "Actor" + ) """ A unique identifier for the client performing the mutation. @@ -43347,6 +43989,36 @@ type RemovedFromProjectEvent implements Node { ) } +""" +Represents a 'removed_from_project_v2' event on a given issue or pull request. +""" +type RemovedFromProjectV2Event implements Node & ProjectV2Event { + """ + Identifies the actor who performed the event. + """ + actor: Actor + + """ + Identifies the date and time when the object was created. + """ + createdAt: DateTime! + + """ + The Node ID of the RemovedFromProjectV2Event object + """ + id: ID! + + """ + Project referenced by event. + """ + project: ProjectV2 + + """ + Did this event result from workflow automation? + """ + wasAutomated: Boolean! +} + """ Represents a 'renamed' event on a given issue or pull request """ @@ -48419,6 +49091,41 @@ type Repository implements Node & PackageOwner & ProjectOwner & ProjectV2Recent orderBy: ReleaseOrder ): ReleaseConnection! + """ + A custom property value for the repository. + """ + repositoryCustomPropertyValue( + """ + The name of the custom property to retrieve the value for. + """ + propertyName: String! + ): RepositoryCustomPropertyValue + + """ + A list of custom properties and their associated values for a repository. + """ + repositoryCustomPropertyValues( + """ + Returns the elements in the list that come after the specified cursor. + """ + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """ + Returns the first _n_ elements from the list. + """ + first: Int + + """ + Returns the last _n_ elements from the list. + """ + last: Int + ): RepositoryCustomPropertyValueConnection + """ A list of applied repository-topic associations for this repository. """ @@ -49030,6 +49737,171 @@ enum RepositoryContributionType { REPOSITORY } +""" +A repository custom property. +""" +type RepositoryCustomProperty implements Node { + """ + The allowed values for the custom property. Required if `value_type` is `single_select` or `multi_select`. + """ + allowedValues: [String!] + + """ + The default value of the custom property, if the property is `required`. + """ + defaultValue: CustomPropertyValue + + """ + The description of the custom property. + """ + description: String + + """ + The Node ID of the RepositoryCustomProperty object + """ + id: ID! + + """ + The name of the custom property. + """ + propertyName: String! + + """ + The regex pattern that the value of the custom property must match, if the `value_type` is `string`. + """ + regex: String + + """ + Whether the custom property is required. + """ + required: Boolean + + """ + The source type of the custom property. + """ + source: CustomPropertySource! + + """ + The value type of the custom property. + """ + valueType: CustomPropertyValueType! + + """ + Who can edit the values of this repository custom property. + """ + valuesEditableBy: RepositoryCustomPropertyValuesEditableBy! +} + +""" +The connection type for RepositoryCustomProperty. +""" +type RepositoryCustomPropertyConnection { + """ + A list of edges. + """ + edges: [RepositoryCustomPropertyEdge] + + """ + A list of nodes. + """ + nodes: [RepositoryCustomProperty] + + """ + Information to aid in pagination. + """ + pageInfo: PageInfo! + + """ + Identifies the total count of items in the connection. + """ + totalCount: Int! +} + +""" +An edge in a connection. +""" +type RepositoryCustomPropertyEdge { + """ + A cursor for use in pagination. + """ + cursor: String! + + """ + The item at the end of the edge. + """ + node: RepositoryCustomProperty +} + +""" +A value associated with a repository custom property. +""" +type RepositoryCustomPropertyValue { + """ + The name of the custom property. + """ + propertyName: String! + + """ + The value of the custom property. + """ + value: CustomPropertyValue! +} + +""" +The connection type for RepositoryCustomPropertyValue. +""" +type RepositoryCustomPropertyValueConnection { + """ + A list of edges. + """ + edges: [RepositoryCustomPropertyValueEdge] + + """ + A list of nodes. + """ + nodes: [RepositoryCustomPropertyValue] + + """ + Information to aid in pagination. + """ + pageInfo: PageInfo! + + """ + Identifies the total count of items in the connection. + """ + totalCount: Int! +} + +""" +An edge in a connection. +""" +type RepositoryCustomPropertyValueEdge { + """ + A cursor for use in pagination. + """ + cursor: String! + + """ + The item at the end of the edge. + """ + node: RepositoryCustomPropertyValue +} + +""" +The allowed actors who can edit the values of a custom property. +""" +enum RepositoryCustomPropertyValuesEditableBy { + """ + The organization actors. + """ + ORG_ACTORS + + """ + The organization and repository actors. + """ + ORG_AND_REPO_ACTORS +} + """ Represents an author of discussions in repositories. """ @@ -49966,6 +50838,11 @@ type RepositoryRule implements Node { Set of conditions that determine if a ruleset will evaluate """ type RepositoryRuleConditions { + """ + Configuration for the organization_property condition + """ + organizationProperty: OrganizationPropertyConditionTarget + """ Configuration for the ref_name condition """ @@ -49991,6 +50868,11 @@ type RepositoryRuleConditions { Specifies the conditions required for a ruleset to evaluate """ input RepositoryRuleConditionsInput { + """ + Configuration for the organization_property condition + """ + organizationProperty: OrganizationPropertyConditionTargetInput + """ Configuration for the ref_name condition """ @@ -50144,7 +51026,9 @@ enum RepositoryRuleType { COMMIT_MESSAGE_PATTERN """ - Request Copilot code review for new pull requests automatically if the author has access to Copilot code review. + Request Copilot code review for new pull requests automatically if the author + has access to Copilot code review and their premium requests quota has not + reached the limit. """ COPILOT_CODE_REVIEW @@ -51407,6 +52291,50 @@ input RequiredDeploymentsParametersInput { requiredDeploymentEnvironments: [String!]! } +""" +A reviewing team, and file patterns describing which files they must approve changes to. +""" +type RequiredReviewerConfiguration { + """ + Array of file patterns. Pull requests which change matching files must be + approved by the specified team. File patterns use fnmatch syntax. + """ + filePatterns: [String!]! + + """ + Minimum number of approvals required from the specified team. If set to zero, + the team will be added to the pull request but approval is optional. + """ + minimumApprovals: Int! + + """ + Node ID of the team which must review changes to matching files. + """ + reviewerId: ID! +} + +""" +A reviewing team, and file patterns describing which files they must approve changes to. +""" +input RequiredReviewerConfigurationInput { + """ + Array of file patterns. Pull requests which change matching files must be + approved by the specified team. File patterns use fnmatch syntax. + """ + filePatterns: [String!]! + + """ + Minimum number of approvals required from the specified team. If set to zero, + the team will be added to the pull request but approval is optional. + """ + minimumApprovals: Int! + + """ + Node ID of the team which must review changes to matching files. + """ + reviewerId: ID! +} + """ Represents a required status check for a protected branch, but not any specific run of that check. """ @@ -52053,7 +52981,7 @@ enum RuleEnforcement { Types which can be parameters for `RepositoryRule` objects. """ union RuleParameters = - BranchNamePatternParameters + | BranchNamePatternParameters | CodeScanningParameters | CommitAuthorEmailPatternParameters | CommitMessagePatternParameters @@ -52421,9 +53349,6 @@ enum SearchType { Returns results matching issues in repositories. """ ISSUE_ADVANCED - @deprecated( - reason: "Search for issues and pull requests will be overridden by advanced search on November 4, 2025. You can read more about this change on https://github.blog/changelog/2025-03-06-github-issues-projects-api-support-for-issues-advanced-search-and-more/. Removal on 2025-11-04 UTC." - ) """ Returns results matching repositories. @@ -52880,6 +53805,41 @@ type SecurityVulnerabilityEdge { node: SecurityVulnerability } +""" +Autogenerated input type of SetRepositoryCustomPropertyValues +""" +input SetRepositoryCustomPropertyValuesInput { + """ + A unique identifier for the client performing the mutation. + """ + clientMutationId: String + + """ + A list of custom property names and associated values to apply. + """ + properties: [CustomPropertyValueInput!]! + + """ + The ID of the repository to set properties for. + """ + repositoryId: ID! @possibleTypes(concreteTypes: ["Repository"]) +} + +""" +Autogenerated return type of SetRepositoryCustomPropertyValues. +""" +type SetRepositoryCustomPropertyValuesPayload { + """ + A unique identifier for the client performing the mutation. + """ + clientMutationId: String + + """ + The repository that the custom properties were set for. + """ + repository: Repository +} + """ Represents an S/MIME signature on a Commit or Tag. """ @@ -54044,6 +55004,66 @@ type SuggestedReviewer { reviewer: User! } +""" +A suggestion to review a pull request based on an actor's commit history, review comments, and integrations. +""" +type SuggestedReviewerActor { + """ + Is this suggestion based on past commits? + """ + isAuthor: Boolean! + + """ + Is this suggestion based on past review comments? + """ + isCommenter: Boolean! + + """ + Identifies the actor suggested to review the pull request. + """ + reviewer: Actor! +} + +""" +A suggestion to review a pull request based on an actor's commit history, review comments, and integrations. +""" +type SuggestedReviewerActorConnection { + """ + A list of edges. + """ + edges: [SuggestedReviewerActorEdge] + + """ + A list of nodes. + """ + nodes: [SuggestedReviewerActor] + + """ + Information to aid in pagination. + """ + pageInfo: PageInfo! + + """ + Identifies the total count of items in the connection. + """ + totalCount: Int! +} + +""" +An edge in a connection. +""" +type SuggestedReviewerActorEdge { + """ + A cursor for use in pagination. + """ + cursor: String! + + """ + The item at the end of the edge. + """ + node: SuggestedReviewerActor +} + """ Represents a Git tag. """ @@ -59160,9 +60180,13 @@ Autogenerated input type of UpdateIssue """ input UpdateIssueInput { """ - An array of Node IDs of users for this issue. + An array of Node IDs of users or bots for this issue. """ - assigneeIds: [ID!] @possibleTypes(concreteTypes: ["User"]) + assigneeIds: [ID!] + @possibleTypes( + concreteTypes: ["Bot", "EnterpriseUserAccount", "Mannequin", "Organization", "User"] + abstractType: "Actor" + ) """ The body for the issue description. @@ -59739,7 +60763,9 @@ input UpdateProjectV2FieldInput { ) """ - Configuration for an iteration field. + Configuration for a field of type ITERATION. Empty input is ignored, provided + values overwrite the existing configuration, and existing configuration should + be fetched for partial updates. """ iterationConfiguration: ProjectV2IterationFieldConfigurationInput @@ -59749,9 +60775,9 @@ input UpdateProjectV2FieldInput { name: String """ - Options for a field of type SINGLE_SELECT. If empty, no changes will be made - to the options. If values are present, they will overwrite the existing - options for the field. + Options for a field of type SINGLE_SELECT. Empty input is ignored, provided + values overwrite existing options, and existing options should be fetched for + partial updates. """ singleSelectOptions: [ProjectV2SingleSelectFieldOptionInput!] } @@ -60246,6 +61272,66 @@ type UpdateRefsPayload { clientMutationId: String } +""" +Autogenerated input type of UpdateRepositoryCustomProperty +""" +input UpdateRepositoryCustomPropertyInput { + """ + The updated allowed values for the custom property. + """ + allowedValues: [String!] + + """ + A unique identifier for the client performing the mutation. + """ + clientMutationId: String + + """ + The updated default value for the custom property if the property is required. + """ + defaultValue: String + + """ + The updated description of the custom property. + """ + description: String + + """ + The regex pattern that the value of the custom property must match, if the `value_type` is `string`. + """ + regex: String + + """ + The global relay id of the source of the custom property. + """ + repositoryCustomPropertyId: ID! @possibleTypes(concreteTypes: ["RepositoryCustomProperty"]) + + """ + Whether the updated custom property is required. + """ + required: Boolean + + """ + The updated actors who can edit the values of the custom property. + """ + valuesEditableBy: RepositoryCustomPropertyValuesEditableBy +} + +""" +Autogenerated return type of UpdateRepositoryCustomProperty. +""" +type UpdateRepositoryCustomPropertyPayload { + """ + A unique identifier for the client performing the mutation. + """ + clientMutationId: String + + """ + The updated repository custom property. + """ + repositoryCustomProperty: RepositoryCustomProperty +} + """ Autogenerated input type of UpdateRepository """ @@ -60800,7 +61886,7 @@ type UpdateUserListsForItemPayload { """ A user is an individual's account on GitHub that owns repositories and can make new content. """ -type User implements Actor & Node & PackageOwner & ProfileOwner & ProjectOwner & ProjectV2Owner & ProjectV2Recent & RepositoryDiscussionAuthor & RepositoryDiscussionCommentAuthor & RepositoryOwner & UniformResourceLocatable { +type User implements Actor & Agentic & Node & PackageOwner & ProfileOwner & ProjectOwner & ProjectV2Owner & ProjectV2Recent & RepositoryDiscussionAuthor & RepositoryDiscussionCommentAuthor & RepositoryOwner & UniformResourceLocatable { """ Determine if this repository owner has any items that can be pinned to their profile. """ @@ -62047,6 +63133,21 @@ type User implements Actor & Node & PackageOwner & ProfileOwner & ProjectOwner & """ viewerCanFollow: Boolean! + """ + Channel value for subscribing to live updates for session creations. + """ + viewerCopilotAgentCreatesChannel: String + + """ + Channel value for subscribing to live updates for session log updates. + """ + viewerCopilotAgentLogUpdatesChannel: String + + """ + Channel value for subscribing to live updates for session updates. + """ + viewerCopilotAgentUpdatesChannel: String + """ Whether or not this user is followed by the viewer. Inverse of isFollowingViewer. """ diff --git a/src/graphql/data/ghes-3.20/schema.json b/src/graphql/data/ghes-3.20/schema.json index 465bb805cb99..3776124f88a1 100644 --- a/src/graphql/data/ghes-3.20/schema.json +++ b/src/graphql/data/ghes-3.20/schema.json @@ -2942,6 +2942,40 @@ } ] }, + { + "name": "createRepositoryCustomProperty", + "kind": "mutations", + "id": "createrepositorycustomproperty", + "href": "/graphql/reference/mutations#createrepositorycustomproperty", + "description": "

Create a repository custom property.

", + "inputFields": [ + { + "name": "input", + "type": "CreateRepositoryCustomPropertyInput!", + "id": "createrepositorycustompropertyinput", + "kind": "input-objects", + "href": "/graphql/reference/input-objects#createrepositorycustompropertyinput" + } + ], + "returnFields": [ + { + "name": "clientMutationId", + "type": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string", + "description": "

A unique identifier for the client performing the mutation.

" + }, + { + "name": "repositoryCustomProperty", + "type": "RepositoryCustomProperty", + "id": "repositorycustomproperty", + "kind": "objects", + "href": "/graphql/reference/objects#repositorycustomproperty", + "description": "

The newly created repository custom property.

" + } + ] + }, { "name": "createRepositoryRuleset", "kind": "mutations", @@ -3870,6 +3904,40 @@ } ] }, + { + "name": "deleteRepositoryCustomProperty", + "kind": "mutations", + "id": "deleterepositorycustomproperty", + "href": "/graphql/reference/mutations#deleterepositorycustomproperty", + "description": "

Delete a repository custom property.

", + "inputFields": [ + { + "name": "input", + "type": "DeleteRepositoryCustomPropertyInput!", + "id": "deleterepositorycustompropertyinput", + "kind": "input-objects", + "href": "/graphql/reference/input-objects#deleterepositorycustompropertyinput" + } + ], + "returnFields": [ + { + "name": "clientMutationId", + "type": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string", + "description": "

A unique identifier for the client performing the mutation.

" + }, + { + "name": "repositoryCustomProperty", + "type": "RepositoryCustomProperty", + "id": "repositorycustomproperty", + "kind": "objects", + "href": "/graphql/reference/objects#repositorycustomproperty", + "description": "

The deleted custom property.

" + } + ] + }, { "name": "deleteRepositoryRuleset", "kind": "mutations", @@ -4956,6 +5024,40 @@ } ] }, + { + "name": "promoteRepositoryCustomProperty", + "kind": "mutations", + "id": "promoterepositorycustomproperty", + "href": "/graphql/reference/mutations#promoterepositorycustomproperty", + "description": "

Promote a repository custom property to the enterprise level.

", + "inputFields": [ + { + "name": "input", + "type": "PromoteRepositoryCustomPropertyInput!", + "id": "promoterepositorycustompropertyinput", + "kind": "input-objects", + "href": "/graphql/reference/input-objects#promoterepositorycustompropertyinput" + } + ], + "returnFields": [ + { + "name": "clientMutationId", + "type": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string", + "description": "

A unique identifier for the client performing the mutation.

" + }, + { + "name": "repositoryCustomProperty", + "type": "RepositoryCustomProperty", + "id": "repositorycustomproperty", + "kind": "objects", + "href": "/graphql/reference/objects#repositorycustomproperty", + "description": "

The repository custom property that has been promoted.

" + } + ] + }, { "name": "regenerateVerifiableDomainToken", "kind": "mutations", @@ -5818,6 +5920,40 @@ } ] }, + { + "name": "setRepositoryCustomPropertyValues", + "kind": "mutations", + "id": "setrepositorycustompropertyvalues", + "href": "/graphql/reference/mutations#setrepositorycustompropertyvalues", + "description": "

Set repository custom property values for a repository.

", + "inputFields": [ + { + "name": "input", + "type": "SetRepositoryCustomPropertyValuesInput!", + "id": "setrepositorycustompropertyvaluesinput", + "kind": "input-objects", + "href": "/graphql/reference/input-objects#setrepositorycustompropertyvaluesinput" + } + ], + "returnFields": [ + { + "name": "clientMutationId", + "type": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string", + "description": "

A unique identifier for the client performing the mutation.

" + }, + { + "name": "repository", + "type": "Repository", + "id": "repository", + "kind": "objects", + "href": "/graphql/reference/objects#repository", + "description": "

The repository that the custom properties were set for.

" + } + ] + }, { "name": "startOrganizationMigration", "kind": "mutations", @@ -8416,6 +8552,40 @@ } ] }, + { + "name": "updateRepositoryCustomProperty", + "kind": "mutations", + "id": "updaterepositorycustomproperty", + "href": "/graphql/reference/mutations#updaterepositorycustomproperty", + "description": "

Update a repository custom property.

", + "inputFields": [ + { + "name": "input", + "type": "UpdateRepositoryCustomPropertyInput!", + "id": "updaterepositorycustompropertyinput", + "kind": "input-objects", + "href": "/graphql/reference/input-objects#updaterepositorycustompropertyinput" + } + ], + "returnFields": [ + { + "name": "clientMutationId", + "type": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string", + "description": "

A unique identifier for the client performing the mutation.

" + }, + { + "name": "repositoryCustomProperty", + "type": "RepositoryCustomProperty", + "id": "repositorycustomproperty", + "kind": "objects", + "href": "/graphql/reference/objects#repositorycustomproperty", + "description": "

The updated repository custom property.

" + } + ] + }, { "name": "updateRepositoryRuleset", "kind": "mutations", @@ -9091,6 +9261,67 @@ } ] }, + { + "name": "AddedToProjectV2Event", + "kind": "objects", + "id": "addedtoprojectv2event", + "href": "/graphql/reference/objects#addedtoprojectv2event", + "description": "

Represents aadded_to_project_v2event on a given issue or pull request.

", + "implements": [ + { + "name": "Node", + "id": "node", + "href": "/graphql/reference/interfaces#node" + }, + { + "name": "ProjectV2Event", + "id": "projectv2event", + "href": "/graphql/reference/interfaces#projectv2event" + } + ], + "fields": [ + { + "name": "actor", + "description": "

Identifies the actor who performed the event.

", + "type": "Actor", + "id": "actor", + "kind": "interfaces", + "href": "/graphql/reference/interfaces#actor" + }, + { + "name": "createdAt", + "description": "

Identifies the date and time when the object was created.

", + "type": "DateTime!", + "id": "datetime", + "kind": "scalars", + "href": "/graphql/reference/scalars#datetime" + }, + { + "name": "id", + "description": "

The Node ID of the AddedToProjectV2Event object.

", + "type": "ID!", + "id": "id", + "kind": "scalars", + "href": "/graphql/reference/scalars#id" + }, + { + "name": "project", + "description": "

Project referenced by event.

", + "type": "ProjectV2", + "id": "projectv2", + "kind": "objects", + "href": "/graphql/reference/objects#projectv2" + }, + { + "name": "wasAutomated", + "description": "

Did this event result from workflow automation?.

", + "type": "Boolean!", + "id": "boolean", + "kind": "scalars", + "href": "/graphql/reference/scalars#boolean" + } + ] + }, { "name": "AnnouncementBanner", "kind": "objects", @@ -16007,6 +16238,67 @@ } ] }, + { + "name": "ConvertedFromDraftEvent", + "kind": "objects", + "id": "convertedfromdraftevent", + "href": "/graphql/reference/objects#convertedfromdraftevent", + "description": "

Represents aconverted_from_draftevent on a given issue or pull request.

", + "implements": [ + { + "name": "Node", + "id": "node", + "href": "/graphql/reference/interfaces#node" + }, + { + "name": "ProjectV2Event", + "id": "projectv2event", + "href": "/graphql/reference/interfaces#projectv2event" + } + ], + "fields": [ + { + "name": "actor", + "description": "

Identifies the actor who performed the event.

", + "type": "Actor", + "id": "actor", + "kind": "interfaces", + "href": "/graphql/reference/interfaces#actor" + }, + { + "name": "createdAt", + "description": "

Identifies the date and time when the object was created.

", + "type": "DateTime!", + "id": "datetime", + "kind": "scalars", + "href": "/graphql/reference/scalars#datetime" + }, + { + "name": "id", + "description": "

The Node ID of the ConvertedFromDraftEvent object.

", + "type": "ID!", + "id": "id", + "kind": "scalars", + "href": "/graphql/reference/scalars#id" + }, + { + "name": "project", + "description": "

Project referenced by event.

", + "type": "ProjectV2", + "id": "projectv2", + "kind": "objects", + "href": "/graphql/reference/objects#projectv2" + }, + { + "name": "wasAutomated", + "description": "

Did this event result from workflow automation?.

", + "type": "Boolean!", + "id": "boolean", + "kind": "scalars", + "href": "/graphql/reference/scalars#boolean" + } + ] + }, { "name": "ConvertedNoteToIssueEvent", "kind": "objects", @@ -16136,7 +16428,7 @@ "kind": "objects", "id": "copilotcodereviewparameters", "href": "/graphql/reference/objects#copilotcodereviewparameters", - "description": "

Request Copilot code review for new pull requests automatically if the author has access to Copilot code review.

", + "description": "

Request Copilot code review for new pull requests automatically if the author\nhas access to Copilot code review and their premium requests quota has not\nreached the limit.

", "fields": [ { "name": "reviewDraftPullRequests", @@ -21046,6 +21338,76 @@ "kind": "scalars", "href": "/graphql/reference/scalars#html" }, + { + "name": "repositoryCustomProperties", + "description": "

A list of repository custom properties for this enterprise.

", + "type": "RepositoryCustomPropertyConnection", + "id": "repositorycustompropertyconnection", + "kind": "objects", + "href": "/graphql/reference/objects#repositorycustompropertyconnection", + "arguments": [ + { + "name": "after", + "description": "

Returns the elements in the list that come after the specified cursor.

", + "type": { + "name": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + } + }, + { + "name": "before", + "description": "

Returns the elements in the list that come before the specified cursor.

", + "type": { + "name": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + } + }, + { + "name": "first", + "description": "

Returns the first n elements from the list.

", + "type": { + "name": "Int", + "id": "int", + "kind": "scalars", + "href": "/graphql/reference/scalars#int" + } + }, + { + "name": "last", + "description": "

Returns the last n elements from the list.

", + "type": { + "name": "Int", + "id": "int", + "kind": "scalars", + "href": "/graphql/reference/scalars#int" + } + } + ] + }, + { + "name": "repositoryCustomProperty", + "description": "

Returns a single repository custom property for the current enterprise by name.

", + "type": "RepositoryCustomProperty", + "id": "repositorycustomproperty", + "kind": "objects", + "href": "/graphql/reference/objects#repositorycustomproperty", + "arguments": [ + { + "name": "propertyName", + "description": "

The name of the repository custom property to be returned.

", + "type": { + "name": "String!", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + } + } + ] + }, { "name": "resourcePath", "description": "

The HTTP path for this enterprise.

", @@ -29562,6 +29924,22 @@ "id": "int", "kind": "scalars", "href": "/graphql/reference/scalars#int" + }, + { + "name": "totalBlockedBy", + "description": "

Total count of issues this issue is blocked by (open and closed).

", + "type": "Int!", + "id": "int", + "kind": "scalars", + "href": "/graphql/reference/scalars#int" + }, + { + "name": "totalBlocking", + "description": "

Total count of issues this issue is blocking (open and closed).

", + "type": "Int!", + "id": "int", + "kind": "scalars", + "href": "/graphql/reference/scalars#int" } ] }, @@ -41664,6 +42042,76 @@ } ] }, + { + "name": "repositoryCustomProperties", + "description": "

A list of custom properties for this organization.

", + "type": "RepositoryCustomPropertyConnection", + "id": "repositorycustompropertyconnection", + "kind": "objects", + "href": "/graphql/reference/objects#repositorycustompropertyconnection", + "arguments": [ + { + "name": "after", + "description": "

Returns the elements in the list that come after the specified cursor.

", + "type": { + "name": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + } + }, + { + "name": "before", + "description": "

Returns the elements in the list that come before the specified cursor.

", + "type": { + "name": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + } + }, + { + "name": "first", + "description": "

Returns the first n elements from the list.

", + "type": { + "name": "Int", + "id": "int", + "kind": "scalars", + "href": "/graphql/reference/scalars#int" + } + }, + { + "name": "last", + "description": "

Returns the last n elements from the list.

", + "type": { + "name": "Int", + "id": "int", + "kind": "scalars", + "href": "/graphql/reference/scalars#int" + } + } + ] + }, + { + "name": "repositoryCustomProperty", + "description": "

Returns a single custom property from the current organization by name.

", + "type": "RepositoryCustomProperty", + "id": "repositorycustomproperty", + "kind": "objects", + "href": "/graphql/reference/objects#repositorycustomproperty", + "arguments": [ + { + "name": "propertyName", + "description": "

The name of the custom property to be returned.

", + "type": { + "name": "String!", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + } + } + ] + }, { "name": "repositoryDiscussionComments", "description": "

Discussion comments this user has authored.

", @@ -42998,6 +43446,56 @@ } ] }, + { + "name": "OrganizationPropertyConditionTarget", + "kind": "objects", + "id": "organizationpropertyconditiontarget", + "href": "/graphql/reference/objects#organizationpropertyconditiontarget", + "description": "

Parameters to be used for the organization_property condition.

", + "fields": [ + { + "name": "exclude", + "description": "

Array of organization properties that must not match.

", + "type": "[OrganizationPropertyTargetDefinition!]!", + "id": "organizationpropertytargetdefinition", + "kind": "objects", + "href": "/graphql/reference/objects#organizationpropertytargetdefinition" + }, + { + "name": "include", + "description": "

Array of organization properties that must match.

", + "type": "[OrganizationPropertyTargetDefinition!]!", + "id": "organizationpropertytargetdefinition", + "kind": "objects", + "href": "/graphql/reference/objects#organizationpropertytargetdefinition" + } + ] + }, + { + "name": "OrganizationPropertyTargetDefinition", + "kind": "objects", + "id": "organizationpropertytargetdefinition", + "href": "/graphql/reference/objects#organizationpropertytargetdefinition", + "description": "

A property that must match.

", + "fields": [ + { + "name": "name", + "description": "

The name of the property.

", + "type": "String!", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "propertyValues", + "description": "

The values to match for.

", + "type": "[String!]!", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + } + ] + }, { "name": "OrganizationTeamsHovercardContext", "kind": "objects", @@ -46312,6 +46810,17 @@ "kind": "input-objects", "href": "/graphql/reference/input-objects#projectv2itemorder" } + }, + { + "name": "query", + "defaultValue": "", + "description": "

Search query for filtering items.

", + "type": { + "name": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + } } ] }, @@ -48237,6 +48746,83 @@ } ] }, + { + "name": "ProjectV2ItemStatusChangedEvent", + "kind": "objects", + "id": "projectv2itemstatuschangedevent", + "href": "/graphql/reference/objects#projectv2itemstatuschangedevent", + "description": "

Represents aproject_v2_item_status_changedevent on a given issue or pull request.

", + "implements": [ + { + "name": "Node", + "id": "node", + "href": "/graphql/reference/interfaces#node" + }, + { + "name": "ProjectV2Event", + "id": "projectv2event", + "href": "/graphql/reference/interfaces#projectv2event" + } + ], + "fields": [ + { + "name": "actor", + "description": "

Identifies the actor who performed the event.

", + "type": "Actor", + "id": "actor", + "kind": "interfaces", + "href": "/graphql/reference/interfaces#actor" + }, + { + "name": "createdAt", + "description": "

Identifies the date and time when the object was created.

", + "type": "DateTime!", + "id": "datetime", + "kind": "scalars", + "href": "/graphql/reference/scalars#datetime" + }, + { + "name": "id", + "description": "

The Node ID of the ProjectV2ItemStatusChangedEvent object.

", + "type": "ID!", + "id": "id", + "kind": "scalars", + "href": "/graphql/reference/scalars#id" + }, + { + "name": "previousStatus", + "description": "

The previous status of the project item.

", + "type": "String!", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "project", + "description": "

Project referenced by event.

", + "type": "ProjectV2", + "id": "projectv2", + "kind": "objects", + "href": "/graphql/reference/objects#projectv2" + }, + { + "name": "status", + "description": "

The new status of the project item.

", + "type": "String!", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "wasAutomated", + "description": "

Did this event result from workflow automation?.

", + "type": "Boolean!", + "id": "boolean", + "kind": "scalars", + "href": "/graphql/reference/scalars#boolean" + } + ] + }, { "name": "ProjectV2IterationField", "kind": "objects", @@ -51540,6 +52126,56 @@ } ] }, + { + "name": "suggestedReviewerActors", + "description": "

Reviewer actor suggestions based on commit history, past review comments, and integrations.

", + "type": "SuggestedReviewerActorConnection!", + "id": "suggestedrevieweractorconnection", + "kind": "objects", + "href": "/graphql/reference/objects#suggestedrevieweractorconnection", + "arguments": [ + { + "name": "after", + "description": "

Returns the elements in the list that come after the specified cursor.

", + "type": { + "name": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + } + }, + { + "name": "before", + "description": "

Returns the elements in the list that come before the specified cursor.

", + "type": { + "name": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + } + }, + { + "name": "first", + "description": "

Returns the first n elements from the list.

", + "type": { + "name": "Int", + "id": "int", + "kind": "scalars", + "href": "/graphql/reference/scalars#int" + } + }, + { + "name": "last", + "description": "

Returns the last n elements from the list.

", + "type": { + "name": "Int", + "id": "int", + "kind": "scalars", + "href": "/graphql/reference/scalars#int" + } + } + ] + }, { "name": "suggestedReviewers", "description": "

A list of reviewer suggestions based on commit history and past review comments.

", @@ -52485,14 +53121,6 @@ "kind": "enums", "href": "/graphql/reference/enums#pullrequestallowedmergemethods" }, - { - "name": "automaticCopilotCodeReviewEnabled", - "description": "

Request Copilot code review for new pull requests automatically if the author has access to Copilot code review.

", - "type": "Boolean!", - "id": "boolean", - "kind": "scalars", - "href": "/graphql/reference/scalars#boolean" - }, { "name": "dismissStaleReviewsOnPush", "description": "

New, reviewable commits pushed will dismiss previous pull request review approvals.

", @@ -52532,6 +53160,14 @@ "id": "boolean", "kind": "scalars", "href": "/graphql/reference/scalars#boolean" + }, + { + "name": "requiredReviewers", + "description": "

This field is in beta and subject to change. A collection of reviewers and\nassociated file patterns. Each reviewer has a list of file patterns which\ndetermine the files that reviewer is required to review.

", + "type": "[RequiredReviewerConfiguration!]", + "id": "requiredreviewerconfiguration", + "kind": "objects", + "href": "/graphql/reference/objects#requiredreviewerconfiguration" } ] }, @@ -56572,6 +57208,67 @@ } ] }, + { + "name": "RemovedFromProjectV2Event", + "kind": "objects", + "id": "removedfromprojectv2event", + "href": "/graphql/reference/objects#removedfromprojectv2event", + "description": "

Represents aremoved_from_project_v2event on a given issue or pull request.

", + "implements": [ + { + "name": "Node", + "id": "node", + "href": "/graphql/reference/interfaces#node" + }, + { + "name": "ProjectV2Event", + "id": "projectv2event", + "href": "/graphql/reference/interfaces#projectv2event" + } + ], + "fields": [ + { + "name": "actor", + "description": "

Identifies the actor who performed the event.

", + "type": "Actor", + "id": "actor", + "kind": "interfaces", + "href": "/graphql/reference/interfaces#actor" + }, + { + "name": "createdAt", + "description": "

Identifies the date and time when the object was created.

", + "type": "DateTime!", + "id": "datetime", + "kind": "scalars", + "href": "/graphql/reference/scalars#datetime" + }, + { + "name": "id", + "description": "

The Node ID of the RemovedFromProjectV2Event object.

", + "type": "ID!", + "id": "id", + "kind": "scalars", + "href": "/graphql/reference/scalars#id" + }, + { + "name": "project", + "description": "

Project referenced by event.

", + "type": "ProjectV2", + "id": "projectv2", + "kind": "objects", + "href": "/graphql/reference/objects#projectv2" + }, + { + "name": "wasAutomated", + "description": "

Did this event result from workflow automation?.

", + "type": "Boolean!", + "id": "boolean", + "kind": "scalars", + "href": "/graphql/reference/scalars#boolean" + } + ] + }, { "name": "RenamedTitleEvent", "kind": "objects", @@ -64159,6 +64856,76 @@ } ] }, + { + "name": "repositoryCustomPropertyValue", + "description": "

A custom property value for the repository.

", + "type": "RepositoryCustomPropertyValue", + "id": "repositorycustompropertyvalue", + "kind": "objects", + "href": "/graphql/reference/objects#repositorycustompropertyvalue", + "arguments": [ + { + "name": "propertyName", + "description": "

The name of the custom property to retrieve the value for.

", + "type": { + "name": "String!", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + } + } + ] + }, + { + "name": "repositoryCustomPropertyValues", + "description": "

A list of custom properties and their associated values for a repository.

", + "type": "RepositoryCustomPropertyValueConnection", + "id": "repositorycustompropertyvalueconnection", + "kind": "objects", + "href": "/graphql/reference/objects#repositorycustompropertyvalueconnection", + "arguments": [ + { + "name": "after", + "description": "

Returns the elements in the list that come after the specified cursor.

", + "type": { + "name": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + } + }, + { + "name": "before", + "description": "

Returns the elements in the list that come before the specified cursor.

", + "type": { + "name": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + } + }, + { + "name": "first", + "description": "

Returns the first n elements from the list.

", + "type": { + "name": "Int", + "id": "int", + "kind": "scalars", + "href": "/graphql/reference/scalars#int" + } + }, + { + "name": "last", + "description": "

Returns the last n elements from the list.

", + "type": { + "name": "Int", + "id": "int", + "kind": "scalars", + "href": "/graphql/reference/scalars#int" + } + } + ] + }, { "name": "repositoryTopics", "description": "

A list of applied repository-topic associations for this repository.

", @@ -65122,6 +65889,259 @@ } ] }, + { + "name": "RepositoryCustomProperty", + "kind": "objects", + "id": "repositorycustomproperty", + "href": "/graphql/reference/objects#repositorycustomproperty", + "description": "

A repository custom property.

", + "implements": [ + { + "name": "Node", + "id": "node", + "href": "/graphql/reference/interfaces#node" + } + ], + "fields": [ + { + "name": "allowedValues", + "description": "

The allowed values for the custom property. Required if value_type is single_select or multi_select.

", + "type": "[String!]", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "defaultValue", + "description": "

The default value of the custom property, if the property is required.

", + "type": "CustomPropertyValue", + "id": "custompropertyvalue", + "kind": "scalars", + "href": "/graphql/reference/scalars#custompropertyvalue" + }, + { + "name": "description", + "description": "

The description of the custom property.

", + "type": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "id", + "description": "

The Node ID of the RepositoryCustomProperty object.

", + "type": "ID!", + "id": "id", + "kind": "scalars", + "href": "/graphql/reference/scalars#id" + }, + { + "name": "propertyName", + "description": "

The name of the custom property.

", + "type": "String!", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "regex", + "description": "

The regex pattern that the value of the custom property must match, if the value_type is string.

", + "type": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "required", + "description": "

Whether the custom property is required.

", + "type": "Boolean", + "id": "boolean", + "kind": "scalars", + "href": "/graphql/reference/scalars#boolean" + }, + { + "name": "source", + "description": "

The source type of the custom property.

", + "type": "CustomPropertySource!", + "id": "custompropertysource", + "kind": "unions", + "href": "/graphql/reference/unions#custompropertysource" + }, + { + "name": "valueType", + "description": "

The value type of the custom property.

", + "type": "CustomPropertyValueType!", + "id": "custompropertyvaluetype", + "kind": "enums", + "href": "/graphql/reference/enums#custompropertyvaluetype" + }, + { + "name": "valuesEditableBy", + "description": "

Who can edit the values of this repository custom property.

", + "type": "RepositoryCustomPropertyValuesEditableBy!", + "id": "repositorycustompropertyvalueseditableby", + "kind": "enums", + "href": "/graphql/reference/enums#repositorycustompropertyvalueseditableby" + } + ] + }, + { + "name": "RepositoryCustomPropertyConnection", + "kind": "objects", + "id": "repositorycustompropertyconnection", + "href": "/graphql/reference/objects#repositorycustompropertyconnection", + "description": "

The connection type for RepositoryCustomProperty.

", + "fields": [ + { + "name": "edges", + "description": "

A list of edges.

", + "type": "[RepositoryCustomPropertyEdge]", + "id": "repositorycustompropertyedge", + "kind": "objects", + "href": "/graphql/reference/objects#repositorycustompropertyedge" + }, + { + "name": "nodes", + "description": "

A list of nodes.

", + "type": "[RepositoryCustomProperty]", + "id": "repositorycustomproperty", + "kind": "objects", + "href": "/graphql/reference/objects#repositorycustomproperty" + }, + { + "name": "pageInfo", + "description": "

Information to aid in pagination.

", + "type": "PageInfo!", + "id": "pageinfo", + "kind": "objects", + "href": "/graphql/reference/objects#pageinfo" + }, + { + "name": "totalCount", + "description": "

Identifies the total count of items in the connection.

", + "type": "Int!", + "id": "int", + "kind": "scalars", + "href": "/graphql/reference/scalars#int" + } + ] + }, + { + "name": "RepositoryCustomPropertyEdge", + "kind": "objects", + "id": "repositorycustompropertyedge", + "href": "/graphql/reference/objects#repositorycustompropertyedge", + "description": "

An edge in a connection.

", + "fields": [ + { + "name": "cursor", + "description": "

A cursor for use in pagination.

", + "type": "String!", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "node", + "description": "

The item at the end of the edge.

", + "type": "RepositoryCustomProperty", + "id": "repositorycustomproperty", + "kind": "objects", + "href": "/graphql/reference/objects#repositorycustomproperty" + } + ] + }, + { + "name": "RepositoryCustomPropertyValue", + "kind": "objects", + "id": "repositorycustompropertyvalue", + "href": "/graphql/reference/objects#repositorycustompropertyvalue", + "description": "

A value associated with a repository custom property.

", + "fields": [ + { + "name": "propertyName", + "description": "

The name of the custom property.

", + "type": "String!", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "value", + "description": "

The value of the custom property.

", + "type": "CustomPropertyValue!", + "id": "custompropertyvalue", + "kind": "scalars", + "href": "/graphql/reference/scalars#custompropertyvalue" + } + ] + }, + { + "name": "RepositoryCustomPropertyValueConnection", + "kind": "objects", + "id": "repositorycustompropertyvalueconnection", + "href": "/graphql/reference/objects#repositorycustompropertyvalueconnection", + "description": "

The connection type for RepositoryCustomPropertyValue.

", + "fields": [ + { + "name": "edges", + "description": "

A list of edges.

", + "type": "[RepositoryCustomPropertyValueEdge]", + "id": "repositorycustompropertyvalueedge", + "kind": "objects", + "href": "/graphql/reference/objects#repositorycustompropertyvalueedge" + }, + { + "name": "nodes", + "description": "

A list of nodes.

", + "type": "[RepositoryCustomPropertyValue]", + "id": "repositorycustompropertyvalue", + "kind": "objects", + "href": "/graphql/reference/objects#repositorycustompropertyvalue" + }, + { + "name": "pageInfo", + "description": "

Information to aid in pagination.

", + "type": "PageInfo!", + "id": "pageinfo", + "kind": "objects", + "href": "/graphql/reference/objects#pageinfo" + }, + { + "name": "totalCount", + "description": "

Identifies the total count of items in the connection.

", + "type": "Int!", + "id": "int", + "kind": "scalars", + "href": "/graphql/reference/scalars#int" + } + ] + }, + { + "name": "RepositoryCustomPropertyValueEdge", + "kind": "objects", + "id": "repositorycustompropertyvalueedge", + "href": "/graphql/reference/objects#repositorycustompropertyvalueedge", + "description": "

An edge in a connection.

", + "fields": [ + { + "name": "cursor", + "description": "

A cursor for use in pagination.

", + "type": "String!", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "node", + "description": "

The item at the end of the edge.

", + "type": "RepositoryCustomPropertyValue", + "id": "repositorycustompropertyvalue", + "kind": "objects", + "href": "/graphql/reference/objects#repositorycustompropertyvalue" + } + ] + }, { "name": "RepositoryEdge", "kind": "objects", @@ -65639,6 +66659,14 @@ "href": "/graphql/reference/objects#repositoryruleconditions", "description": "

Set of conditions that determine if a ruleset will evaluate.

", "fields": [ + { + "name": "organizationProperty", + "description": "

Configuration for the organization_property condition.

", + "type": "OrganizationPropertyConditionTarget", + "id": "organizationpropertyconditiontarget", + "kind": "objects", + "href": "/graphql/reference/objects#organizationpropertyconditiontarget" + }, { "name": "refName", "description": "

Configuration for the ref_name condition.

", @@ -67056,6 +68084,39 @@ } ] }, + { + "name": "RequiredReviewerConfiguration", + "kind": "objects", + "id": "requiredreviewerconfiguration", + "href": "/graphql/reference/objects#requiredreviewerconfiguration", + "description": "

A reviewing team, and file patterns describing which files they must approve changes to.

", + "fields": [ + { + "name": "filePatterns", + "description": "

Array of file patterns. Pull requests which change matching files must be\napproved by the specified team. File patterns use fnmatch syntax.

", + "type": "[String!]!", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "minimumApprovals", + "description": "

Minimum number of approvals required from the specified team. If set to zero,\nthe team will be added to the pull request but approval is optional.

", + "type": "Int!", + "id": "int", + "kind": "scalars", + "href": "/graphql/reference/scalars#int" + }, + { + "name": "reviewerId", + "description": "

Node ID of the team which must review changes to matching files.

", + "type": "ID!", + "id": "id", + "kind": "scalars", + "href": "/graphql/reference/scalars#id" + } + ] + }, { "name": "RequiredStatusCheckDescription", "kind": "objects", @@ -69742,6 +70803,105 @@ } ] }, + { + "name": "SuggestedReviewerActor", + "kind": "objects", + "id": "suggestedrevieweractor", + "href": "/graphql/reference/objects#suggestedrevieweractor", + "description": "

A suggestion to review a pull request based on an actor's commit history, review comments, and integrations.

", + "fields": [ + { + "name": "isAuthor", + "description": "

Is this suggestion based on past commits?.

", + "type": "Boolean!", + "id": "boolean", + "kind": "scalars", + "href": "/graphql/reference/scalars#boolean" + }, + { + "name": "isCommenter", + "description": "

Is this suggestion based on past review comments?.

", + "type": "Boolean!", + "id": "boolean", + "kind": "scalars", + "href": "/graphql/reference/scalars#boolean" + }, + { + "name": "reviewer", + "description": "

Identifies the actor suggested to review the pull request.

", + "type": "Actor!", + "id": "actor", + "kind": "interfaces", + "href": "/graphql/reference/interfaces#actor" + } + ] + }, + { + "name": "SuggestedReviewerActorConnection", + "kind": "objects", + "id": "suggestedrevieweractorconnection", + "href": "/graphql/reference/objects#suggestedrevieweractorconnection", + "description": "

A suggestion to review a pull request based on an actor's commit history, review comments, and integrations.

", + "fields": [ + { + "name": "edges", + "description": "

A list of edges.

", + "type": "[SuggestedReviewerActorEdge]", + "id": "suggestedrevieweractoredge", + "kind": "objects", + "href": "/graphql/reference/objects#suggestedrevieweractoredge" + }, + { + "name": "nodes", + "description": "

A list of nodes.

", + "type": "[SuggestedReviewerActor]", + "id": "suggestedrevieweractor", + "kind": "objects", + "href": "/graphql/reference/objects#suggestedrevieweractor" + }, + { + "name": "pageInfo", + "description": "

Information to aid in pagination.

", + "type": "PageInfo!", + "id": "pageinfo", + "kind": "objects", + "href": "/graphql/reference/objects#pageinfo" + }, + { + "name": "totalCount", + "description": "

Identifies the total count of items in the connection.

", + "type": "Int!", + "id": "int", + "kind": "scalars", + "href": "/graphql/reference/scalars#int" + } + ] + }, + { + "name": "SuggestedReviewerActorEdge", + "kind": "objects", + "id": "suggestedrevieweractoredge", + "href": "/graphql/reference/objects#suggestedrevieweractoredge", + "description": "

An edge in a connection.

", + "fields": [ + { + "name": "cursor", + "description": "

A cursor for use in pagination.

", + "type": "String!", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "node", + "description": "

The item at the end of the edge.

", + "type": "SuggestedReviewerActor", + "id": "suggestedrevieweractor", + "kind": "objects", + "href": "/graphql/reference/objects#suggestedrevieweractor" + } + ] + }, { "name": "Tag", "kind": "objects", @@ -74500,6 +75660,11 @@ "id": "actor", "href": "/graphql/reference/interfaces#actor" }, + { + "name": "Agentic", + "id": "agentic", + "href": "/graphql/reference/interfaces#agentic" + }, { "name": "Node", "id": "node", @@ -76938,6 +78103,30 @@ "kind": "scalars", "href": "/graphql/reference/scalars#boolean" }, + { + "name": "viewerCopilotAgentCreatesChannel", + "description": "

Channel value for subscribing to live updates for session creations.

", + "type": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "viewerCopilotAgentLogUpdatesChannel", + "description": "

Channel value for subscribing to live updates for session log updates.

", + "type": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "viewerCopilotAgentUpdatesChannel", + "description": "

Channel value for subscribing to live updates for session updates.

", + "type": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, { "name": "viewerIsFollowing", "description": "

Whether or not this user is followed by the viewer. Inverse of isFollowingViewer.

", @@ -78758,6 +79947,39 @@ } ] }, + { + "name": "Agentic", + "kind": "interfaces", + "id": "agentic", + "href": "/graphql/reference/interfaces#agentic", + "description": "

Copilot Agentic fields in context of the current viewer.

", + "fields": [ + { + "name": "viewerCopilotAgentCreatesChannel", + "description": "

Channel value for subscribing to live updates for session creations.

", + "type": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "viewerCopilotAgentLogUpdatesChannel", + "description": "

Channel value for subscribing to live updates for session log updates.

", + "type": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "viewerCopilotAgentUpdatesChannel", + "description": "

Channel value for subscribing to live updates for session updates.

", + "type": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + } + ] + }, { "name": "Assignable", "kind": "interfaces", @@ -80421,6 +81643,31 @@ } ] }, + { + "name": "ProjectV2Event", + "kind": "interfaces", + "id": "projectv2event", + "href": "/graphql/reference/interfaces#projectv2event", + "description": "

Represents an event related to a project on the timeline of an issue or pull request.

", + "fields": [ + { + "name": "project", + "description": "

Project referenced by event.

", + "type": "ProjectV2", + "id": "projectv2", + "kind": "objects", + "href": "/graphql/reference/objects#projectv2" + }, + { + "name": "wasAutomated", + "description": "

Did this event result from workflow automation?.

", + "type": "Boolean!", + "id": "boolean", + "kind": "scalars", + "href": "/graphql/reference/scalars#boolean" + } + ] + }, { "name": "ProjectV2FieldCommon", "kind": "interfaces", @@ -82325,6 +83572,35 @@ } ] }, + { + "name": "CustomPropertyValueType", + "kind": "enums", + "id": "custompropertyvaluetype", + "href": "/graphql/reference/enums#custompropertyvaluetype", + "description": "

The allowed value types for a custom property definition.

", + "values": [ + { + "name": "MULTI_SELECT", + "description": "

A multi-select value.

" + }, + { + "name": "SINGLE_SELECT", + "description": "

A single-select value.

" + }, + { + "name": "STRING", + "description": "

A string value.

" + }, + { + "name": "TRUE_FALSE", + "description": "

A true/false value.

" + }, + { + "name": "URL", + "description": "

A URL value.

" + } + ] + }, { "name": "DefaultRepositoryPermissionField", "kind": "enums", @@ -83380,6 +84656,10 @@ "name": "ADDED_TO_PROJECT_EVENT", "description": "

Represents aadded_to_projectevent on a given issue or pull request.

" }, + { + "name": "ADDED_TO_PROJECT_V2_EVENT", + "description": "

Represents aadded_to_project_v2event on a given issue or pull request.

" + }, { "name": "ASSIGNED_EVENT", "description": "

Represents anassignedevent on any assignable object.

" @@ -83412,6 +84692,10 @@ "name": "CONNECTED_EVENT", "description": "

Represents aconnectedevent on a given issue or pull request.

" }, + { + "name": "CONVERTED_FROM_DRAFT_EVENT", + "description": "

Represents aconverted_from_draftevent on a given issue or pull request.

" + }, { "name": "CONVERTED_NOTE_TO_ISSUE_EVENT", "description": "

Represents aconverted_note_to_issueevent on a given issue or pull request.

" @@ -83436,6 +84720,18 @@ "name": "ISSUE_COMMENT", "description": "

Represents a comment on an Issue.

" }, + { + "name": "ISSUE_FIELD_ADDED_EVENT", + "description": "

Represents aissue_field_addedevent on a given issue.

" + }, + { + "name": "ISSUE_FIELD_CHANGED_EVENT", + "description": "

Represents aissue_field_changedevent on a given issue.

" + }, + { + "name": "ISSUE_FIELD_REMOVED_EVENT", + "description": "

Represents aissue_field_removedevent on a given issue.

" + }, { "name": "ISSUE_TYPE_ADDED_EVENT", "description": "

Represents aissue_type_addedevent on a given issue.

" @@ -83484,6 +84780,10 @@ "name": "PINNED_EVENT", "description": "

Represents apinnedevent on a given issue or pull request.

" }, + { + "name": "PROJECT_V2_ITEM_STATUS_CHANGED_EVENT", + "description": "

Represents aproject_v2_item_status_changedevent on a given issue or pull request.

" + }, { "name": "REFERENCED_EVENT", "description": "

Represents areferencedevent on a given ReferencedSubject.

" @@ -83492,6 +84792,10 @@ "name": "REMOVED_FROM_PROJECT_EVENT", "description": "

Represents aremoved_from_projectevent on a given issue or pull request.

" }, + { + "name": "REMOVED_FROM_PROJECT_V2_EVENT", + "description": "

Represents aremoved_from_project_v2event on a given issue or pull request.

" + }, { "name": "RENAMED_TITLE_EVENT", "description": "

Represents arenamedevent on a given issue or pull request.

" @@ -85474,6 +86778,10 @@ "name": "ADDED_TO_PROJECT_EVENT", "description": "

Represents aadded_to_projectevent on a given issue or pull request.

" }, + { + "name": "ADDED_TO_PROJECT_V2_EVENT", + "description": "

Represents aadded_to_project_v2event on a given issue or pull request.

" + }, { "name": "ASSIGNED_EVENT", "description": "

Represents anassignedevent on any assignable object.

" @@ -85542,6 +86850,10 @@ "name": "CONNECTED_EVENT", "description": "

Represents aconnectedevent on a given issue or pull request.

" }, + { + "name": "CONVERTED_FROM_DRAFT_EVENT", + "description": "

Represents aconverted_from_draftevent on a given issue or pull request.

" + }, { "name": "CONVERTED_NOTE_TO_ISSUE_EVENT", "description": "

Represents aconverted_note_to_issueevent on a given issue or pull request.

" @@ -85590,6 +86902,18 @@ "name": "ISSUE_COMMENT", "description": "

Represents a comment on an Issue.

" }, + { + "name": "ISSUE_FIELD_ADDED_EVENT", + "description": "

Represents aissue_field_addedevent on a given issue.

" + }, + { + "name": "ISSUE_FIELD_CHANGED_EVENT", + "description": "

Represents aissue_field_changedevent on a given issue.

" + }, + { + "name": "ISSUE_FIELD_REMOVED_EVENT", + "description": "

Represents aissue_field_removedevent on a given issue.

" + }, { "name": "ISSUE_TYPE_ADDED_EVENT", "description": "

Represents aissue_type_addedevent on a given issue.

" @@ -85642,6 +86966,10 @@ "name": "PINNED_EVENT", "description": "

Represents apinnedevent on a given issue or pull request.

" }, + { + "name": "PROJECT_V2_ITEM_STATUS_CHANGED_EVENT", + "description": "

Represents aproject_v2_item_status_changedevent on a given issue or pull request.

" + }, { "name": "PULL_REQUEST_COMMIT", "description": "

Represents a Git commit part of a pull request.

" @@ -85678,6 +87006,10 @@ "name": "REMOVED_FROM_PROJECT_EVENT", "description": "

Represents aremoved_from_projectevent on a given issue or pull request.

" }, + { + "name": "REMOVED_FROM_PROJECT_V2_EVENT", + "description": "

Represents aremoved_from_project_v2event on a given issue or pull request.

" + }, { "name": "RENAMED_TITLE_EVENT", "description": "

Represents arenamedevent on a given issue or pull request.

" @@ -86071,6 +87403,23 @@ } ] }, + { + "name": "RepositoryCustomPropertyValuesEditableBy", + "kind": "enums", + "id": "repositorycustompropertyvalueseditableby", + "href": "/graphql/reference/enums#repositorycustompropertyvalueseditableby", + "description": "

The allowed actors who can edit the values of a custom property.

", + "values": [ + { + "name": "ORG_ACTORS", + "description": "

The organization actors.

" + }, + { + "name": "ORG_AND_REPO_ACTORS", + "description": "

The organization and repository actors.

" + } + ] + }, { "name": "RepositoryInvitationOrderField", "kind": "enums", @@ -86276,7 +87625,7 @@ }, { "name": "COPILOT_CODE_REVIEW", - "description": "

Request Copilot code review for new pull requests automatically if the author has access to Copilot code review.

" + "description": "

Request Copilot code review for new pull requests automatically if the author\nhas access to Copilot code review and their premium requests quota has not\nreached the limit.

" }, { "name": "CREATION", @@ -87520,6 +88869,25 @@ } ] }, + { + "name": "CustomPropertySource", + "kind": "unions", + "id": "custompropertysource", + "href": "/graphql/reference/unions#custompropertysource", + "description": "

Sources which can have custom properties defined.

", + "possibleTypes": [ + { + "name": "Enterprise", + "id": "enterprise", + "href": "/graphql/reference/objects#enterprise" + }, + { + "name": "Organization", + "id": "organization", + "href": "/graphql/reference/objects#organization" + } + ] + }, { "name": "DeploymentReviewer", "kind": "unions", @@ -87717,6 +89085,11 @@ "id": "addedtoprojectevent", "href": "/graphql/reference/objects#addedtoprojectevent" }, + { + "name": "AddedToProjectV2Event", + "id": "addedtoprojectv2event", + "href": "/graphql/reference/objects#addedtoprojectv2event" + }, { "name": "AssignedEvent", "id": "assignedevent", @@ -87757,6 +89130,11 @@ "id": "connectedevent", "href": "/graphql/reference/objects#connectedevent" }, + { + "name": "ConvertedFromDraftEvent", + "id": "convertedfromdraftevent", + "href": "/graphql/reference/objects#convertedfromdraftevent" + }, { "name": "ConvertedNoteToIssueEvent", "id": "convertednotetoissueevent", @@ -87847,6 +89225,11 @@ "id": "pinnedevent", "href": "/graphql/reference/objects#pinnedevent" }, + { + "name": "ProjectV2ItemStatusChangedEvent", + "id": "projectv2itemstatuschangedevent", + "href": "/graphql/reference/objects#projectv2itemstatuschangedevent" + }, { "name": "ReferencedEvent", "id": "referencedevent", @@ -87857,6 +89240,11 @@ "id": "removedfromprojectevent", "href": "/graphql/reference/objects#removedfromprojectevent" }, + { + "name": "RemovedFromProjectV2Event", + "id": "removedfromprojectv2event", + "href": "/graphql/reference/objects#removedfromprojectv2event" + }, { "name": "RenamedTitleEvent", "id": "renamedtitleevent", @@ -88679,6 +90067,11 @@ "id": "addedtoprojectevent", "href": "/graphql/reference/objects#addedtoprojectevent" }, + { + "name": "AddedToProjectV2Event", + "id": "addedtoprojectv2event", + "href": "/graphql/reference/objects#addedtoprojectv2event" + }, { "name": "AssignedEvent", "id": "assignedevent", @@ -88769,6 +90162,11 @@ "id": "converttodraftevent", "href": "/graphql/reference/objects#converttodraftevent" }, + { + "name": "ConvertedFromDraftEvent", + "id": "convertedfromdraftevent", + "href": "/graphql/reference/objects#convertedfromdraftevent" + }, { "name": "ConvertedNoteToIssueEvent", "id": "convertednotetoissueevent", @@ -88889,6 +90287,11 @@ "id": "pinnedevent", "href": "/graphql/reference/objects#pinnedevent" }, + { + "name": "ProjectV2ItemStatusChangedEvent", + "id": "projectv2itemstatuschangedevent", + "href": "/graphql/reference/objects#projectv2itemstatuschangedevent" + }, { "name": "PullRequestCommit", "id": "pullrequestcommit", @@ -88934,6 +90337,11 @@ "id": "removedfromprojectevent", "href": "/graphql/reference/objects#removedfromprojectevent" }, + { + "name": "RemovedFromProjectV2Event", + "id": "removedfromprojectv2event", + "href": "/graphql/reference/objects#removedfromprojectv2event" + }, { "name": "RenamedTitleEvent", "id": "renamedtitleevent", @@ -89480,7 +90888,7 @@ }, { "name": "assigneeIds", - "description": "

The id of users to add as assignees.

", + "description": "

The ids of actors (users or bots) to add as assignees.

", "type": "[ID!]!", "id": "id", "kind": "scalars", @@ -91660,7 +93068,7 @@ "kind": "inputObjects", "id": "copilotcodereviewparametersinput", "href": "/graphql/reference/input-objects#copilotcodereviewparametersinput", - "description": "

Request Copilot code review for new pull requests automatically if the author has access to Copilot code review.

", + "description": "

Request Copilot code review for new pull requests automatically if the author\nhas access to Copilot code review and their premium requests quota has not\nreached the limit.

", "inputFields": [ { "name": "reviewDraftPullRequests", @@ -92640,6 +94048,15 @@ "href": "/graphql/reference/scalars#id", "isDeprecated": false }, + { + "name": "projectV2Ids", + "description": "

An array of Node IDs for Projects V2 associated with this issue.

", + "type": "[ID!]", + "id": "id", + "kind": "scalars", + "href": "/graphql/reference/scalars#id", + "isDeprecated": false + }, { "name": "repositoryId", "description": "

The Node ID of the repository.

", @@ -93236,6 +94653,96 @@ } ] }, + { + "name": "CreateRepositoryCustomPropertyInput", + "kind": "inputObjects", + "id": "createrepositorycustompropertyinput", + "href": "/graphql/reference/input-objects#createrepositorycustompropertyinput", + "description": "

Autogenerated input type of CreateRepositoryCustomProperty.

", + "inputFields": [ + { + "name": "allowedValues", + "description": "

The allowed values for the custom property.

", + "type": "[String!]", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "clientMutationId", + "description": "

A unique identifier for the client performing the mutation.

", + "type": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "defaultValue", + "description": "

The default value for the custom property if the property is required.

", + "type": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "description", + "description": "

The description of the custom property.

", + "type": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "propertyName", + "description": "

The name of the custom property.

", + "type": "String!", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "regex", + "description": "

The regex pattern that the value of the custom property must match, if the value_type is string.

", + "type": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "required", + "description": "

Whether the custom property is required.

", + "type": "Boolean", + "id": "boolean", + "kind": "scalars", + "href": "/graphql/reference/scalars#boolean" + }, + { + "name": "sourceId", + "description": "

The global relay id of the source in which a new custom property should be created in.

", + "type": "ID!", + "id": "id", + "kind": "scalars", + "href": "/graphql/reference/scalars#id", + "isDeprecated": false + }, + { + "name": "valueType", + "description": "

The value type for the custom property.

", + "type": "CustomPropertyValueType!", + "id": "custompropertyvaluetype", + "kind": "enums", + "href": "/graphql/reference/enums#custompropertyvaluetype" + }, + { + "name": "valuesEditableBy", + "description": "

The allowed actors who can edit the values of a custom property.

", + "type": "RepositoryCustomPropertyValuesEditableBy", + "id": "repositorycustompropertyvalueseditableby", + "kind": "enums", + "href": "/graphql/reference/enums#repositorycustompropertyvalueseditableby" + } + ] + }, { "name": "CreateRepositoryInput", "kind": "inputObjects", @@ -93526,6 +95033,31 @@ } ] }, + { + "name": "CustomPropertyValueInput", + "kind": "inputObjects", + "id": "custompropertyvalueinput", + "href": "/graphql/reference/input-objects#custompropertyvalueinput", + "description": "

The custom property name and value to be set.

", + "inputFields": [ + { + "name": "propertyName", + "description": "

The name of the custom property.

", + "type": "String!", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "value", + "description": "

The value to set for the custom property. Using a value of null will unset the\nproperty value, reverting to the default value if the property is required.

", + "type": "CustomPropertyValue", + "id": "custompropertyvalue", + "kind": "scalars", + "href": "/graphql/reference/scalars#custompropertyvalue" + } + ] + }, { "name": "DeleteBranchProtectionRuleInput", "kind": "inputObjects", @@ -94133,6 +95665,32 @@ } ] }, + { + "name": "DeleteRepositoryCustomPropertyInput", + "kind": "inputObjects", + "id": "deleterepositorycustompropertyinput", + "href": "/graphql/reference/input-objects#deleterepositorycustompropertyinput", + "description": "

Autogenerated input type of DeleteRepositoryCustomProperty.

", + "inputFields": [ + { + "name": "clientMutationId", + "description": "

A unique identifier for the client performing the mutation.

", + "type": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "id", + "description": "

The global relay id of the custom property to be deleted.

", + "type": "ID!", + "id": "id", + "kind": "scalars", + "href": "/graphql/reference/scalars#id", + "isDeprecated": false + } + ] + }, { "name": "DeleteRepositoryRulesetInput", "kind": "inputObjects", @@ -96110,6 +97668,56 @@ } ] }, + { + "name": "OrganizationPropertyConditionTargetInput", + "kind": "inputObjects", + "id": "organizationpropertyconditiontargetinput", + "href": "/graphql/reference/input-objects#organizationpropertyconditiontargetinput", + "description": "

Parameters to be used for the organization_property condition.

", + "inputFields": [ + { + "name": "exclude", + "description": "

Array of organization properties that must not match.

", + "type": "[OrganizationPropertyTargetDefinitionInput!]!", + "id": "organizationpropertytargetdefinitioninput", + "kind": "input-objects", + "href": "/graphql/reference/input-objects#organizationpropertytargetdefinitioninput" + }, + { + "name": "include", + "description": "

Array of organization properties that must match.

", + "type": "[OrganizationPropertyTargetDefinitionInput!]!", + "id": "organizationpropertytargetdefinitioninput", + "kind": "input-objects", + "href": "/graphql/reference/input-objects#organizationpropertytargetdefinitioninput" + } + ] + }, + { + "name": "OrganizationPropertyTargetDefinitionInput", + "kind": "inputObjects", + "id": "organizationpropertytargetdefinitioninput", + "href": "/graphql/reference/input-objects#organizationpropertytargetdefinitioninput", + "description": "

A property that must match.

", + "inputFields": [ + { + "name": "name", + "description": "

The name of the property.

", + "type": "String!", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "propertyValues", + "description": "

The values to match for.

", + "type": "[String!]!", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + } + ] + }, { "name": "PackageFileOrder", "kind": "inputObjects", @@ -96728,6 +98336,32 @@ } ] }, + { + "name": "PromoteRepositoryCustomPropertyInput", + "kind": "inputObjects", + "id": "promoterepositorycustompropertyinput", + "href": "/graphql/reference/input-objects#promoterepositorycustompropertyinput", + "description": "

Autogenerated input type of PromoteRepositoryCustomProperty.

", + "inputFields": [ + { + "name": "clientMutationId", + "description": "

A unique identifier for the client performing the mutation.

", + "type": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "repositoryCustomPropertyId", + "description": "

The ID of the repository custom property to be promoted.

", + "type": "ID!", + "id": "id", + "kind": "scalars", + "href": "/graphql/reference/scalars#id", + "isDeprecated": false + } + ] + }, { "name": "PropertyTargetDefinitionInput", "kind": "inputObjects", @@ -96801,14 +98435,6 @@ "kind": "enums", "href": "/graphql/reference/enums#pullrequestallowedmergemethods" }, - { - "name": "automaticCopilotCodeReviewEnabled", - "description": "

Request Copilot code review for new pull requests automatically if the author has access to Copilot code review.

", - "type": "Boolean", - "id": "boolean", - "kind": "scalars", - "href": "/graphql/reference/scalars#boolean" - }, { "name": "dismissStaleReviewsOnPush", "description": "

New, reviewable commits pushed will dismiss previous pull request review approvals.

", @@ -96848,6 +98474,14 @@ "id": "boolean", "kind": "scalars", "href": "/graphql/reference/scalars#boolean" + }, + { + "name": "requiredReviewers", + "description": "

This argument is in beta and subject to change. A collection of reviewers and\nassociated file patterns. Each reviewer has a list of file patterns which\ndetermine the files that reviewer is required to review.

", + "type": "[RequiredReviewerConfigurationInput!]", + "id": "requiredreviewerconfigurationinput", + "kind": "input-objects", + "href": "/graphql/reference/input-objects#requiredreviewerconfigurationinput" } ] }, @@ -97078,7 +98712,7 @@ }, { "name": "assigneeIds", - "description": "

The id of users to remove as assignees.

", + "description": "

The ids of actors to remove as assignees.

", "type": "[ID!]!", "id": "id", "kind": "scalars", @@ -97659,6 +99293,14 @@ "href": "/graphql/reference/input-objects#repositoryruleconditionsinput", "description": "

Specifies the conditions required for a ruleset to evaluate.

", "inputFields": [ + { + "name": "organizationProperty", + "description": "

Configuration for the organization_property condition.

", + "type": "OrganizationPropertyConditionTargetInput", + "id": "organizationpropertyconditiontargetinput", + "kind": "input-objects", + "href": "/graphql/reference/input-objects#organizationpropertyconditiontargetinput" + }, { "name": "refName", "description": "

Configuration for the ref_name condition.

", @@ -97940,6 +99582,39 @@ } ] }, + { + "name": "RequiredReviewerConfigurationInput", + "kind": "inputObjects", + "id": "requiredreviewerconfigurationinput", + "href": "/graphql/reference/input-objects#requiredreviewerconfigurationinput", + "description": "

A reviewing team, and file patterns describing which files they must approve changes to.

", + "inputFields": [ + { + "name": "filePatterns", + "description": "

Array of file patterns. Pull requests which change matching files must be\napproved by the specified team. File patterns use fnmatch syntax.

", + "type": "[String!]!", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "minimumApprovals", + "description": "

Minimum number of approvals required from the specified team. If set to zero,\nthe team will be added to the pull request but approval is optional.

", + "type": "Int!", + "id": "int", + "kind": "scalars", + "href": "/graphql/reference/scalars#int" + }, + { + "name": "reviewerId", + "description": "

Node ID of the team which must review changes to matching files.

", + "type": "ID!", + "id": "id", + "kind": "scalars", + "href": "/graphql/reference/scalars#id" + } + ] + }, { "name": "RequiredStatusCheckInput", "kind": "inputObjects", @@ -98355,6 +100030,40 @@ } ] }, + { + "name": "SetRepositoryCustomPropertyValuesInput", + "kind": "inputObjects", + "id": "setrepositorycustompropertyvaluesinput", + "href": "/graphql/reference/input-objects#setrepositorycustompropertyvaluesinput", + "description": "

Autogenerated input type of SetRepositoryCustomPropertyValues.

", + "inputFields": [ + { + "name": "clientMutationId", + "description": "

A unique identifier for the client performing the mutation.

", + "type": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "properties", + "description": "

A list of custom property names and associated values to apply.

", + "type": "[CustomPropertyValueInput!]!", + "id": "custompropertyvalueinput", + "kind": "input-objects", + "href": "/graphql/reference/input-objects#custompropertyvalueinput" + }, + { + "name": "repositoryId", + "description": "

The ID of the repository to set properties for.

", + "type": "ID!", + "id": "id", + "kind": "scalars", + "href": "/graphql/reference/scalars#id", + "isDeprecated": false + } + ] + }, { "name": "StarOrder", "kind": "inputObjects", @@ -100645,7 +102354,7 @@ "inputFields": [ { "name": "assigneeIds", - "description": "

An array of Node IDs of users for this issue.

", + "description": "

An array of Node IDs of users or bots for this issue.

", "type": "[ID!]", "id": "id", "kind": "scalars", @@ -101235,7 +102944,7 @@ }, { "name": "iterationConfiguration", - "description": "

Configuration for an iteration field.

", + "description": "

Configuration for a field of type ITERATION. Empty input is ignored, provided\nvalues overwrite the existing configuration, and existing configuration should\nbe fetched for partial updates.

", "type": "ProjectV2IterationFieldConfigurationInput", "id": "projectv2iterationfieldconfigurationinput", "kind": "input-objects", @@ -101251,7 +102960,7 @@ }, { "name": "singleSelectOptions", - "description": "

Options for a field of type SINGLE_SELECT. If empty, no changes will be made\nto the options. If values are present, they will overwrite the existing\noptions for the field.

", + "description": "

Options for a field of type SINGLE_SELECT. Empty input is ignored, provided\nvalues overwrite existing options, and existing options should be fetched for\npartial updates.

", "type": "[ProjectV2SingleSelectFieldOptionInput!]", "id": "projectv2singleselectfieldoptioninput", "kind": "input-objects", @@ -101766,6 +103475,80 @@ } ] }, + { + "name": "UpdateRepositoryCustomPropertyInput", + "kind": "inputObjects", + "id": "updaterepositorycustompropertyinput", + "href": "/graphql/reference/input-objects#updaterepositorycustompropertyinput", + "description": "

Autogenerated input type of UpdateRepositoryCustomProperty.

", + "inputFields": [ + { + "name": "allowedValues", + "description": "

The updated allowed values for the custom property.

", + "type": "[String!]", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "clientMutationId", + "description": "

A unique identifier for the client performing the mutation.

", + "type": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "defaultValue", + "description": "

The updated default value for the custom property if the property is required.

", + "type": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "description", + "description": "

The updated description of the custom property.

", + "type": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "regex", + "description": "

The regex pattern that the value of the custom property must match, if the value_type is string.

", + "type": "String", + "id": "string", + "kind": "scalars", + "href": "/graphql/reference/scalars#string" + }, + { + "name": "repositoryCustomPropertyId", + "description": "

The global relay id of the source of the custom property.

", + "type": "ID!", + "id": "id", + "kind": "scalars", + "href": "/graphql/reference/scalars#id", + "isDeprecated": false + }, + { + "name": "required", + "description": "

Whether the updated custom property is required.

", + "type": "Boolean", + "id": "boolean", + "kind": "scalars", + "href": "/graphql/reference/scalars#boolean" + }, + { + "name": "valuesEditableBy", + "description": "

The updated actors who can edit the values of the custom property.

", + "type": "RepositoryCustomPropertyValuesEditableBy", + "id": "repositorycustompropertyvalueseditableby", + "kind": "enums", + "href": "/graphql/reference/enums#repositorycustompropertyvalueseditableby" + } + ] + }, { "name": "UpdateRepositoryInput", "kind": "inputObjects", @@ -102549,6 +104332,13 @@ "id": "boolean", "href": "/graphql/reference/scalars#boolean" }, + { + "name": "CustomPropertyValue", + "kind": "scalars", + "id": "custompropertyvalue", + "href": "/graphql/reference/scalars#custompropertyvalue", + "description": "

A custom property value can be either a string or an array of strings. All\nproperty types support only a single string value, except for the multi-select\ntype, which supports only a string array.

" + }, { "name": "Date", "kind": "scalars", diff --git a/src/graphql/data/ghes-3.20/upcoming-changes.json b/src/graphql/data/ghes-3.20/upcoming-changes.json index ed9dd1791ca8..4c8252f07caf 100644 --- a/src/graphql/data/ghes-3.20/upcoming-changes.json +++ b/src/graphql/data/ghes-3.20/upcoming-changes.json @@ -8891,16 +8891,6 @@ "owner": "github/notifications" } ], - "2025-11-04": [ - { - "location": "SearchType.ISSUE_ADVANCED", - "description": "

ISSUE_ADVANCED will be removed.

", - "reason": "

Search for issues and pull requests will be overridden by advanced search on November 4, 2025. You can read more about this change on https://github.blog/changelog/2025-03-06-github-issues-projects-api-support-for-issues-advanced-search-and-more/.

", - "date": "2025-11-04", - "criticality": "breaking", - "owner": "github/issues_advanced_search" - } - ], "2025-10-01": [ { "location": "SecurityAdvisory.cvss",