Turn an empty SKU variant into an alias of another variant

POST /v1/sku-variants/{id}/convert-to-alias

Turn an empty SKU variant into an alias of another variant

Requires: sku.edit

Path Parameters

id required

string

- The empty variant to fold away

Request Body

- The variant that keeps existing

ConvertSkuOptionToAliasRequest

targetOptionIdrequired

string

The variant that keeps existing. The converted variant's name and aliases become aliases of this one, its SKU bindings move here, and it is deleted.

pattern: ^[a-z0-9]{24}$

Example Request

application/json

{
  "targetOptionId": "string"
}

Response Schema

SkuOption

aliasesoptional

string[]

Alternate names (as the merchant typed them) that resolve to this option.

createdAtrequired

string

format: date-time

idrequired

string

pattern: ^[a-z0-9]{24}$

isPersonalizationrequired

boolean

namerequired

string

storeIdrequired

string

pattern: ^[a-z0-9]{24}$

updatedAtrequired

string

format: date-time

Example Response

201 OK — application/json

{
  "name": "string",
  "isPersonalization": true,
  "id": "string",
  "storeId": "string",
  "createdAt": "2026-09-16T04:04:13.696Z",
  "updatedAt": "2026-09-16T04:04:13.696Z"
}