Skip to content

Repo sync #39986

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Aug 22, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion content/billing/concepts/product-billing/github-copilot.md
Original file line number Diff line number Diff line change
Expand Up @@ -79,10 +79,12 @@ For more information about {% data variables.copilot.copilot_coding_agent %}, se

### What happens if you have used up your monthly quota?

If you run out of free Actions minutes or free premium requests, and you have set up a payment method for billing, you will be charged at the normal rates for additional minutes and premium requests. See [AUTOTITLE](/billing/managing-billing-for-github-actions/about-billing-for-github-actions) and [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/monitoring-usage-and-entitlements/about-premium-requests#additional-premium-requests).
If you run out of free Actions minutes or free premium requests, and you have set up a payment method and are not limited by a budget, you will be charged at the normal rates for additional minutes and premium requests. See [AUTOTITLE](/billing/managing-billing-for-github-actions/about-billing-for-github-actions) and [AUTOTITLE](/copilot/concepts/billing/copilot-requests#what-if-i-run-out-of-premium-requests).

If you run out of free minutes or premium requests, and you have _not_ set up billing, a message is displayed explaining why {% data variables.product.prodname_copilot_short %} cannot work on the task.

{% data reusables.copilot.zero-budget-changes %} See [AUTOTITLE](/copilot/how-tos/premium-requests/manage-for-enterprise).

### Monitoring your use of Actions minutes and premium requests

You can track your monthly usage of {% data variables.product.prodname_actions %} minutes and premium requests, to help you get the most value from your {% data variables.product.prodname_copilot_short %} plan. See [AUTOTITLE](/enterprise-cloud@latest/billing/managing-billing-for-your-products/managing-billing-for-github-actions/viewing-your-github-actions-usage) and [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/understanding-and-managing-copilot-usage/monitoring-your-copilot-usage-and-entitlements).
Expand Down
2 changes: 1 addition & 1 deletion content/billing/tutorials/set-up-budgets.md
Original file line number Diff line number Diff line change
Expand Up @@ -104,7 +104,7 @@ As the owner of an enterprise or organization account, or as a billing manager,

### Editing or deleting a budget

>[!IMPORTANT] Deleting a budget may remove any limits on spending, depending on your other existing budgets. For example, deleting the only budget that limits {% data variables.product.prodname_copilot_short %} premium requests allows for unlimited usage.
>[!IMPORTANT] Deleting a budget may remove any limits on spending, depending on your other existing budgets.
You can edit or delete a budget at any time, but you cannot change the scope of a budget after creating it.

Expand Down
2 changes: 1 addition & 1 deletion content/copilot/concepts/billing/billing-for-spark.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ contentType: concepts
## Billing for {% data variables.product.prodname_spark_short %} app creation

Each prompt consumes 4 premium requests, which draw from your plan's premium request allowance. If you or an administrator has set a budget for premium requests over your plan's allowance, additional premium requests beyond your plan’s included amount are billed at {% data variables.copilot.additional_premium_requests %} per request, meaning that one prompt to {% data variables.product.prodname_spark_short %} would cost **$0.16**. See [AUTOTITLE](/copilot/concepts/copilot-billing/understanding-and-managing-requests-in-copilot).
Each prompt consumes 4 premium requests, which draw from your plan's premium request allowance. If you have enabled premium requests over your plan's allowance, additional premium requests beyond your plan’s included amount are billed at {% data variables.copilot.additional_premium_requests %} per request, meaning that one prompt to {% data variables.product.prodname_spark_short %} would cost **$0.16**. See [AUTOTITLE](/copilot/concepts/copilot-billing/understanding-and-managing-requests-in-copilot).

## Billing and limits for {% data variables.product.prodname_spark_short %} app deployment

Expand Down
11 changes: 4 additions & 7 deletions content/copilot/concepts/billing/copilot-requests.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,15 +68,12 @@ Unused requests for the previous month do not carry over to the following month.

If you're on a **paid plan** and use all of your premium requests, you can still use {% data variables.product.prodname_copilot_short %} with one of the included models for the rest of the month. This is subject to change. Response times for the included models may vary during periods of high usage. Requests to the included models may be subject to rate limiting. See [AUTOTITLE](/copilot/concepts/rate-limits).

If you need more premium requests beyond your monthly allowance, you can:
If you need more premium requests beyond your monthly allowance:

* Set a spending limit for additional premium requests. See [AUTOTITLE](/billing/managing-your-billing/using-budgets-control-spending).
* Upgrade your individual subscription to a higher plan.
* If you're an enterprise owner, edit the default $0 budget or upgrade members to {% data variables.copilot.copilot_enterprise_short %}. See [AUTOTITLE](/copilot/how-tos/premium-requests/manage-for-enterprise).
* For an individual subscription, set a budget for additional premium requests or upgrade to a higher plan. See [AUTOTITLE](/billing/managing-your-billing/using-budgets-control-spending).
* If you're an enterprise or organization owner, ensure that the "Premium request paid usage" policy is enabled and that extra spending is not prevented by a budget. See [AUTOTITLE](/copilot/how-tos/premium-requests/manage-for-enterprise).

These actions can be taken by enterprise owners, organization owners, billing managers, and personal account users.

> [!IMPORTANT] By default, all budgets are set to zero and premium requests over the allowance are rejected unless a budget has been created. Additional premium requests beyond your plan’s included amount are billed at {% data variables.copilot.additional_premium_requests %} per request.
{% data reusables.copilot.zero-budget-changes %}

## Model multipliers

Expand Down
2 changes: 1 addition & 1 deletion content/copilot/get-started/choose-enterprise-plan.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,7 @@ Each {% data variables.product.prodname_copilot_short %} plan includes a per-use

By ensuring members have access to enough premium requests, you can drive real business outcomes, such as reducing your backlog with {% data variables.copilot.copilot_coding_agent %}, accelerating pull requests with {% data variables.copilot.copilot_code-review_short %}, or increasing code quality with suggestions from more specialized models.

Regardless of your plan, you can set a spending limit for premium requests over your plan's allowance. Premium requests over the allowance will be charged at a rate of {% data variables.copilot.additional_premium_requests %} per request, with an additional multiplier applied to certain models.
Regardless of your plan, you can enable or disable premium requests over your plan's allowance. Premium requests over the allowance will be charged at a rate of {% data variables.copilot.additional_premium_requests %} per request, with an additional multiplier applied to certain models.

## Making a decision

Expand Down
2 changes: 1 addition & 1 deletion content/copilot/how-tos/manage-and-track-spending/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ topics:
- Copilot
children:
- /monitor-premium-requests
- /manage-for-your-enterprise
- /manage-request-allowances
- /manage-company-spending
redirect_from:
- /copilot/how-tos/premium-requests
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -39,9 +39,9 @@ This report includes all premium request usage by user, both within and beyond t

### Granting more premium requests to members

By default, enterprises have a $0 budget for the Premium Request SKU. This means that when users exhaust their allowance, they cannot make any more premium requests for the rest of the month. Deleting this budget allows for **unlimited spending**.
Your organization or enterprise's policies and budgets determine whether users can use premium requests over their included allowance. See [AUTOTITLE](/copilot/how-tos/premium-requests/manage-for-enterprise).

To change the default budget or increase members' base allowance, see [AUTOTITLE](/copilot/how-tos/premium-requests/manage-for-enterprise).
{% data reusables.copilot.zero-budget-changes %}

## Mapping spending to groups of users

Expand All @@ -56,7 +56,7 @@ For more information, see [AUTOTITLE](/billing/tutorials/use-cost-centers).
You can set a monthly budget on {% data variables.product.prodname_copilot %} spending.

* For {% data variables.product.prodname_copilot_short %} **licenses**, a budget is for monitoring purposes only and will not prevent usage beyond the budgeted amount. However, you will receive notifications by email when spending exceeds certain percentages of the budget you've set.
* For {% data variables.product.prodname_copilot_short %} **premium requests**, you can choose to stop usage once the budget amount is reached. The default $0 budget for enterprises already does this.
* For {% data variables.product.prodname_copilot_short %} **premium requests**, you can choose to stop usage once the budget amount is reached.

To create a budget, see [AUTOTITLE](/billing/managing-your-billing/using-budgets-control-spending#editing-or-deleting-a-budget).

Expand Down
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
---
title: Managing the premium request allowance for users in your enterprise
shortTitle: Manage for your enterprise
intro: 'Change the default spending limit or upgrade users to {% data variables.copilot.copilot_enterprise_short %}.'
permissions: Enterprise owners
title: Managing the premium request allowance for your organization or enterprise
shortTitle: Manage request allowances
intro: 'Configure policies and budgets for premium requests, or upgrade users to {% data variables.copilot.copilot_enterprise_short %}.'
permissions: Enterprise owners and organization owners
versions:
feature: copilot
topics:
Expand All @@ -13,38 +13,47 @@ redirect_from:
- /copilot/how-tos/premium-requests/manage-for-enterprise
- /copilot/how-tos/spending/manage-for-enterprise
- /copilot/how-tos/spending/manage-for-your-enterprise
- /copilot/how-tos/manage-and-track-spending/manage-for-your-enterprise
contentType: how-tos
---

Each {% data variables.product.prodname_copilot_short %} plan includes a per-user allowance for premium requests. To learn more about premium requests, see [AUTOTITLE](/copilot/concepts/copilot-billing/requests-in-github-copilot). For allowances per plan, see [AUTOTITLE](/copilot/get-started/plans-for-github-copilot#comparing-copilot-plans).
Each {% data variables.product.prodname_copilot_short %} plan includes a per-user allowance for premium requests. If enabled, requests over the allowance are billed to your organization or enterprise. To learn more about premium requests, see [AUTOTITLE](/copilot/concepts/copilot-billing/requests-in-github-copilot). For allowances per plan, see [AUTOTITLE](/copilot/get-started/plans-for-github-copilot#comparing-copilot-plans).

By default, every enterprise has a $0 budget for the Premium Request SKU. Unless this budget is edited or deleted, your enterprise will have **no extra costs** for premium requests: when one of your licensed users exhausts the allowance in their plan, the user's premium requests will be rejected for the rest of the month.
Your organization or enterprise's policies and budgets determine whether users can use premium requests over their included allowance:

![Screenshot of the enterprise budgets page, with the default budget: a $0 budget for the Premium Request SKU.](/assets/images/help/copilot/enterprise-premium-request-budget.png)
* The **Premium request paid usage** policy determines whether users can surpass their included allowance. This policy is enabled by default.
* If your enterprise or organization has a budget that caps usage of the **Premium Request SKU**, additional requests are blocked once the budget amount is reached for the billing period.

You can edit or delete this budget to grant extra requests to all your licensed members. If you want to grant extra requests to certain users only, you can upgrade those users to {% data variables.copilot.copilot_enterprise_short %}.
You can increase the allowance for users by ensuring the policy is enabled, editing your budgets, or upgrading users to {% data variables.copilot.copilot_enterprise_short %}.

{% data reusables.copilot.zero-budget-changes %}

## Prerequisites

* Before making changes, download a usage report to see which developers are frequently hitting the limit or using a significant number of requests over the allowance. You may want to contact these users to understand their use cases and requirements. See [Downloading a monthly usage report](/copilot/how-tos/monitoring-your-copilot-usage-and-entitlements#downloading-a-monthly-usage-report).
* If a user receives licenses from multiple enterprises or standalone organizations, the user must select a billing entity to use premium requests. See [Managing premium request billing with multiple {% data variables.product.prodname_copilot_short %} licenses](/copilot/managing-copilot/monitoring-usage-and-entitlements/monitoring-your-copilot-usage-and-entitlements#managing-premium-request-billing-with-multiple-copilot-licenses).

## Changing the budget for all members
## Setting a policy for paid usage

By default, premium requests over the allowance are enabled for organizations and enterprises. This allows for uninterrupted use of premium requests, unless you have a budget that caps spending on the Premium Request SKU.

You can set the policy for an enterprise or a standalone organization.

To enable premium requests over the allowance for everyone, you can:
1. Navigate to the policy settings for your enterprise or organization. See [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-enterprise-policies) or [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-organization/manage-policies).
1. Next to "Premium request paid usage", select the policy for your organization or enterprise.

* Delete the default $0 budget to allow **unlimited spending on premium requests** for all users.
* Edit the "Budget amount" of the default $0 budget to set **a non-zero total spending limit** for premium requests in your enterprise.
## Updating budgets

For instructions, see [AUTOTITLE](/billing/managing-your-billing/using-budgets-control-spending#editing-or-deleting-a-budget).
1. Ensure the "Premium request paid usage" policy is enabled. See [Setting a policy for paid usage](#setting-a-policy-for-paid-usage).
1. Check the budgets for your enterprise or organizations, and edit or delete any budgets that "stop usage when budget limit is reached" for the Premium Request SKU. See [AUTOTITLE](/billing/managing-your-billing/using-budgets-control-spending#editing-or-deleting-a-budget).

>[!NOTE] Creating new budgets without deleting the $0 budget does not override the $0 budget. If **any** applicable budget with "Stop usage when budget limit is reached" enabled is exhausted, additional premium requests are blocked.
Creating new budgets without deleting an existing budget does not override the existing budget. If **any** applicable budget with "Stop usage when budget limit is reached" enabled is exhausted, additional premium requests are blocked.

## Upgrading users to {% data variables.copilot.copilot_enterprise_short %}

You can upgrade certain users to increase their base allowance of premium requests.
An enterprise owner can upgrade certain users to increase their base allowance of premium requests.

>[!TIP] {% data variables.copilot.copilot_business_short %} users who make make more than 800 premium requests per month would save money with a {% data variables.copilot.copilot_enterprise_short %} license.
>[!TIP] {% data variables.copilot.copilot_business_short %} users who make more than 800 premium requests per month would save money with a {% data variables.copilot.copilot_enterprise_short %} license.

1. Create a new organization in your enterprise. See [AUTOTITLE](/enterprise-cloud@latest/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise#creating-a-new-organization).
1. Add the users who need more premium requests to the new organization.
Expand All @@ -64,6 +73,7 @@ You can set a higher budget for premium requests over the allowance for specific

At a high level, the required steps are:

1. Delete the default $0 budget.
1. Ensure the "Premium request paid usage" policy is enabled. See [Setting a policy for paid usage](#setting-a-policy-for-paid-usage).
1. Delete the default $0 budget if it applies to your organization or enterprise.
1. Create a new budget for the users who need a higher allowance. For example, create an organization or cost center containing just these users, then create a Premium Request SKU budget for the organization or cost center.
1. Create a separate, more restrictive budget that covers every other {% data variables.product.prodname_copilot_short %} user in your enterprise. You will likely need to integrate with the API to ensure that this budget covers new users as they are added to your enterprise.
Original file line number Diff line number Diff line change
Expand Up @@ -87,8 +87,7 @@ You can use the following strategies to maximize the value of your premium reque

* **Setting a budget**. Set a budget to track your overages and receive alerts when you reach 75%, 90%, or 100% of your budget. See [AUTOTITLE](/billing/managing-your-billing/preventing-overspending#managing-budgets-for-your-personal-account).

>[!NOTE]
> By default, all budgets are set to zero and premium requests over the allowance are rejected unless a budget has been created.
{% data reusables.copilot.zero-budget-changes %}

* **Monitor your usage regularly**. Check your usage in your {% data variables.product.github %} account settings to see how many premium requests you’ve used. This helps you plan how much you can use for the rest of the month.

Expand Down
2 changes: 1 addition & 1 deletion content/graphql/guides/forming-calls-with-graphql.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ If you access {% data variables.product.github %} at a different domain, such as

## Communicating with GraphQL

Because GraphQL operations consist of multiline JSON, GitHub recommends using the [Explorer](/graphql/guides/using-the-explorer) to make GraphQL calls. You can also use `curl` or any other HTTP-speaking library.
Because GraphQL operations consist of multiline JSON, GitHub recommends using the [GraphQL Clients](/graphql/guides/using-graphql-clients) to make GraphQL calls. You can also use `curl` or any other HTTP-speaking library.

In REST, [HTTP verbs](/rest#http-verbs) determine the operation performed. In GraphQL, you'll provide a JSON-encoded body whether you're performing a query or a mutation, so the HTTP verb is `POST`. The exception is an [introspection query](/graphql/guides/introduction-to-graphql#discovering-the-graphql-api), which is a simple `GET` to the endpoint. For more information on GraphQL versus REST, see [AUTOTITLE](/graphql/guides/migrating-from-rest-to-graphql).

Expand Down
2 changes: 1 addition & 1 deletion content/graphql/guides/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ children:
- /forming-calls-with-graphql
- /using-global-node-ids
- /migrating-from-rest-to-graphql
- /using-the-explorer
- /using-graphql-clients
- /using-pagination-in-the-graphql-api
- /managing-enterprise-accounts
- /using-the-graphql-api-for-discussions
Expand Down
Loading
Loading