Import batch IDs
importBatchId must be a UUID, such as 11111111-2222-3333-4444-555555555555, rather than a free-form import label. This applies to garment bulk upsert, variant bulk upsert, and bulk status-and-stock updates. Reuse the batch UUID when updating the status or stock of the same imported batch. Invalid supplied IDs return HTTP 400 with error code VALIDATION.
The batch ID is optional for the two upsert operations and required for status-and-stock updates. The downloadable OpenAPI specification and Postman collection include valid UUID examples.
Status-and-stock updates affect only garments and variants created by that import batch. Updating an existing item through an upsert does not move it into the new batch. Check garmentsUpdated and variantsUpdated: a successful response with both counts at zero means no items were changed.
Operations
See Authentication before your first call. For write retries, see Writing safely.