Update Variation

Update an existing variation.

Endpoint

PATCH /v1/products/{id}/variations/{variationId}

Authentication

Requires an API key with the products:write scope.

Parameters

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

Request Body

All fields are optional. Only include fields you want to update.

Field	Type	Description
sku	string	New SKU
description	string	Short explainer shown under the variation name when customers choose an option (max 255 characters). Pass null to clear it.
image	string	New image URL
values	array	New property values (replaces all existing)

Response

Success (200 OK)

Returns the updated variation.

{
  "data": {
    "id": 3,
    "sku": "BIKE-L-RED-V2",
    "display_name": "BIKE-L-RED-V2",
    "description": "Riders 5'9\" and up",
    "image": null,
    "values": [
      {
        "property_id": 1,
        "property_name": "Size",
        "value": "Large"
      },
      {
        "property_id": 2,
        "property_name": "Color",
        "value": "Red"
      }
    ]
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-02-01T11:00:00+00:00"
  }
}

Example Request

curl -X PATCH "https://app.equipdash.com/api/v1/products/1/variations/3" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sku": "BIKE-L-RED-V2"
  }'

Errors

Status	Code	Description
401	authentication_required	No API key provided
403	insufficient_scope	API key lacks products:write scope
404	resource_not_found	Product or variation not found
422	validation_error	Invalid request data