DoubleX AgentesDocs

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.

QueryDescripción
agentIdSolo los archivos de un 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 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.

QueryDescripción
agentIdObligatorio.
pathObligatorio. La ruta que aparece en la lista.
downloadSi 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.md

El 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.

QueryDescripción
agentId + pathUn archivo de la lista.
liveO el id de una creación en vivo (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#

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.

CampoDescripción
agentIdObligatorio.
pathObligatorio. La ruta que aparece en la lista.
scopeObligatorio. agent (interno), team, organization o public.
teamIdObligatorio con team. Debes ser miembro del equipo.
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" } }

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.