DoubleX AgentesDocs

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.

SintaxisQué 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/subEtiqueta. También vale tags: en las propiedades.
--- arribaPropiedades (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.

JSON
{
  "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"]
}
CampoDescripción
nameEl título sin .md. Es el nombre que usan los enlaces.
pathcarpeta/nombre, la clave completa de los enlaces.
attachmenttrue para archivos enviados (PDF, Word, Excel, CSV, JSON, texto).
linksIDs de las notas a las que apunta esta.
unresolvedEnlaces a notas que todavía no existen.
sizeTamaño del texto en caracteres.
usedByAgentes que consultan la nota.

POST/api/knowledge#

Crea una nota a partir de texto o Markdown.

CampoTipoDescripción
titlestring, 1 a 160Obligatorio. / \ [ ] # ^ | se quitan del nombre. Si ya existe una nota con ese nombre en la carpeta, se le agrega un número (Reunión 1).
contentstring, hasta 2 millones de caracteresTexto de la nota. Por defecto: vacío.
folderstringCarpeta, como Clientes/Reuniones. Por defecto: la raíz.
scope, teamIdpersonal (por defecto), team u organization. organization requiere ser administrador.
Terminal
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:

CampoDescripción
propertiesLas propiedades al inicio de la nota.
headingsLos títulos (level, text, line).
outgoingEnlaces salientes: target como está escrito y el id de la nota (null si todavía no existe).
backlinksNotas que enlazan a esta, con las líneas del enlace en snippets.
unlinkedNotas que citan el nombre (o un alias) sin enlace.

PATCH/api/knowledge/{id}#

Edita, renombra o mueve una nota. Requiere permiso de edición.

CampoDescripción
contentTexto nuevo.
titleNombre nuevo.
folderCarpeta nueva ("" es la raíz).
updateLinksPor defecto true: al renombrar o mover, los enlaces en las otras notas que puedes editar se actualizan.
Terminal
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ó.

RutaQué hace
GET /api/knowledge/foldersLista las carpetas: { "folders": [...] }.
POST /api/knowledge/foldersCrea una carpeta vacía: { "path": "Clientes/Reuniones" }.
PATCH /api/knowledge/foldersRenombra 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=ArchivoElimina una carpeta vacía. Con notas dentro, la respuesta es 409.
POST /api/knowledge/deleteElimina 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:

CampoDescripción
fileObligatorio. PDF, Word (.docx), Excel (.xlsx), CSV, JSON, Markdown o texto. Hasta 20 MB.
titleNombre. Por defecto: el nombre del archivo. Un nombre repetido en la carpeta recibe un número.
folderCarpeta de destino.
replaceID de una nota existente: reemplaza su texto por el del archivo y mantiene el ID, el nombre, la carpeta y los agentes vinculados.
scopepersonal (por defecto), team u organization. organization requiere ser administrador.
teamIdEl 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.

StatusCuándo
413Archivo de más de 20 MB.
422Formato no compatible, archivo vacío o dañado, PDF solo con imágenes, archivo protegido con contraseña.
403No puedes crear en ese alcance.
404La nota de replace no existe o no puedes editarla.

Busca en las notas que puedes ver.

QueryDescripción
qObligatorio. De 2 a 300 caracteres.
limitCuántos fragmentos devolver, de 1 a 50. Por defecto 8.

La búsqueda acepta los operadores de Obsidian:

OperadorEjemploFiltra
tag:tag:#clienteNotas con la etiqueta (o una subetiqueta).
path:path:VentasNotas cuya ruta contiene el texto.
file:file:reuniónNotas cuyo nombre contiene el texto.
"...""plazo de reembolso"La frase exacta.
--borradorExcluye las notas con la palabra.
curl "https://doublex.ai/api/knowledge/search?q=plazo%20path%3AVentas&limit=3" -H "Authorization: Bearer $DOUBLEX_API_KEY"
JSON
{
  "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 }.