Delete a category
Permanently remove an empty category.
Expect the refusal to be the normal answer. A category that still holds articles is refused with 422 and the number of articles; clearing it first — move them with update an article category_id, or delete them — is the main path, not an edge case. Retrying the call unchanged will not start working.
The refusal exists because deleting a full category would not fail: it would silently detach its contents, and an article with no category has lost where its language comes from. Categories nested under it and categories linked to it as translations block it the same way, each reported separately under error.details with its own count. Archived articles count too — archived is content you can publish again, not deleted content.
The response has no body, and there is nothing to restore from afterwards. Requires being an administrator of the account or a member of the portal.
Authorizations
The id_token from POST /auth/v1/signin, sent as Authorization: Bearer <id_token>. Not the access_token — that one does not carry the identity Cloud Chat authorizes on.
Headers
Your Cloud Chat instance ID — an integer, fixed for your company, told at onboarding. The API overview explains how instances work, how to find yours, and the errors a wrong or missing value produces.
1
Path Parameters
Your Cloud Chat account. It has to be an account your token grants membership on, and it has to live on the instance in the cloudchat-instance header — the two travel together. Account numbers are only unique within an instance, so the same number is a different company on another instance. Usually a mismatched pair fails closed with a 401, because your user does not exist on the other instance — but if your identity happens to exist on both, the call succeeds against the other company's data, silently. Read it and you are looking at the wrong help center; write it and you have stored into the wrong account. Send the two values that were given to you together, and never try a number to see what answers.
1
The portal's slug — the URL-safe handle you see in its public address (/hc/<slug>/...), not a numeric id. List portals returns every slug on the account. Note the asymmetry: portals are addressed by slug, articles by numeric id.
"acme-help"
The id returned when the category was created or listed. Numeric — never the category slug, and that is on purpose: updating a category can rewrite the slug, so a slug would be an address the endpoint itself can invalidate.
12
Response
The category is gone. No body is returned.