# Update redeemable custom tags

**POST /redeemables/{redeemable}/update-tags**

Replaces the redeemable's `custom` tag group with the given
key-value pairs. Tags inherited from the purchase (`product`,
`variant`, `addon`, `promotion`, `discount_group`) are never
modified. Send an empty object to clear the custom tags. Filter
vouchers by these tags with `filter[tags][custom.<key>]`.
Useful for storing client-side state against a redeemable, such
as a hold amount on a monetary redeemable.
Requires `redeem_vouchers` permission.



## Servers
- GB server: https://api.gb.enjovia.app (GB server)
- EU server: https://api.eu.enjovia.app (EU server)
- US server: https://api.us.enjovia.app (US server)
- AU server: https://api.au.enjovia.app (AU server)
- Asia server: https://api.asia.enjovia.app (Asia server)


## Authentication methods
- Bearer auth


## Parameters
### Headers

- **Account-ID** (string(uuid))
  Account ID - Can be found on the Dashboard under Settings → API Tokens


### Path parameters

- **redeemable** (string(uuid))



### Body: application/json (object)

- **tags** (object)
  The new custom tags. Keys must be non-numeric strings
  without dots, quotes, or backslashes (maximum 100
  characters); values are strings (maximum 100 characters).
  Values containing commas cannot be matched by the
  comma-separated tag filter syntax.



## Responses
### 200
Tags updated

#### Body: application/json (object)
- **data** (object)
  A redeemable item that can be redeemed by a customer. Represents either a monetary value (gift card) or a standard item (experience, product, service).


### 404
Redeemable not found

### 403
Missing redeem_vouchers permission

### 422
Invalid tags


[Powered by Bump.sh](https://bump.sh)