Variants API

REST API endpoints for managing product variants (SKU, price, stock, options).

Product variants represent the purchasable versions of a product — different sizes, colors, or configurations. Each variant has its own SKU, price, stock level, and optional image.

Get Variant

GET /api/v1/variants/:idOrSku

Returns a variant by UUID or SKU code, including product info and price.

Query Parameters

Parameter	Type	Description
`currency`	`string`	Currency code for price resolution (e.g. `EUR`)

{
  "id": "0191abc0-0000-7000-8000-000000000100",
  "sku": "CT-SM-BLK",
  "title": "Small / Black",
  "priceCents": 2500,
  "currency": "USD",
  "imageUrl": "https://cdn.example.com/tee-black.jpg",
  "stock": 42,
  "productId": "0191abc0-1234-7def-8000-000000000001",
  "product": {
    "id": "0191abc0-1234-7def-8000-000000000001",
    "name": "Classic Tee",
    "slug": "classic-tee",
    "images": ["https://cdn.example.com/tee.jpg"]
  }
}

Update Variant

PATCH /api/v1/variants/:idOrSku

Partially updates a variant by UUID or SKU. Only the provided fields are changed.

Request Body

Field	Type	Description
`sku`	`string`	New SKU code
`title`	`string`	Variant display name (e.g. `Large / Red`)
`priceCents`	`number`	Price in cents (e.g. `2999` = $29.99)
`images`	`string[]`	Replace the variant's images. External URLs are uploaded to the store's CDN; URLs already on the CDN pass through. `[]` removes all images.
`imageUrl`	`string \| null`	Deprecated — prefer `images`. Single variant image URL (`null` to remove). External URLs are now uploaded to the store's CDN (previously stored verbatim). Cannot be combined with `images`.
`stock`	`number`	Inventory quantity

Sending both images and imageUrl returns 400.

curl -X PATCH \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "priceCents": 2999,
    "stock": 100,
    "sku": "CT-SM-BLK-V2"
  }' \
  https://your-store.yns.store/api/v1/variants/CT-SM-BLK

Delete Variant

DELETE /api/v1/variants/:idOrSku

Permanently deletes a variant by UUID or SKU. Cannot delete the last variant of a product.

Returns 204 No Content on success.

PreviousInventoryAPI Reference NextSearchAPI Reference