latestSwagger 2.02026-08-10148196271.0 KB

afaab604b58c

catalogs

Bulk create catalog items

Asynchronous. Create up to 1000 catalog items with a single request. Each of a catalog's items must have a unique ID that contains only alphanumeric characters and dashes and has a maximum length of 255 characters. If the catalog already contains an item with the same ID as one provided in the request body, the item in the catalog will be completely overwritten, unless replaceUploadedFieldsOnly is set to true. Do not use periods in field names.<br/><br/><b>Rate limit</b>: 100 requests/second, per API key.

post/api/catalogs/{catalogName}/items

Path parameters

catalogNamestring required

Catalog name [Alphanumeric, dashes, case insensitive, 255 characters max]

Request body

documentsobject required

Json map of id to values. Max number of pairs in list is 1000. Max size of each json value is is 30kb.

replaceUploadedFieldsOnlyboolean required

Whether to replace only the upload fields within each document, not each entire document

Response

successful operation