POST /v1/knowledge/folders
Create a folder in the knowledge base, optionally nested under another folder.
POST
Crear una carpeta en la base de conocimientos.
Creates an empty folder in the knowledge base. Folders are containers: they group documents and other folders, but have no content of their own. To create documents use
POST /v1/knowledge/documents.
Endpoint
Required scope
knowledge:write
Headers
Body
Example request
Response
201 Created
400 / 401 / 403 / 404 / 429
400 BAD_REQUEST:titleempty or longer than 200,parent_idwith invalid format, orparent_idpointing to a document (not a folder).403 FORBIDDENwithcode: INSUFFICIENT_SCOPE: the PAT doesn’t haveknowledge:write.404 NOT_FOUND: theparent_iddoesn’t exist or doesn’t belong to your company.
Authorizations
Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.
Body
application/json
Response
201 - application/json
Available options:
folder, document Estado de la vigencia efectiva: la del nodo cruzada con la de sus carpetas. Los agentes solo leen nodos always o active.
Available options:
always, active, scheduled, expired La vigencia efectiva viene de una carpeta ancestro.
Inicio de la vigencia propia del nodo (UTC ISO 8601).
Fin de la vigencia propia del nodo (UTC ISO 8601).
Carpeta que define el límite heredado.
Crear una carpeta en la base de conocimientos.