Get Root Category
Returns the root of the category tree: the category with intid 1 that every category path is anchored to. Its parentid is null. Walk the tree from here with Get Children Categories, or jump straight to the categories that hold assets with List Leaf Categories.
List Leaf Categories
Lists the leaf categories (is_leaf: true) across the whole tree, newest first. Leaves are the categories that hold tokenized assets, so this is the list a tokenization flow picks a category from, without walking the branches to get there. Optionally narrowed by a name search.
Get Category
Returns one category. A deleted category is not found.
Create Category
Adds a category under a parent. The new category gets the next sequential intid, and its path is the parent's path with that intid appended (1.4 → 1.4.117).
Update Category
Writes the full editable state of a category. This is a replace, not a patch: every editable field is written as sent.
Delete Category
Soft-deletes a category: it disappears from every read. Only a childless, non-root category can be deleted.
Get Children Categories
Lists the direct children of a category, newest first. Use it to walk the tree one level at a time from the root. A category id that matches nothing answers an empty page, not an error.