Skip to main content

Delete Branding Theme

Remove a branding theme by id. A second call for the same id returns 404. The same id cannot be reused.

Products that pointed at it keep their copied colour tokens; their styles branding_theme_id is cleared. Deleting the last default is allowed — the store may have no default, and no other theme is promoted. See Default.

Request​

DELETE /branding-themes/{id}

Path Parameters​

ParameterTypeRequiredDescription
idstringYesBranding theme UUID.

Example Request​

curl -X DELETE "https://cart.easy.tools/api/v1/branding-themes/f670a72a-7a46-4853-9ebb-91ddf691358e" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Response​

Success Response (204)​

Empty body.

Error Responses​

Bad Request (400)​

{
  "message": "Invalid branding theme ID"
}

Not Found Error (404)​

{
  "message": "Branding theme with ID f670a72a-7a46-4853-9ebb-91ddf691358e not found"
}

Unauthorized Error (401)​

{
  "message": "Unauthenticated."
}

Forbidden Error (403)​

{
  "message": "You do not have API access to the requested store."
}