VEvectorize
Knowledge Base

Create a knowledge-base folder

Changed on

Create a folder, optionally nested under a parent folder.

post/v1/default/banks/{bank_id}/knowledge-base/folders

Request

Path parameters

bank_idstring required

Headers

authorizationstring nullable

Request body

namestring required
parent_idstring nullable

Response

Successful Response

idstring required
kind'folder' | 'page' required
namestring required
parent_idstring nullable
mental_model_idstring nullable

Backing mental model id (pages only).

managedboolean

Client-set flag: true = system-owned, false = hand-authored.

descriptionstring nullable

Page source query (the page's description).

tagsstring[]
timestampstring nullable

Last refresh (page) or last update (folder).

is_staleboolean nullable

Pages only, populated by the tree endpoint. True when a memory in this page's scope — its tags and fact types — has been written since the page last read the memories. That is the same check a scheduled refresh runs before spending an LLM call, so a flagged page is one a refresh would actually rewrite. Deletions are not observed: removing an in-scope memory leaves no write behind, so it does not raise this flag.

last_refresh_failed_atstring nullable

Pages only: when this page's most recent refresh failed, in ISO format, or null when the last one succeeded. While it is set the page does not rebuild itself on its trigger — see the same field on the mental model. An explicit refresh still runs.

childrenKnowledgeNode[] circular

Changes