DoubleX AgentesDocs

Referência da API › Recursos

Brain

Notas em Markdown ligadas por [[links]], em pastas, no estilo Obsidian. Crie, edite, mova, busque e suba arquivos.

O Brain funciona como um cofre do Obsidian: cada documento é uma nota com um caminho (pasta/nome), e as notas se ligam com [[Nome da nota]]. Arquivos enviados (PDF, Word, Excel) viram notas com o texto extraído.

SintaxeO que faz
[[Nota]], [[Pasta/Nota]]Link para outra nota. Sem pasta, vale o nome (a nota da mesma pasta tem preferência).
[[Nota#Título]], [[Nota|texto]]Link para um título da nota, ou com outro texto.
![[Nota]], ![[Nota#Título]]Mostra o conteúdo da outra nota (ou da seção) dentro desta.
#tag, #tag/subtagTag. Também vale tags: nas propriedades.
--- no topoPropriedades (front matter YAML), como tags, aliases e campos livres.

GET/api/knowledge#

Lista as notas que você pode ver e as pastas, sem o texto completo.

JSON
{
  "docs": [
    {
      "id": "kno_2c4e6a8b0d1f",
      "title": "Política de reembolso",
      "name": "Política de reembolso",
      "folder": "Comercial",
      "path": "Comercial/Política de reembolso",
      "attachment": false,
      "size": 18420,
      "preview": "Clientes podem pedir reembolso em até 30 dias…",
      "tags": ["comercial"],
      "aliases": ["Reembolso"],
      "links": ["kno_7e9f1a3b5c2d"],
      "unresolved": ["Plano de expansão"],
      "scope": "organization",
      "ownerId": "usr_1a2b3c4d5e6f",
      "canEdit": true,
      "usedBy": [{ "id": "agt_8f3a2b1c9d0e", "name": "Suporte" }],
      "createdAt": "2026-10-22T11:00:00.000Z",
      "updatedAt": "2026-10-29T15:20:00.000Z"
    }
  ],
  "folders": ["Clientes", "Comercial", "Produto/Guias"]
}
CampoDescrição
nameO título sem .md. É o nome usado nos links.
pathpasta/nome, a chave completa dos links.
attachmenttrue para arquivos enviados (PDF, Word, Excel, CSV, JSON, texto).
linksIDs das notas para onde esta aponta.
unresolvedLinks para notas que ainda não existem.
sizeTamanho do texto em caracteres.
usedByAgentes que consultam a nota.

POST/api/knowledge#

Cria uma nota a partir de texto ou Markdown.

CampoTipoDescrição
titlestring, 1 a 160Obrigatório. / \ [ ] # ^ | saem do nome. Se já existir uma nota com esse nome na pasta, ganha um número (Reunião 1).
contentstring, até 2 milhões de caracteresTexto da nota. Padrão: vazio.
folderstringPasta, como Clientes/Reuniões. Padrão: a raiz.
scope, teamIdpersonal (padrão), team ou organization. organization exige ser administrador.
Terminal
curl -X POST https://doublex.ai/api/knowledge \
  -H "Authorization: Bearer $DOUBLEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Tabela de preços 2026", "folder": "Comercial", "content": "Plano Básico: R$ 99/mês. Ver [[Política de reembolso]]."}'

Resposta 201: { "doc": { "id": "...", "title": "Tabela de preços 2026", "folder": "Comercial" } }.

GET/api/knowledge/{id}#

Devolve a nota com o texto completo em doc.content e o que o painel lateral mostra:

CampoDescrição
propertiesAs propriedades do topo da nota.
headingsOs títulos (level, text, line).
outgoingLinks de saída: target como escrito e id da nota (null se ainda não existe).
backlinksNotas que linkam para esta, com as linhas do link em snippets.
unlinkedNotas que citam o nome (ou um alias) sem link.

PATCH/api/knowledge/{id}#

Edita, renomeia ou move uma nota. Exige permissão de edição.

CampoDescrição
contentNovo texto.
titleNovo nome.
folderNova pasta ("" é a raiz).
updateLinksPadrão true: ao renomear ou mover, os links nas outras notas que você pode editar acompanham.
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 e cancelamento"}'

Resposta: { "doc": { ... }, "updatedLinks": 4, "updatedNotes": 3 }. Se já existir uma nota no caminho novo, a resposta é 409.

Pastas#

Pastas vêm das notas. Uma pasta vazia fica guardada só para quem a criou.

RotaO que faz
GET /api/knowledge/foldersLista as pastas: { "folders": [...] }.
POST /api/knowledge/foldersCria uma pasta vazia: { "path": "Clientes/Reuniões" }.
PATCH /api/knowledge/foldersRenomeia ou move uma pasta com as subpastas: { "from": "Comercial", "to": "Vendas/Comercial" }. Os links acompanham. Notas que você não pode editar ficam onde estão e entram em skipped.
DELETE /api/knowledge/folders?path=ArquivoApaga uma pasta vazia. Com notas dentro, a resposta é 409.
POST /api/knowledge/deleteExclui de uma vez notas e pastas inteiras (com subpastas e as notas de dentro): { "ids": ["kno_..."], "folders": ["Arquivo"], "expected": 14 }. Não há lixeira: é definitivo. Só saem as notas que você pode editar; as outras ficam onde estão e entram em kept. As notas excluídas saem dos agentes que as usavam. Com expected (quantas notas você confirmou), a resposta é 409 se o Brain mudou nesse meio-tempo. Resposta: { "deleted": 14, "kept": 0, "detachedAgents": 1, "folders": [...] }.

POST/api/knowledge/upload#

Sobe um arquivo. O texto é extraído no servidor. Corpo em multipart/form-data:

CampoDescrição
fileObrigatório. PDF, Word (.docx), Excel (.xlsx), CSV, JSON, Markdown ou texto. Até 20 MB.
titleNome. Padrão: o nome do arquivo. Nome repetido na pasta ganha um número.
folderPasta de destino.
replaceID de uma nota existente: troca o texto dela pelo do arquivo e mantém o ID, o nome, a pasta e os agentes ligados.
scopepersonal (padrão), team ou organization. organization exige ser administrador.
teamIdO time, quando scope é team. Você precisa ser membro.
curl -X POST https://doublex.ai/api/knowledge/upload \
  -H "Authorization: Bearer $DOUBLEX_API_KEY" \
  -F "[email protected]" \
  -F "folder=Comercial" \
  -F "scope=organization"

Resposta 201: { "doc": { "id": "kno_2c4e6a8b0d1f", "title": "politica-de-reembolso.pdf" }, "chars": 18420 }. Com replace, a resposta é 200 e traz "replaced": true.

StatusQuando
413Arquivo maior que 20 MB.
422Formato não suportado, arquivo vazio ou corrompido, PDF só com imagens, arquivo protegido por senha.
403Você não pode criar nesse escopo.
404A nota de replace não existe ou você não pode editá-la.

Busca nas notas que você pode ver.

QueryDescrição
qObrigatório. De 2 a 300 caracteres.
limitQuantos trechos devolver, de 1 a 50. Padrão 8.

A busca aceita os operadores do Obsidian:

OperadorExemploFiltra
tag:tag:#clienteNotas com a tag (ou uma subtag dela).
path:path:ComercialNotas cujo caminho contém o texto.
file:file:reuniãoNotas cujo nome contém o texto.
"...""prazo de reembolso"A frase exata.
--rascunhoTira as notas com a palavra.
curl "https://doublex.ai/api/knowledge/search?q=prazo%20path%3AComercial&limit=3" -H "Authorization: Bearer $DOUBLEX_API_KEY"
JSON
{
  "results": [
    { "docId": "kno_2c4e6a8b0d1f", "title": "Política de reembolso", "score": 1, "text": "…o cliente pode pedir reembolso em até 30 dias…" }
  ],
  "notes": [
    { "id": "kno_2c4e6a8b0d1f", "name": "Política de reembolso", "path": "Comercial/Política de reembolso", "score": 2, "matches": [{ "line": 2, "text": "Clientes podem pedir reembolso em até 30 dias." }] }
  ]
}

results são trechos pontuados, a mesma busca que os agentes usam. notes agrupa por nota, com as linhas encontradas. Sem acentos nem maiúsculas fazendo diferença; palavras com até duas letras são ignoradas em results.

DELETE/api/knowledge/{id}#

Apaga a nota e a tira dos agentes que a usavam. Exige permissão de edição; sem ela, a resposta é 404.

Resposta: { "ok": true }.