> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brand-wallet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete a category

> Soft-delete a BrandWallet product category. The record is kept but permanently drops out of list and get results.

```http theme={null}
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](/api/authentication). Deleting a category that belongs to another organization returns `auth_error` (400).

### Path parameters

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

### Example

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

### Response

Returns **200** with the deleted document.

```json theme={null}
{
  "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).