Update Variation Option

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

Endpoint

PUT /v1/store-products/{id}/variation-options/{optionId}

Authentication

Requires an API key with the store:write scope.

Parameters

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

Request Body

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

Field	Type	Description
name	string	Option name (max 255 characters)
values	array	List of possible string values for this option

caution

Updating the values array replaces all existing values. If you remove a value that is used by an existing product variation, the variation will retain its current option value but the value will no longer appear in the option's list.

Response

Success (200 OK)

{
  "data": {
    "id": 1,
    "name": "Size",
    "values": ["XS", "Small", "Medium", "Large", "XL"]
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-02-15T12:00: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 option does not exist
422	validation_error	Invalid request body

Example Request

curl -X PUT "https://app.equipdash.com/api/v1/store-products/1/variation-options/1" \
  -H "Authorization: Bearer eqd_live_abc123xyz789..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Size",
    "values": ["XS", "Small", "Medium", "Large", "XL"]
  }'