Knowledge Base
Create folder
Create a folder in a knowledge base. Omit folderId to create at the KB root; pass folderId as a query parameter to create a nested subfolder inside an existing parent folder.
Required permission: WRITER or higher
Folder features:
- Organize records hierarchically
- Support nested subfolders (unlimited depth)
- Inherit parent KB permissions
Naming rules:
- 1–255 characters
- XSS protection applied
- Spaces and special characters allowed
- Duplicate names rejected within the same parent (409)
Response: Returns id and name for the created folder.
post/knowledgeBase/{kbId}/folder
Path parameters
kbIdstring required
Knowledge base ID
Query parameters
folderIdstring
Parent folder ID. Omit to create at the knowledge base root.
Request body
Example request
{
"folderName": "Project Documents"
}Response
Folder created successfully