# Update order custom tags

**POST /orders/{order}/update-tags**

Replaces the order's `custom` tag group with the given key-value
pairs. Tags inherited from the purchase (`store`, `products`,
`variants`, `addons`, `promotion`, `user`) are never modified.
Send an empty object to clear the custom tags. Filter orders by
these tags with `filter[tags][custom.<key>]`.
Requires `process_orders` 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

- **order** (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)
  Represents a customer order containing transaction details, vouchers, and redeemables


### 404
Order not found

### 403
Missing process_orders permission

### 422
Invalid tags


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