DoubleX AgentesDocs

Referência da API › Recursos

Criações

Liste e baixe os arquivos que os agentes criaram no computador deles.

GET/api/artifacts#

Lista os arquivos dos agentes que você pode ver, mais os que foram compartilhados com você, dos mais recentes para os mais antigos.

QueryDescrição
agentIdSó os arquivos de um agente.
curl "https://doublex.ai/api/artifacts?agentId=agt_8f3a2b1c9d0e" -H "Authorization: Bearer $DOUBLEX_API_KEY"
JSON
{
  "artifacts": [
    {
      "agentId": "agt_8f3a2b1c9d0e",
      "agentName": "Analista de CRM",
      "path": "relatorios/pedidos-outubro.md",
      "kind": "documento",
      "size": 4821,
      "modifiedAt": "2026-10-27T09:12:00.000Z",
      "share": { "scope": "agent" },
      "canEdit": true
    }
  ]
}

kind pode ser documento, planilha, apresentacao, dashboard, codigo ou outro.

share.scope diz quem vê o arquivo: agent (interno: quem vê o agente), team (com teamId), organization ou public (com url, o caminho do link público). canEdit indica se você pode editar o agente, e portanto compartilhar e apagar o arquivo.

GET/api/artifacts/file#

Devolve o conteúdo de um arquivo.

QueryDescrição
agentIdObrigatório.
pathObrigatório. O caminho que aparece na lista.
downloadSe presente, a resposta vem como anexo (Content-Disposition: attachment).
curl -G https://doublex.ai/api/artifacts/file \
  --data-urlencode "agentId=agt_8f3a2b1c9d0e" \
  --data-urlencode "path=relatorios/pedidos-outubro.md" \
  -H "Authorization: Bearer $DOUBLEX_API_KEY" -o pedidos-outubro.md

O Content-Type segue a extensão (text/html, text/csv, application/json, text/markdown, image/svg+xml, planilhas .xlsx, application/pdf; o resto vai como texto). Páginas HTML são servidas numa área isolada, sem acesso à rede. Arquivos de texto têm até 2 MB; planilhas .xlsx e PDFs, até 10 MB.

GET/api/pdf#

Gera o PDF (A4) de um documento .md, de uma página .html ou de uma tabela .csv do computador do agente, ou de uma criação viva com os dados atuais. Vale a mesma permissão de ver o arquivo ou a criação; cada PDF novo consome créditos como o navegador na nuvem, e o mesmo conteúdo sai do cache sem custo.

QueryDescrição
agentId + pathUm arquivo da lista.
liveOu o id de uma criação viva (live_…).
curl
curl -G https://doublex.ai/api/pdf \
  --data-urlencode "agentId=agt_8f3a2b1c9d0e" \
  --data-urlencode "path=relatorios/pedidos-outubro.md" \
  -H "Authorization: Bearer $DOUBLEX_API_KEY" -o pedidos-outubro.pdf

DELETE/api/artifacts/file#

Apaga um arquivo do computador do agente. Recebe agentId e path na query e exige permissão de edição do agente.

Resposta: { "ok": true }. Apagar o arquivo também desliga o link público dele.

PUT/api/artifacts/share#

Muda quem pode ver um arquivo. Exige permissão de edição do agente.

CampoDescrição
agentIdObrigatório.
pathObrigatório. O caminho que aparece na lista.
scopeObrigatório. agent (interno), team, organization ou public.
teamIdObrigatório com team. Você precisa participar do time.
curl
curl -X PUT https://doublex.ai/api/artifacts/share \
  -H "Authorization: Bearer $DOUBLEX_API_KEY" -H "Content-Type: application/json" \
  -d '{"agentId":"agt_8f3a2b1c9d0e","path":"dashboards/funil.html","scope":"public"}'
JSON
{ "share": { "scope": "public", "url": "/compartilhado/Q39iOloCAPMHVs4giIb69TxY" } }

Time e organização abrem só o arquivo, não o agente. Com public, qualquer pessoa com o link vê o arquivo sem login, sempre na versão mais recente; a página e o conteúdo bruto (/api/public/artifacts/<token>, com ?download para baixar) não são indexados por buscadores. Ao trocar public por outro alcance, o link para de funcionar; publicar de novo gera um link novo.