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

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Update Item Taxes

> Updates the [CatalogTax](entity:CatalogTax) objects that apply to the targeted [CatalogItem](entity:CatalogItem) without having to perform an upsert on the entire item.

`square.updateItemTaxes` updates the [CatalogTax](entity:CatalogTax) objects that apply to the targeted [CatalogItem](entity:CatalogItem) without having to perform an upsert on the entire item.

## Example

```ts automations/square-update-item-taxes.automation.ts theme={null}
import { automation, onDashboardRun } from "automate.ax"
import { square } from "automate.ax/square"

export default automation("Update Square Item Taxes", () => {
  onDashboardRun({ title: "Update Square Item Taxes" })

  square.updateItemTaxes({
    itemIds: ["H42BRLUJ5KTZTTMPVSLFAACQ", "2JXOBJIHCWBQ4NZ3RIXQGJA6"],
    taxesToEnable: ["4WRCNHCJZDVLSNDQ35PP6YAD"],
    taxesToDisable: ["AQCEGCEBBQONINDOHRGZISEX"],
  })
})
```

## Inputs

Every input accepts a compatible signal. It requires `ITEMS_WRITE`.

| Field            | Type               | Required | Default | Description                                                                                                            |
| ---------------- | ------------------ | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------- |
| `itemIds`        | `string[]`         | Yes      | —       | IDs for the CatalogItems associated with the CatalogTax objects being updated. No more than 1,000 IDs may be provided. |
| `taxesToEnable`  | `string[] \| null` | No       | —       | IDs of the CatalogTax objects to enable. At least one of `taxes_to_enable` or `taxes_to_disable` must be specified.    |
| `taxesToDisable` | `string[] \| null` | No       | —       | IDs of the CatalogTax objects to disable. At least one of `taxes_to_enable` or `taxes_to_disable` must be specified.   |

Use the official [UpdateItemTaxes reference](https://developer.squareup.com/reference/square/catalog-api/update-item-taxes) for provider field semantics and limits.

## Output

Returns the official `Square.UpdateItemTaxesResponse` response as a codec-safe object. Square integer money amounts remain `bigint` values.