Update the maximum amount that merchants can be charged for their subscription. You should do this if you change your pricing model.

> Note:
> If you try to create a usage record for a usage pricing plan with an amount that's less than the new usage record, then the request fails. You need to increase the `cappedAmount`, and then obtain merchant approval before you can create more usage records.

## Requirements

- Your app can make [authenticated requests](/docs/api/admin-graphql#authentication) to the GraphQL Admin API.


## Step 1: Retrieve charge data

Make a request to the [`AppSubscription`](/docs/api/admin-graphql/latest/objects/AppSubscription) object for the following data:

- `id`
- `cappedAmount`

    The `cappedAmount` is the maximum that a merchant is billed for during the 30-day billing cycle. The `currencyCode` must be one of the [supported currencies](/docs/apps/launch/billing#supported-currencies).
- `balanceUsed`

The following query is an example:

```graphql
query {
  node(id: "gid://shopify/AppSubscription/4019585080") {
    ...on AppSubscription {
      lineItems {
        plan {
          pricingDetails {
            ...on AppUsagePricing {
              terms
              cappedAmount {
                amount
                currencyCode
              }
              balanceUsed {
                amount
                currencyCode
              }
            }
          }
        }
      }
    }
  }
}

```json
{
  "data": {
    "node": {
      "lineItems": [
        {
          "plan": {
            "pricingDetails": {
              "terms": "$1 for 100 emails",
              "cappedAmount": {
                "amount": "20.0",
                "currencyCode": "USD"
              },
              "balanceUsed": {
                "amount": "0.0",
                "currencyCode": "USD"
              }
            }
          }
        }
      ]
    }
  },
  ...
}
```



## Step 2: Update the capped amount

Update the app subscription's capped amount by passing the `AppSubscription` ID to the [`appSubscriptionLineItemUpdate`](/docs/api/admin-graphql/latest/mutations/appSubscriptionLineItemUpdate) mutation as an argument.

The following mutation is an example:

```graphql
mutation {
  appSubscriptionLineItemUpdate(
    id: "${AppSubscriptionLineItemUsagePricing_gid}"
    cappedAmount: { amount: 100.00, currencyCode: USD }
  ) {
    userErrors {
      field
      message
    }
    confirmationUrl
    appSubscription {
      id
    }
  }
}

```json
{
  "data": {
    "appSubscriptionLineItemUpdate": {
      "userErrors": [],
      "confirmationUrl": "https://domain.myshopify.com/admin/charges/4019585080/confirm_update_capped_amount?signature=BAh7BzoHaWRsKwc4AJbvOhJhdXRvX2FjdGl2YXRlRg%3D%3D--a93b35054feb213f04f1ee35ef5b569617ce6823",
      "appSubscription": {
        "id": "gid://shopify/AppSubscription/4019585080"
      }
    }
  },
  ...
}
```



## Next steps


<div class="resource-card-grid">
  <div>
  <a class="resource-card" href="/docs/apps/launch/billing/subscription-billing/offer-subscription-discounts" data-theme-mode="">
    <div class="resource-card__indicator-container"><img
     src="/assets/resource-cards/star"
     data-alt-src="/assets/resource-cards/star-dark"
     aria-hidden="true"
     class="resource-card__icon themed-image"></div>
    <h3 class="resource-card__title">
      Discounts
    </h3>
    <p class="resource-card__description">Learn about offering subscription discounts.</p>
  </a>
</div>
</div>