Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/MarcoAbundio/furniture_api_rest/llms.txt

Use this file to discover all available pages before exploring further.

​
Delete Category

Permanently delete a category from the system. Note that deleting a category with subcategories will also remove all its subcategories due to cascade deletion.

​
Endpoint

DELETE /api/v1/categories/{id}

​
Path Parameters

​
id
integer
required
The unique identifier of the category to delete

​
Response

Returns no content on successful deletion.

​
Status Codes

  • 204 - Category successfully deleted (no content returned)
  • 404 - Category not found

​
Important Notes

Deleting a parent category will cascade delete all its subcategories. This operation is irreversible.
Consider deactivating a category (using the update endpoint with isActive: false) instead of deleting it if you want to preserve historical data.

​
Examples

​
Delete a Category

curl -X DELETE "https://api.example.com/api/v1/categories/10" \
  -H "Content-Type: application/json"

​
Success Response

HTTP/1.1 204 No Content

​
Error Response (404)

{
  "error": "Category not found",
  "status": 404
}

​
Alternative: Deactivate Instead of Delete

If you want to hide a category without permanently deleting it, consider using the update endpoint: 
curl -X PUT "https://api.example.com/api/v1/categories/10" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sofas",
    "description": "Comfortable seating furniture",
    "parentId": 1,
    "isActive": false
  }'
This preserves the category data while marking it as inactive.

Build docs developers (and LLMs) love

Get started for freeTalk to us