🔐 This endpoint requires HTTP authentication (either Basic or Bearer). For authenticating with Bearer token, required scopes are: catalog(w), search_suggestions(w).

Replace the current catalog using one of two modes: Full mode (mode=full, default): Send full catalog files to replace the current catalog. You may upload up to three files in the form data under the following keys: items, variations, item_groups. If you do not wish to replace one of these types of resources then omit it from the request. Any records that already exist will be deleted and replaced with the records you provide in the files. IDs mode (mode=ids): Send files containing only the IDs of records to keep. Files should contain only an id column (CSV) or id field (JSONL). All records whose IDs are not present in the uploaded files will be deleted from the catalog. Returns an identifier for a background task.