API referenceCatalogImports

Commit import

Starts the catalog import after preview. Product files with prices must declare pricesIncludeIva; stock imports may require inventoryLocationId. Reuse the same Idempotency-Key only for the identical request.

Endpoint: POST /v1/imports/uploads/{uploadRef}/commit
Authorization: Required permission: `imports:manage`.
Environments: Production only
Idempotency: Required for safe retries.

Preview import POST

Validates and previews the uploaded rows without changing catalog data. Returns mappings, row counts, missing fields, and representative skipped rows.

Discard import upload DELETE

Discards an import upload that has not been committed and removes its temporary file.