Skip to main content
POST
Bulk Upsert Product Variants Public

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-Organization-Id
string | null

Path Parameters

catalog_id
string
required

Parent product catalog item database ID, not the business product_id field value.

product_id
string
required

Body

application/json

Bulk upsert variants for a product using variants payload.

  • product: product-level fields (typically keys prefixed with 'product_')
  • variants: list of variant objects
  • source_info: optional metadata recorded on items
  • auto_evolve_schema: accepted for compatibility; public bulk writes currently allow schema evolution from submitted item data
variants
Variants · object[]
required
product
Product · object
source_info
Source Info · object | null
auto_evolve_schema
boolean | null

Response

Successful Response

product_id
string
required
items_processed
integer
required
items_created
integer
required
items_updated
integer
required
items_failed
integer
required
schema_evolved
boolean
required
new_schema_version
string | null
errors
Errors · object[]
duplicates_in_payload
integer
default:0
error_summary
Error Summary · object
warnings
Warnings · object[]
warnings_summary
Warnings Summary · object