Delete Store Category
Permanently delete a store category. If the category has child categories, they will be moved to the deleted category's parent (or become top-level if the deleted category had no parent).
Endpoint
DELETE /v1/store-categories/{id}
Authentication
Requires an API key with the store:write scope.
Parameters
| Parameter | Type | Location | Description |
|---|---|---|---|
id | integer | path | The store category ID |
Response
Success (204 No Content)
No response body.
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 category does not exist |
| 409 | conflict | Category has products assigned -- reassign products first |
caution
A category cannot be deleted if it has products assigned to it. Reassign or remove the products from the category before deleting it.
Child categories are automatically re-parented when a category is deleted -- they are moved to the deleted category's parent, or become top-level categories if the deleted category had no parent.
Example Request
curl -X DELETE "https://app.equipdash.com/api/v1/store-categories/6" \
-H "Authorization: Bearer eqd_live_abc123xyz789..."