Skip to main content

Delete Variation

Delete a variation from a product.

Endpointโ€‹

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

Authenticationโ€‹

Requires an API key with the products:write scope.

Parametersโ€‹

ParameterTypeLocationDescription
idintegerpathThe product ID
variationIdintegerpathThe variation ID

Responseโ€‹

Success (204 No Content)โ€‹

Returns no content on successful deletion.

Example Requestโ€‹

curl -X DELETE "https://app.equipdash.com/api/v1/products/1/variations/3" \
-H "Authorization: Bearer YOUR_API_KEY"

Errorsโ€‹

StatusCodeDescription
401authentication_requiredNo API key provided
403insufficient_scopeAPI key lacks products:write scope
404resource_not_foundProduct or variation not found
409conflictVariation is used in existing bookings

Error Response Exampleโ€‹

If the variation is used in bookings:

{
"error": {
"code": "conflict",
"message": "This variation is used in existing bookings and cannot be deleted."
},
"meta": {
"request_id": "req_abc123"
}
}

Important Notesโ€‹

  • Variations with existing bookings cannot be deleted
  • Deleting a variation also removes its inventory items
  • Consider disabling the product instead if you need to preserve history