Document folders let you organize knowledge base documents into logical groups. Each folder has a name, optional color, icon, and a position for display ordering.
Standard users can only manage their own folders. Admin users can manage folders for any user by passing adminMode: true and a userId.
List all folders
Retrieves all folders for the authenticated user with full folder fields including user_id and updated_at.
string
required
Must be "document-folders"
string
required
Must be "all"
object
Show properties
boolean
default:"false"
Admin only. Enables cross-user access.
string
Admin only. Target user whose folders to retrieve.
Permanently deletes a folder. Documents in the folder are not deleted; they become uncategorized.
When a folder is deleted, any documents inside it are unlinked, not deleted. Their folder_id is set to null, making them appear as uncategorized in the knowledge base. You do not need to manually move documents before deleting a folder.