Taxonomy tree structure — categories, subcategories, and leaf nodes. Nodes form a hierarchical tree identified by slug paths.
Create a new node in the taxonomy tree
Creates a node under the specified parent. The slug must be unique among siblings. Provide either parentId or parentSlugPath to identify the parent node. Omit both to create a root-level node. Requires authentication.
Create a new node in the taxonomy tree › Request Body
slugURL-safe identifier, must be unique among siblings
titleHuman-readable display title
nodeKindWhether this node is a category folder or entity leaf
parentSlugPathSlug path of the parent node (alternative to parentId)
parentIdUUID of the parent node (alternative to parentSlugPath)
Optional structured content
statusInitial publication status
sortOrderOptional sort order among siblings
Create a new node in the taxonomy tree › Responses
Node created successfully
statusMachine-readable status code
messageHuman-readable status message
traceIdUnique request trace ID for debugging and log correlation
A node in the taxonomy tree. Nodes form a hierarchical structure of categories and subcategories. Leaf nodes of kind "entity" hold content entries.
Get a node by its unique identifier
Retrieves a single node by ID, including its full metadata, templates, and position in the tree. Requires authentication.
path Parameters
idUnique identifier of the node
Get a node by its unique identifier › Responses
Node retrieved successfully
statusMachine-readable status code
messageHuman-readable status message
traceIdUnique request trace ID for debugging and log correlation
A node in the taxonomy tree. Nodes form a hierarchical structure of categories and subcategories. Leaf nodes of kind "entity" hold content entries.
Archive a node
Marks a node as archived. Archiving is blocked if the node has child nodes (childCount > 0) to prevent orphaning. Requires authentication.
path Parameters
idUnique identifier of the node to archive
Archive a node › Responses
Node archived successfully (no content)
Update a node's layout templates
Replaces the layout templates for a node. Templates define the structure that child entities inherit for their content layout. Each template specifies a topic key, validation rule, display order, and optional collection items. Requires authentication.
path Parameters
idUnique identifier of the node
Update a node's layout templates › Request Body
nodeIdNode ID (must match the URL path parameter)
Array of template definitions to set on the node
Update a node's layout templates › Responses
Templates updated successfully
statusMachine-readable status code
messageHuman-readable status message
traceIdUnique request trace ID for debugging and log correlation
A node in the taxonomy tree. Nodes form a hierarchical structure of categories and subcategories. Leaf nodes of kind "entity" hold content entries.
List ancestor nodes for a slug path
Returns all ancestor nodes from root to the node identified by the slug path, ordered from root to leaf. Used for breadcrumb navigation. The slugPath parameter captures multiple segments. Requires authentication.
path Parameters
slugPathFull slug path. Captures multiple segments (e.g., "dnd/classes/bard").
List ancestor nodes for a slug path › Responses
Ancestors retrieved successfully
statusMachine-readable status code
messageHuman-readable status message
traceIdUnique request trace ID for debugging and log correlation
List direct children of a node
Returns a paginated list of direct child nodes under the node identified by the slug path. The slugPath captures multiple segments. Pass "ROOT" to list root-level nodes. Requires authentication.
path Parameters
slugPathFull slug path of the parent node. Captures multiple segments. Use "ROOT" for top-level nodes.
query Parameters
limitMaximum number of children to return
List direct children of a node › Responses
Children retrieved successfully
statusMachine-readable status code
messageHuman-readable status message
traceIdUnique request trace ID for debugging and log correlation
Paginated list of nodes.
List all descendants of a node
Returns a paginated list of all descendant nodes in the subtree rooted at the node identified by the slug path. The slugPath captures multiple segments. Requires authentication.
path Parameters
slugPathFull slug path of the root node. Captures multiple segments (e.g., "dnd/classes").
query Parameters
limitMaximum number of descendants to return
List all descendants of a node › Responses
Descendants retrieved successfully
statusMachine-readable status code
messageHuman-readable status message
traceIdUnique request trace ID for debugging and log correlation
Paginated list of nodes.
Get a node by its slug path
Resolves a node using its full hierarchical slug path. The slugPath parameter captures multiple segments (e.g., "dnd/classes/bard"). Requires authentication.
path Parameters
slugPathFull slug path of the node. Captures multiple segments (e.g., "dnd/classes/bard").
Get a node by its slug path › Responses
Node retrieved successfully
statusMachine-readable status code
messageHuman-readable status message
traceIdUnique request trace ID for debugging and log correlation
A node in the taxonomy tree. Nodes form a hierarchical structure of categories and subcategories. Leaf nodes of kind "entity" hold content entries.