> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# prices_update

> Update a price's label, metadata or active flag. What it costs cannot be changed: to reprice, create a new price and set `active` false on this one.

<div className="tool-route"><span className="tool-row-method" data-method="POST">POST</span><code>{"https://api.stripe.com/v1/prices/{price}"}</code></div>

```python stripe_prices_update.py theme={null}
from charter.packs import stripe

result = await stripe.prices_update.ainvoke({"price": ...})
```

## Path parameters

<div className="reference-table">
  | Field                                                         | Type     | Description                    |
  | ------------------------------------------------------------- | -------- | ------------------------------ |
  | `price` <span className="required" title="required">\*</span> | `string` | The ID of the price to update. |
</div>

## Body

<div className="reference-table">
  | Field         | Type                                                                            | Description                                                                               |
  | ------------- | ------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
  | `active`      | `boolean`                                                                       | Whether the price can be used. Setting this false is how a price is retired.              |
  | `nickname`    | `string`                                                                        | An internal label.                                                                        |
  | `lookupKey`   | `string`                                                                        | A key to look this price up by. <span className="field-constraints">max length 200</span> |
  | `taxBehavior` | [PriceTaxBehavior](/charter/charter/packs/stripe/invoiceitems/objects#pricetaxbehavior) | Whether the amount includes tax. Settable only while it is still 'unspecified'.           |
  | `metadata`    | map of `string`                                                                 | Set of key-value pairs attached to the price.                                             |
</div>