Skip to main content
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: title empty or longer than 200, parent_id with invalid format, or parent_id pointing to a document (not a folder).
  • 403 FORBIDDEN with code: INSUFFICIENT_SCOPE: the PAT doesn’t have knowledge:write.
  • 404 NOT_FOUND: the parent_id doesn’t exist or doesn’t belong to your company.

Authorizations

Authorization
string
header
required

Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.

Body

application/json
title
string
required

Título de la carpeta.

Maximum string length: 200
Example:

"Soporte"

parent_id
string

ObjectId de la carpeta padre. Omitir para crear en la raíz.

Response

201 - application/json
id
string
required
title
string
required
node_type
enum<string>
required
Available options:
folder,
document
position
number
required
path_cache
string
required
parent_id
object | null
created_at
string
updated_at
string