Delete Product Category
Delete a product category.
Endpoint
DELETE /v1/product-categories/{id}
Authentication
Requires an API key with the products:write scope.
Parameters
| Parameter | Type | Location | Description |
|---|---|---|---|
id | integer | path | The category ID |
Response
Success (204 No Content)
Returns no content on successful deletion.
Errors
| Status | Code | Description |
|---|---|---|
| 401 | authentication_required | No API key provided |
| 401 | invalid_api_key | Invalid API key |
| 403 | insufficient_scope | API key lacks products:write scope |
| 404 | resource_not_found | Category does not exist |
| 409 | conflict | Category cannot be deleted (has products or child categories) |
Example Request
curl -X DELETE "https://app.equipdash.com/api/v1/product-categories/3" \
-H "Authorization: Bearer eqd_live_abc123xyz789..."
Important Notes
- A category with products assigned to it may not be deletable
- A category with child categories may need to have children removed first
- This action cannot be undone