Folder Management
Folder Management provides APIs to organize and maintain your folder structure within Knowledge Vault. You can create folders, retrieve all folders, view items inside a folder, update folder details, move folders or items, and delete folders.
Create Folder
https://ai.contentstack.com/brand-kits/v1/knowledge-vault/foldersThe Create Folder request lets you create a new folder within a specified parent directory in your knowledge vault.
To configure the permissions for your app via OAuth, include the brand-kits:manage scope.
Example:
{
"name": "AI for Advanced Users",
"path": "/dir0000000000000"
}The name and path are required strings where name specifies the new folder’s name and path provides the parent folder UID where the new folder will be created.
NoteRoot folder UID is dir0000000000000.
{
"name": "AI for Advanced Users",
"path": "/dir0000000000000"
}{
"message": "Folder created successfully",
"folder_uid": "dir************"
}Get All Folders
https://ai.contentstack.com/brand-kits/v1/knowledge-vault/folders?limit={limit}&sort={sort_field}&skip={skip}&order={asc|desc}The Get All Folders request retrieves a paginated list of all folders within the Knowledge Vault for a specified brand kit. You can apply filters such as sorting, pagination, and the inclusion of user metadata in the response.
To configure the permissions for your app via OAuth, include the brand-kits:read scope.
{
"documents": [
{
"folder_uid": "dir0000000000000",
"organization_uid": "blt*************",
"brand_kit_uid": "cs************",
"created_at": "2025-11-30 09:31:29.864609",
"created_by": "blt*************",
"updated_at": "2025-11-30 09:31:29.864619",
"updated_by": "blt*************",
"deleted_at": false,
"type": "folder",
"name": "Root",
"path": "/"
},
{
"folder_uid": "dir************",
"organization_uid": "blt57de41ea4319272c",
"brand_kit_uid": "cs************",
"created_at": "2025-11-30 09:32:18.992813",
"created_by": "blt*************",
"updated_at": "2025-11-30 09:33:26.411742",
"updated_by": "blt*************",
"deleted_at": false,
"type": "folder",
"name": "AI for Beginners",
"path": "/dir0000000000000"
},
{
"folder_uid": "dir************",
"organization_uid": "blt*************",
"brand_kit_uid": "cs************",
"created_at": "2025-11-30 09:41:05.895270",
"created_by": "blt*************",
"updated_at": "2025-11-30 09:41:05.895281",
"updated_by": "blt*************",
"deleted_at": false,
"type": "folder",
"name": "AI for Advanced Users",
"path": "/dir0000000000000"
}
]
}Get Items in Folder
https://ai.contentstack.com/brand-kits/v1/knowledge-vault/folders/{folder_uid}?folder_depth={number}&limit={limit}&skip={index}&sort={string}&order={string}&date_range={dateRange}&filter_users={string}&filter_field={string}&include_users={boolean}&typeahead={string}The Get Items in Folder request retrieves all items contained within a specific folder in the Knowledge Vault of a brand kit.
To configure the permissions for your app via OAuth, include the brand-kits:read scope.
{
"documents": [
{
"content_uid": "cs************",
"content": "AI Tools for Beginners\nArtificial intelligence has become part of everyday life, and a growing number of easy to use tools make it accessible to everyone, even complete beginners. These tools help with writing, image creation, data organization, and productivity without requiring any technical background.\n1. Writing Assistants: AI writing assistants such as ChatGPT and Grammarly help users brainstorm ideas, correct grammar, and improve writing style. They are great for students, professionals, and anyone who wants to produce content faster.\n2. Image Generation Tools: Beginner friendly image generators like Canva AI or Adobe Firefly allow users to create attractive visuals from simple prompts. These tools help with social media graphics, blog illustrations, and creative projects.\n3. AI Productivity Tools: Tools such as Notion AI, Otter.ai, or Google Gemini assist with summarizing notes, generating task lists, and automating repetitive work. They save time and help users stay organized.\n4. AI Video and Audio Tools: Platforms like Descript and CapCut use AI to simplify audio/video editing, enabling beginners to create professional looking content with minimal effort. \n\nAI tools are becoming more intuitive and accessible, empowering anyone to work smarter and explore creativity in new ways. As AI continues to evolve, these beginner friendly tools will make learning and productivity even easier.",
"deleted_at": false,
"organization_uid": "blt*************",
"brand_kit_uid": "cs************",
"created_at": "2025-11-30 09:33:00.345900",
"created_by": "blt*************",
"updated_at": "2025-11-30 09:33:00.345910",
"updated_by": "blt*************",
"_metadata": {
"tags": [],
"title": "AI Tools for Beginners: Writing, Image, and Productivity",
"file": {
"name": "AI_Tools_for_Beginners.pdf",
"size": 2669,
"type": "app/pdf"
},
"source": "UI"
},
"type": "entry",
"path": "/dir0000000000000/dir************"
}
],
"current_folder": {
"folder_uid": "dir************",
"organization_uid": "blt*************",
"brand_kit_uid": "cs************",
"created_at": "2025-11-30 09:32:18.992813",
"created_by": "blt*************",
"updated_at": "2025-11-30 09:33:26.411742",
"updated_by": "blt*************",
"deleted_at": false,
"type": "folder",
"name": "AI for Beginners",
"path": "/dir0000000000000"
}
}Update Folder
https://ai.contentstack.com/brand-kits/v1/knowledge-vault/folders/{folder_uid}The Update Folder request lets you rename an existing folder in the Knowledge Vault of a brand kit.
To configure the permissions for your application via OAuth, include the brand-kits:manage scope.
Example:
{
"name": "AI for Business Leaders"
}{
"name": "AI for Business Leaders"
}{
"message": "Folder name updated successfully"
}Move Items to Folder
https://ai.contentstack.com/brand-kits/v1/knowledge-vault/folders/{folder_uid}/move-itemsThe Move Items to Folder request lets you move multiple items into a specified folder within the Knowledge Vault of a brand kit.
To configure the permissions for your app via OAuth, include the brand-kits:manage scope.
Example:
{
"content_uids": [
"cs**************",
"cs**************"
]
}The content_uids holds the list of content item UIDs to move into another folder.
{
"content_uids": [
"cs**************",
"cs**************"
]
}{
"message": "Items moved successfully",
"updated_count": 2,
"elapsed_time": 0.033
}Delete Folder
https://ai.contentstack.com/brand-kits/v1/knowledge-vault/folders/{folder_uid}The Delete Folder request permanently deletes a specified folder from the Knowledge Vault in a brand kit.
To configure the permissions for your app via OAuth, include the brand-kits:manage scope.
{
"message": "Folder deleted successfully.",
}