Referencia de la API › Recursos
Creaciones
Lista y descarga los archivos que los agentes crearon en su computadora.
GET/api/artifacts#
Lista los archivos de los agentes que puedes ver, más los que se compartieron contigo, de los más recientes a los más antiguos.
| Query | Descripción |
|---|---|
agentId | Solo los archivos de un 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 puede ser documento, planilha, apresentacao, dashboard, codigo u outro.
share.scope dice quién ve el archivo: agent (interno: quien ve el agente), team (con teamId), organization o public (con url, la ruta del enlace público). canEdit indica si puedes editar el agente y, por lo tanto, compartir y borrar el archivo.
GET/api/artifacts/file#
Devuelve el contenido de un archivo.
| Query | Descripción |
|---|---|
agentId | Obligatorio. |
path | Obligatorio. La ruta que aparece en la lista. |
download | Si está presente, la respuesta llega como adjunto (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.mdEl Content-Type sigue la extensión (text/html, text/csv, application/json, text/markdown, image/svg+xml, hojas de cálculo .xlsx, application/pdf; el resto se envía como texto). Las páginas HTML se sirven en un área aislada, sin acceso a la red. Los archivos de texto tienen hasta 2 MB; las hojas .xlsx y los PDF, hasta 10 MB.
GET/api/pdf#
Genera el PDF (A4) de un documento .md, una página .html o una tabla .csv del ordenador del agente, o de una creación en vivo con sus datos actuales. Exige el mismo permiso que ver el archivo o la creación; cada PDF nuevo consume créditos como el navegador en la nube, y el mismo contenido sale de la caché sin costo.
| Query | Descripción |
|---|---|
agentId + path | Un archivo de la lista. |
live | O el id de una creación en vivo (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#
Borra un archivo de la computadora del agente. Recibe agentId y path en la query y requiere permiso de edición del agente.
Respuesta: { "ok": true }. Borrar el archivo también desactiva su enlace público.
PUT/api/artifacts/share#
Cambia quién puede ver un archivo. Requiere permiso de edición del agente.
| Campo | Descripción |
|---|---|
agentId | Obligatorio. |
path | Obligatorio. La ruta que aparece en la lista. |
scope | Obligatorio. agent (interno), team, organization o public. |
teamId | Obligatorio con team. Debes ser miembro del equipo. |
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" } }Equipo y organización abren solo el archivo, no el agente. Con public, cualquier persona con el enlace ve el archivo sin iniciar sesión, siempre en la versión más reciente; la página y el contenido bruto (/api/public/artifacts/<token>, con ?download para descargar) no los indexan los buscadores. Al cambiar public por otro alcance, el enlace deja de funcionar; volver a publicar crea un enlace nuevo.