---
title: "Update a product rate plan charge tier"
method: PUT
path: "/commerce/tiers"
tags: ["Commerce"]
---

# Update a product rate plan charge tier

`PUT /commerce/tiers`

Updates the price and other editable attributes, when supported, for a specific **Product Rate Plan Charge Tier**.

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string

## Request body

- UpdateTierRequest — Request body to update a Product Rate Plan Charge Tier.
  - `id` string, required — **Product Rate Plan Charge Tier ID** (`productRatePlanChargeTierId`). This is the unique identifier of the tier row under a Product Rate Plan Charge. This identifier is **not surfaced by the new Commerce APIs** and is typically retrieved via **Zuora Data Query (DQ)** or by using the legacy v1 Object API equivalence: `/v1/object/product-rate-plan-charge-tier/{id}` <a href="https://developer.zuora.com/v1-api-reference/api/operation/Object_PUTProductRatePlanChargeTier/">CRUD: Update a product rate plan charge tier</a>
  - `price` number, double, required — Tier price to apply for the specified currency/quantity range.

## Response `200`

OK

- UpdateTierResponse — Product Rate Plan Charge Tier record returned after a successful update.
  - `id` string, required — Product Rate Plan Charge Tier ID.
  - `currency` string, required — ISO currency code for this tier.
  - `price` number, double, required — Price configured for this tier.
  - `startingUnit` number, required — The inclusive starting unit for this tier’s range.
  - `endingUnit` number, required — The inclusive ending unit for this tier’s range. `0` can represent open-ended depending on tenant configuration.
  - `tier` string — Display order or label of the tier within the charge.
  - `isOveragePrice` boolean — Indicates whether this tier represents an overage price row.
  - `priceFormat` string — Price format applied to this tier (for example, `price_format_flat_fee`).
  - `createdById` string — ID of the user who created the tier.
  - `createdTime` string, date-time — Timestamp when the tier was created.
  - `updatedById` string — ID of the user who last updated the tier.
  - `updatedTime` string, date-time — Timestamp when the tier was last updated.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)