Batch Update Location Tags
Adds, removes or replaces LocationTag assignments on many locations at once, mirroring the
admin location grid’s tag mass actions.
Every referenced location must exist in the warehouse. A tag that has been soft-deleted
cannot be newly assigned, but add and remove leave an already-assigned deleted tag in
place on locations the operation does not affect. replace is stricter: a soft-deleted tag
may not appear in a replace payload at all, even if every targeted location already
carries it.
Authorizations
Generate a JWT access token through a Custom Global Integration and provide it with each request in the Authorization header prefixed with "Bearer" and then a single space.
Path Parameters
The id of the referenced Warehouse.
x >= 1Body
add: Assign the tags to each location, keeping its existing tagsremove: Unassign the tags from each location, keeping its other tagsreplace: Replace each location's whole tag set with the submitted tags
add, remove, replace The LocationTag references to add, remove or assign. May only be empty for the
replace operation, which then clears every tag from the locations.
100The ids of the Location objects to update. The whole batch is applied in one
transaction that holds a row lock on each location, so the limit is well below
that of a read endpoint; split larger sets into successive requests.
1 - 1000 elementsx >= 1