API referenceCatalogImports

Prepare import upload

Creates a server-bound uploadRef and short-lived PUT instructions. After uploading the file, use the same uploadRef to preview or commit it.

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

Get import GET

Returns one import run with its current status, row counts, and validation or execution error when present.

Preview import POST

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