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.
| Query | Descrição |
|---|---|
agentId | Só os arquivos de um agente. |
curl "https://doublex.ai/api/artifacts?agentId=agt_8f3a2b1c9d0e" -H "Authorization: Bearer $DOUBLEX_API_KEY"{
"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.
| Query | Descrição |
|---|---|
agentId | Obrigatório. |
path | Obrigatório. O caminho que aparece na lista. |
download | Se 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.mdO 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.
| Query | Descrição |
|---|---|
agentId + path | Um arquivo da lista. |
live | Ou o id de uma criação viva (live_…). |
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.pdfDELETE/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.
| Campo | Descrição |
|---|---|
agentId | Obrigatório. |
path | Obrigatório. O caminho que aparece na lista. |
scope | Obrigatório. agent (interno), team, organization ou public. |
teamId | Obrigatório com team. Você precisa participar do time. |
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"}'{ "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.