Product Import
Get Import Fields
Returns dynamic import fields (currently account-specific attributes) used by the column mapping UI.
Download Import Template (XLSX)
Downloads the multi-sheet XLSX import template, prefilled with sample rows and tenant reference data (brands, categories).
Validate Import
Validates mapped import rows and returns a structured preview. No side effects — safe to call repeatedly.
Execute Import
Imports run as a tracked job — a bulk import can exceed a ~100s edge-proxy limit (Cloudflare 524), so the rows are processed off the request cycle. Returns a tracked_job_log_id; progress and the created/updated/failed counts surface via the tracked job log endpoints. The request body is the validated rows from the import preview.