Actions11
- Documents Actions
- Category Actions
- Images Actions
- Relationship Types Actions
Category → Get Many
AI-generatedSummary
Retrieves multiple categories from the AgentBrains Knowledge Base, optionally filtering by type, parent, policy, or search term.
Inputs
- returnAll — Whether to return all results or only up to a given limit. Default is false.
- limit — Max number of results to return when returnAll is false. Minimum value is 1. Default is 50.
- additionalFields — A collection of optional filters for the request. Options include categoryAlias (filters by type ID), extended (populates policy, parent, and children fields), fields (comma-separated list of fields to include), parent (filters by parent ID, use 'null' for top-level), policy (filters by policy ID), and search (performs a case-insensitive text search).
Output shape
a list of items, each containing category data
If 'extended' is true in additionalFields, the returned items include populated policy, parent, and children fields.
Examples
Example 1: List the first 100 categories
Set returnAll to false, limit to 100.
Example 2: Retrieve top-level categories only
Set additionalFields.parent to 'null'.
Example 3: Get all categories of a specific type with extended details
Set returnAll to true, additionalFields.categoryAlias to the desired type ID, and additionalFields.extended to true.