List Folders
hudu_list_foldersList Hudu article folders, filterable by company or name. Pagination and field selection let you control exactly which folder data is returned.
Instructions
List folders in Hudu. A folder groups knowledge-base articles. Folders nest through parent_folder_id, and a folder carrying a company_id belongs to that company rather than to the global knowledge base.
These are article folders. Passwords are organised by a separate password_folders resource with its own tools; do not use these ids there.
The response is flat, not a tree — reconstruct the hierarchy yourself by following each folder's parent_folder_id, which is null at the top level.
On in_company, the API documents exactly one sentence: "When true, only returns company-specific KB articles." It says nothing about what false does, nor how it interacts with company_id. Read it as "restrict to company-scoped folders and exclude global ones", and check the returned company_id values rather than trusting that reading.
Returns an object with items plus pagination facts. Note that the Hudu API returns no total count for any collection, so page_was_full is the only honest signal that more records exist — read pagination_note before concluding a list is complete.
Operation class: Read.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Match against the folder name. | |
| page | No | 1-based page number. Hudu has no cursor or offset — only pages. | |
| fields | No | Return only these top-level fields on each record. Use it to keep large lists small — e.g. ["id","name","company_id"]. Unknown field names are ignored. | |
| page_size | No | Records per page (1-100, default 25). Hudu publishes no maximum, so this client clamps at 100; larger values are rejected here rather than silently altered by the server. | |
| company_id | No | Return only folders belonging to this company, by numeric Hudu company id. | |
| in_company | No | Documented only as "when true, only returns company-specific KB articles" — in practice, restricts the result to folders that belong to a company and excludes global ones. Behaviour when false is undocumented; omit it rather than sending false if you want everything. | |
| response_format | No | Output shape. 'json' (default) is compact and machine-readable; 'markdown' is easier for a person to read but larger. | json |