Bulk Use Base Product for Configurable Products
POST/api/configurable-products/bulk-use-base-product
Run Use Base Product for several configured SKUs at once. A configured SKU with no base product recorded, an archived base product, or that no longer exists is skipped with the reason; one that raises an error is reported as failed and the rest carry on.
products:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token (scope products:write) and the permission to create products.
Body:
ids(array of integers, required, 1 to 2,000, distinct) — configured SKU (mapping) IDs.
Up to 25 IDs run now and return 200 with the outcome:
summary— one line, e.g. "2 configured SKUs use the base product, 3 waiting lines linked; 1 skipped."rows_processed,rows_used_base,rows_skipped,rows_failed— configured SKUs by outcome.waiting_lines_linked— waiting order lines queued to link to their base product.has_failures,failed_count.errors/warnings—[{message}], one per failed and per skipped configured SKU.results[]— per configured SKU:id,outcome(used_base|skipped|failed),configured_sku,product_id(the base product),message(why it was skipped or failed),relinked_lines.
More than 25 IDs run in the background and return 202 with tracked_job_id and data.tracked_job_log_id. The job's results hold the same fields once it completes.
Returns 422 on validation errors, 404 while line options are switched off.
Request
Responses
- 200
- 202
- 401
- 403
- 422
- 429
OK
Response Headers
Accepted
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.