REST API
GET /external/categories
Workspace categories filtered to those with published content.
GET /external/categories?locale=pt
X-Api-Key: bk_live_xxxReturns only categories that have at least one published post in the requested locale. This prevents the consumer site from rendering "dead" category chips that link to empty pages.
| Query | Type | Default |
|---|---|---|
locale | string | workspace defaultLocale |
Pass locale=* to ignore the filter and return every category.
Response
{
"items": [
{ "id": "c_1", "slug": "visas", "name": "Visas" },
{ "id": "c_2", "slug": "guides", "name": "Guides" }
]
}SDK
const cats = await bf.categories.list({ locale: 'pt' })