Move Line to Configured Product
POST/api/configurable-products/lines/:salesOrderLineId/move
Move one sales order line from its base product to its configured SKU's product — Re-link Open Lines for a single line. The line is replaced by a line for the configured product with the same quantity, price, channel tax and line discounts and its options, so the order's total, discount, tax and balance due don't change. Check Line Move to Configured Product tells you first whether it will move.
products:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token (scopes products:write and orders:write) and the permissions to create products and update sales orders.
No body. Response data: sales_order_line_id — the ID of the line now on the configured product (moving replaces the line, so it differs from the ID you sent); product_id — the configured product.
Returns 422 when the line can't move, with message and reason (the same sentence), code and fix — the same values Check Line Move to Configured Product returns (see its Blocked lines list). A refusal during the move itself (for example the move would change the order's total, or the line changed meanwhile) returns code: "move_refused" with fix: "open_order". Returns 404 when the line does not exist or line options are switched off.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
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.
Not Found
Response Headers
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.