Update products in bulk

Updates up to 100 voucher products for the API-key community and returns the updated public product records.

Use this endpoint when a partner integration needs to patch many products at once. Send a raw JSON array of sparse update objects keyed by productID, or upload a CSV file with multipart form-data for spreadsheet-based operational updates.

Authentication:

Bearer API key in the Authorization header. Example: Bearer XXXXXX.

Required API-key permission: store.

The community is resolved from the API key token; do not pass communityID.

Missing, invalid, expired, or insufficient credentials return 401 or 403.

Request formats:

application/json: raw array of product update objects. Do not wrap the array in an object such as products.

multipart/form-data: CSV upload using the file field.

CSV MIME type must be text/csv, application/csv, or application/vnd.ms-excel.

CSV file size must be 10 MiB or less.

Bulk limits and validation:

Maximum 100 products per request.

Every JSON item must include productID.

JSON items may include any subset of editable product fields.

When JSON includes nested groups such as userInformation, expiringVoucherHighlight, or productPermission, send the complete nested shape for that field.

categoryName, productPermission, and purchaseStatusOverrideName use readable names resolved inside the API-key community.

vouchers appends new voucher codes; it does not replace existing voucher codes.

voucherExpireDate is required when vouchers contains voucher codes.

Duplicate product IDs in one bulk update return validation errors before product preparation.

Duplicate voucher codes in the upload, or voucher codes that already exist for the product, can return 409.

Validation errors include malformed JSON arrays, object wrappers, unsupported CSV MIME types, missing CSV file field, invalid CSV rows, invalid DTO fields, and product count limit violations.

CSV rules:

Rows with Product ID start a product update.

Rows without Product ID append permission entries to the previous product update.

Continuation rows cannot include scalar product columns such as Name, Price, Category Name, Vouchers, or Voucher Expire Date.

Nested CSV field groups are all-or-nothing: if one user-information column is provided, all user-information columns are required.

Nested CSV field groups are all-or-nothing: if one expiring voucher highlight column is provided, all expiring-highlight columns are required.

Supported headers are Product ID, Name, Description, Image, Price, Category Name, Discount Enabled, Discount Price, Discount Start Date, Discount End Date, User Information Enabled, Collect Name, Collect Phone, Collect Address, Prioritize Expiring Vouchers, Display Remaining Quantity, Expiring Highlight Enabled, Expiring Highlight Duration, Expiring Highlight Timeframe, Archived, Redemption Instructions, Product Access Enabled, Purchase Status Override Name, Vouchers, Voucher Expire Date, Permission Enabled, Permission Type, Roles, Tags, Users, Combination Type, Combination Values, Special Price, Special Price Enabled, Purchase Limit Enabled, Purchase Limit Quantity, Purchase Limit Interval Count, Purchase Limit Interval Unit, Access Level, and Exclusive Tag Enabled.

Side effects:

Updates existing voucher products in the resolved community.

Appends submitted voucher codes when vouchers is not empty.

Publishes PRODUCT_EVENTS.UPDATE_PRODUCTS through the partner publisher path.

The store service validates readable references, updates products, creates appended vouchers, and returns readable category, permission, and purchase-status fields.

Product data becomes available to store read endpoints after the store service persists the bulk operation.

Rate limits:

Standard API rate limits apply.

Related endpoints:

GET /products lists products.

POST /products creates one product.

POST /products/bulk creates products in bulk.

GET /products/{productID} reads one product.

PUT /products/{productID} updates one product.

DELETE /products/{productID} deletes one product.

curl --location --request PUT 'https://adss-integration.returning.ai/apis/products/bulk' \ --header 'Authorization: Bearer XXXXXX' \ --header 'Content-Type: application/json' \ --data '[ { "productID": "507f1f77bcf86cd799439011", "name": "Premium Voucher", "price": 120, "vouchers": [ "VOUCHER-003" ], "voucherExpireDate": "2026-12-31T00:00:00.000Z" } ]'

{ "meta": { "status": "success", "statusCode": 200, "updated": 1 }, "message": "Update products success.", "data": [ { "_id": "507f1f77bcf86cd799439011", "communityID": "6502c9e514a3e564c5c09c0a", "name": "Premium Voucher", "description": "<p>Updated premium access reward.</p>", "image": "https://example.com/product.png", "price": 120, "category": "Premium Rewards", "stocks": 3, "discountPrice": 100, "isDiscountEnabled": false, "discountStartDate": null, "discountEndDate": null, "userInformation": { "isEnabled": false, "shouldCollectName": false, "shouldCollectPhone": false, "shouldCollectAddress": false }, "shouldPrioritiesExpiringVouchers": false, "shouldDisplayRemainingQuantity": true, "expiringVoucherHighlight": { "isEnabled": false, "duration": 7, "timeframe": "days" }, "isArchived": false, "totalOrders": 0, "redemptionInstructions": "<p>Show this voucher at checkout.</p>", "productPermission": [ { "isEnabled": true, "type": "role", "permission": { "roleNames": [ "VIP Member" ], "tagNames": [ "Early Access" ], "usernames": [ "alex" ], "combination": [ { "type": "role", "values": [ "VIP Member" ] } ] }, "purchaseAccess": { "specialPrice": 80, "isSpecialPriceEnabled": false }, "purchaseLimit": { "isPurchaseLimitEnabled": false, "quantity": 1, "intervalCount": 1, "intervalUnit": "months" }, "accessLevel": "full-access", "isExclusiveTagEnabled": false } ], "isProductAccessEnabled": false, "purchaseStatusOverride": { "isEnabled": false, "status": null }, "createdAt": "2026-06-09T00:00:00.000Z", "updatedAt": "2026-06-11T00:00:00.000Z" } ] }

Request

Responses