Delete a category - BrandWallet

DELETE $BASE_URL/v1/categories/{id}

Soft-deletes the category: the record is not destroyed, its status becomes -99, and it permanently drops out of list and get results.

Auth: Authorization: Bearer <accessToken> — an organization-scoped token from Authentication. Deleting a category that belongs to another organization returns auth_error (400).

Path parameters

Parameter	Type	Description
`id`	string	Category id (UUID).

Example

curl --request DELETE \
  --url "$BASE_URL/v1/categories/79a83256-2925-44b4-9bdc-a401caccf969" \
  --header 'Authorization: Bearer <accessToken>'

Response

Returns 200 with the deleted document.

{
  "id": "79a83256-2925-44b4-9bdc-a401caccf969",
  "name": { "TR": "Espresso Bazlı", "EN": "Espresso Based" },
  "organization": "07f84834-1184-4eb6-82f5-7eda13231fc3",
  "status": -99,
  "opaqueId": "espresso-based",
  "parent": "1e1cc0fb-55a1-4679-80df-6dccb936273f",
  "createdAt": "2026-09-18T09:23:28.303Z",
  "updatedAt": "2026-09-18T09:24:10.118Z"
}

Notes:

Child categories are not deleted or moved automatically — deleting a parent does not change the children’s parent reference; cleaning up the hierarchy is the caller’s responsibility. References in products’ categories lists are also left as they are.
A deleted category returns entity_not_found (400) on get and is invisible to every list filter; there is no undelete endpoint.
An unknown id returns entity_not_found (400).

Last modified on September 29, 2026