v1

latestOpenAPI 3.0.0Apache 2.02026-07-143281,4552.1 MB
Catalog

UpdateItemTaxes

Updates the CatalogTax objects that apply to the targeted CatalogItem without having to perform an upsert on the entire item.

post/v2/catalog/update-item-taxes

Request body

item_idsstring[] required

IDs for the CatalogItems associated with the CatalogTax objects being updated. No more than 1,000 IDs may be provided.

taxes_to_enablestring[] nullable

IDs of the CatalogTax objects to enable. At least one of taxes_to_enable or taxes_to_disable must be specified.

taxes_to_disablestring[] nullable

IDs of the CatalogTax objects to disable. At least one of taxes_to_enable or taxes_to_disable must be specified.

Example request

{
  "item_ids": [
    "H42BRLUJ5KTZTTMPVSLFAACQ",
    "2JXOBJIHCWBQ4NZ3RIXQGJA6"
  ],
  "taxes_to_disable": [
    "AQCEGCEBBQONINDOHRGZISEX"
  ],
  "taxes_to_enable": [
    "4WRCNHCJZDVLSNDQ35PP6YAD"
  ]
}

Response

Success

updated_atstring

The database timestamp of this update in RFC 3339 format, e.g., 2016-09-04T23:59:33.123Z.

Example response

{
  "updated_at": "2016-11-16T22:25:24.878Z"
}