Delete a category

Removes the label from the vocabulary. Products keep the label they carried, so nothing is recategorised — the label simply stops being offered.

Errors

404 category_not_found — unknown ID, or one belonging to another tenant.
409 preset_category_immutable — a built-in category can’t be deleted.

DELETE/api/v1/categories/{id}

Authorization

AuthorizationBearer token (bloomcount_...) · headerrequired

Path parameters

idstringrequired

Responses

200Deleted

deletedbooleanrequired

401Missing or invalid API key, or revoked / expired.

errorstringrequired

403Authenticated, but the key lacks the required scope or the tenant has no API access.

errorstringrequired

404The requested resource doesn't exist or belongs to a different tenant.

errorstringrequired

409The request is well formed, but it conflicts with the current state: a name already taken, a row the app protects (the hidden Default supplier, a preset colour or category), or a staff member who has an account.

errorstringrequired

429Per-minute rate limit (60/min) or per-month cap exceeded.

errorstringrequired

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (bloomcount_...)Remember on this deviceInclude my values in samples

Parameters

idpath*

Request

curl -X DELETE "https://app.bloomcount.com/api/v1/categories/cat_n3q8w5y0m2k7r4t9v1x6z3b8" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://app.bloomcount.com/api/v1/categories/cat_n3q8w5y0m2k7r4t9v1x6z3b8", {
  method: "DELETE",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.delete(
    "https://app.bloomcount.com/api/v1/categories/cat_n3q8w5y0m2k7r4t9v1x6z3b8",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "deleted": true
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}