Update Variation

Update an existing product variation. Only include the fields you want to change.

Endpoint

PUT /v1/store-products/{id}/variations/{variationId}

Authentication

Requires an API key with the store:write scope.

Parameters

Parameter	Type	Location	Description
id	integer	path	The store product ID
variationId	integer	path	The product variation ID

Request Body

All fields are optional. Only included fields will be updated.

Field	Type	Description
sku	string	Stock keeping unit (max 255 characters)
price_override	number|null	Price override (min 0). Set to null to revert to the base product price.
stock_quantity	integer	Stock quantity (min 0)
option_values	array	Array of option value objects (min 1 item)
option_values[].option_id	integer	The variation option ID
option_values[].value	string	The selected value for this option (max 100 characters)

caution

If option_values is provided, it replaces all existing option values for this variation. The variation name will be regenerated from the new option values.

Response

Success (200 OK)

{
  "data": {
    "id": 1,
    "name": "Medium / Blue",
    "sku": "WIDGET-MD-B",
    "price_override": 18.99,
    "stock_quantity": 30,
    "option_values": [
      {
        "option_id": 1,
        "option_name": "Size",
        "value": "Medium"
      },
      {
        "option_id": 2,
        "option_name": "Color",
        "value": "Blue"
      }
    ],
    "created_at": "2026-02-15T12:00:00+00:00",
    "updated_at": "2026-02-15T14:30:00+00:00"
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-02-15T14:30:00+00:00"
  }
}

Errors

Status	Code	Description
401	authentication_required	No API key provided
401	invalid_api_key	Invalid API key
403	insufficient_scope	API key lacks store:write scope
404	resource_not_found	Store product or variation does not exist
422	validation_error	Invalid request body

Example Request

curl -X PUT "https://app.equipdash.com/api/v1/store-products/1/variations/1" \
  -H "Authorization: Bearer eqd_live_abc123xyz789..." \
  -H "Content-Type: application/json" \
  -d '{
    "sku": "WIDGET-MD-B",
    "price_override": 18.99,
    "stock_quantity": 30,
    "option_values": [
      {
        "option_id": 1,
        "value": "Medium"
      },
      {
        "option_id": 2,
        "value": "Blue"
      }
    ]
  }'