Referencia de la API › Recursos
Brain
Notas en Markdown conectadas con [[enlaces]], en carpetas, al estilo Obsidian. Crea, edita, mueve, busca y sube archivos.
El Brain funciona como una bóveda de Obsidian: cada documento es una nota con una ruta (carpeta/nombre), y las notas se enlazan con [[Nombre de la nota]]. Los archivos enviados (PDF, Word, Excel) se convierten en notas con el texto extraído.
| Sintaxis | Qué hace |
|---|---|
[[Nota]], [[Carpeta/Nota]] | Enlace a otra nota. Sin carpeta, basta el nombre (la nota de la misma carpeta tiene preferencia). |
[[Nota#Título]], [[Nota|texto]] | Enlace a un título de la nota, o con otro texto. |
![[Nota]], ![[Nota#Título]] | Muestra el contenido de la otra nota (o de la sección) dentro de esta. |
#etiqueta, #etiqueta/sub | Etiqueta. También vale tags: en las propiedades. |
--- arriba | Propiedades (front matter YAML), como tags, aliases y campos libres. |
GET/api/knowledge#
Lista las notas que puedes ver y las carpetas, sin el texto completo.
{
"docs": [
{
"id": "kno_2c4e6a8b0d1f",
"title": "Política de reembolso",
"name": "Política de reembolso",
"folder": "Ventas",
"path": "Ventas/Política de reembolso",
"attachment": false,
"size": 18420,
"preview": "Los clientes pueden pedir reembolso en hasta 30 días…",
"tags": ["ventas"],
"aliases": ["Reembolso"],
"links": ["kno_7e9f1a3b5c2d"],
"unresolved": ["Plan de expansión"],
"scope": "organization",
"ownerId": "usr_1a2b3c4d5e6f",
"canEdit": true,
"usedBy": [{ "id": "agt_8f3a2b1c9d0e", "name": "Soporte" }],
"createdAt": "2026-10-22T11:00:00.000Z",
"updatedAt": "2026-10-29T15:20:00.000Z"
}
],
"folders": ["Clientes", "Producto/Guías", "Ventas"]
}| Campo | Descripción |
|---|---|
name | El título sin .md. Es el nombre que usan los enlaces. |
path | carpeta/nombre, la clave completa de los enlaces. |
attachment | true para archivos enviados (PDF, Word, Excel, CSV, JSON, texto). |
links | IDs de las notas a las que apunta esta. |
unresolved | Enlaces a notas que todavía no existen. |
size | Tamaño del texto en caracteres. |
usedBy | Agentes que consultan la nota. |
POST/api/knowledge#
Crea una nota a partir de texto o Markdown.
| Campo | Tipo | Descripción |
|---|---|---|
title | string, 1 a 160 | Obligatorio. / \ [ ] # ^ | se quitan del nombre. Si ya existe una nota con ese nombre en la carpeta, se le agrega un número (Reunión 1). |
content | string, hasta 2 millones de caracteres | Texto de la nota. Por defecto: vacío. |
folder | string | Carpeta, como Clientes/Reuniones. Por defecto: la raíz. |
scope, teamId | personal (por defecto), team u organization. organization requiere ser administrador. |
curl -X POST https://doublex.ai/api/knowledge \
-H "Authorization: Bearer $DOUBLEX_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title": "Lista de precios 2026", "folder": "Ventas", "content": "Plan Básico: US$ 99/mes. Ver [[Política de reembolso]]."}'Respuesta 201: { "doc": { "id": "...", "title": "Lista de precios 2026", "folder": "Ventas" } }.
GET/api/knowledge/{id}#
Devuelve la nota con el texto completo en doc.content y lo que muestra el panel lateral:
| Campo | Descripción |
|---|---|
properties | Las propiedades al inicio de la nota. |
headings | Los títulos (level, text, line). |
outgoing | Enlaces salientes: target como está escrito y el id de la nota (null si todavía no existe). |
backlinks | Notas que enlazan a esta, con las líneas del enlace en snippets. |
unlinked | Notas que citan el nombre (o un alias) sin enlace. |
PATCH/api/knowledge/{id}#
Edita, renombra o mueve una nota. Requiere permiso de edición.
| Campo | Descripción |
|---|---|
content | Texto nuevo. |
title | Nombre nuevo. |
folder | Carpeta nueva ("" es la raíz). |
updateLinks | Por defecto true: al renombrar o mover, los enlaces en las otras notas que puedes editar se actualizan. |
curl -X PATCH https://doublex.ai/api/knowledge/kno_2c4e6a8b0d1f \
-H "Authorization: Bearer $DOUBLEX_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title": "Política de reembolso y cancelación"}'Respuesta: { "doc": { ... }, "updatedLinks": 4, "updatedNotes": 3 }. Si ya existe una nota en la ruta nueva, la respuesta es 409.
Carpetas#
Las carpetas vienen de las notas. Una carpeta vacía se guarda solo para quien la creó.
| Ruta | Qué hace |
|---|---|
GET /api/knowledge/folders | Lista las carpetas: { "folders": [...] }. |
POST /api/knowledge/folders | Crea una carpeta vacía: { "path": "Clientes/Reuniones" }. |
PATCH /api/knowledge/folders | Renombra o mueve una carpeta con sus subcarpetas: { "from": "Ventas", "to": "Comercial/Ventas" }. Los enlaces se actualizan. Las notas que no puedes editar se quedan donde están y cuentan en skipped. |
DELETE /api/knowledge/folders?path=Archivo | Elimina una carpeta vacía. Con notas dentro, la respuesta es 409. |
POST /api/knowledge/delete | Elimina de una vez notas y carpetas enteras (con subcarpetas y las notas de dentro): { "ids": ["kno_..."], "folders": ["Archivo"], "expected": 14 }. No hay papelera: es definitivo. Solo se eliminan las notas que puedes editar; las demás se quedan donde están y cuentan en kept. Las notas eliminadas se desvinculan de los agentes que las usaban. Con expected (cuántas notas confirmaste), la respuesta es 409 si el Brain cambió mientras tanto. Respuesta: { "deleted": 14, "kept": 0, "detachedAgents": 1, "folders": [...] }. |
POST/api/knowledge/upload#
Sube un archivo. El texto se extrae en el servidor. Cuerpo en multipart/form-data:
| Campo | Descripción |
|---|---|
file | Obligatorio. PDF, Word (.docx), Excel (.xlsx), CSV, JSON, Markdown o texto. Hasta 20 MB. |
title | Nombre. Por defecto: el nombre del archivo. Un nombre repetido en la carpeta recibe un número. |
folder | Carpeta de destino. |
replace | ID de una nota existente: reemplaza su texto por el del archivo y mantiene el ID, el nombre, la carpeta y los agentes vinculados. |
scope | personal (por defecto), team u organization. organization requiere ser administrador. |
teamId | El equipo, cuando scope es team. Debes ser miembro. |
curl -X POST https://doublex.ai/api/knowledge/upload \
-H "Authorization: Bearer $DOUBLEX_API_KEY" \
-F "[email protected]" \
-F "folder=Ventas" \
-F "scope=organization"Respuesta 201: { "doc": { "id": "kno_2c4e6a8b0d1f", "title": "politica-de-reembolso.pdf" }, "chars": 18420 }. Con replace, la respuesta es 200 e incluye "replaced": true.
| Status | Cuándo |
|---|---|
413 | Archivo de más de 20 MB. |
422 | Formato no compatible, archivo vacío o dañado, PDF solo con imágenes, archivo protegido con contraseña. |
403 | No puedes crear en ese alcance. |
404 | La nota de replace no existe o no puedes editarla. |
GET/api/knowledge/search#
Busca en las notas que puedes ver.
| Query | Descripción |
|---|---|
q | Obligatorio. De 2 a 300 caracteres. |
limit | Cuántos fragmentos devolver, de 1 a 50. Por defecto 8. |
La búsqueda acepta los operadores de Obsidian:
| Operador | Ejemplo | Filtra |
|---|---|---|
tag: | tag:#cliente | Notas con la etiqueta (o una subetiqueta). |
path: | path:Ventas | Notas cuya ruta contiene el texto. |
file: | file:reunión | Notas cuyo nombre contiene el texto. |
"..." | "plazo de reembolso" | La frase exacta. |
- | -borrador | Excluye las notas con la palabra. |
curl "https://doublex.ai/api/knowledge/search?q=plazo%20path%3AVentas&limit=3" -H "Authorization: Bearer $DOUBLEX_API_KEY"{
"results": [
{ "docId": "kno_2c4e6a8b0d1f", "title": "Política de reembolso", "score": 1, "text": "…el cliente puede pedir reembolso en hasta 30 días…" }
],
"notes": [
{ "id": "kno_2c4e6a8b0d1f", "name": "Política de reembolso", "path": "Ventas/Política de reembolso", "score": 2, "matches": [{ "line": 2, "text": "Los clientes pueden pedir reembolso en hasta 30 días." }] }
]
}results son fragmentos puntuados, la misma búsqueda que usan los agentes. notes agrupa por nota, con las líneas encontradas. No distingue acentos ni mayúsculas; las palabras de hasta dos letras se ignoran en results.
DELETE/api/knowledge/{id}#
Elimina la nota y la quita de los agentes que la usaban. Requiere permiso de edición; sin él, la respuesta es 404.
Respuesta: { "ok": true }.