Skip to content

List a group's categories

GET
/content/management/v1/taxonomy/groups/{id}/categories
curl --request GET \
--url https://api.ebitex.io/content/management/v1/taxonomy/groups/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/categories \
--header 'Authorization: Bearer <token>'

Every category in the group, as a flat list ordered by key. Rebuild the tree from parentCategoryId, which is null for a top-level category.

value is the display label, as { "default": …, "locales": { … } }. isSelectable says whether the category can be used to classify content or chosen in a category field; a non-selectable one is a heading for its children. Send rowVersion back when updating the category to detect a concurrent change.

When the group has organization custom fields, a category with values for them also carries platformMetadata, an object keyed by field key. It is separate from metadata (this environment’s own values), the same in every environment, and left out when the category has none. This API reads it but does not change it.

Key: a management key with content.management.read.

id
required
string format: uuid

An array of { id, categoryGroupId, parentCategoryId, key, value, isSelectable, metadata, sourceRegistrationId, rowVersion }, plus platformMetadata on a category that has organization custom-field values.

missing_api_key or invalid_api_key: no key was sent, or it is unknown, revoked or expired.

payment_required: the organization’s subscription needs attention.

scope_denied: the key lacks this route’s scope. tier_required: the Content Management API needs the Pro plan or above. ip_denied: the caller’s address is outside the key’s allowed ranges. app_not_available: Content is not enabled for the organization.

No group has this id in the key’s environment.

Rate limit or quota exceeded; Retry-After says how long to wait. too_many_failed_authentications: too many bad keys from this address.