DoubleX AgentesDocs

Referencia de la API › Recursos

Conectores

Lista las conexiones con apps y ejecuta sus herramientas sin pasar por un agente.

Conectar una app nueva requiere iniciar sesión en el proveedor (OAuth) y se hace en la pantalla Conectores. Con la API listas las conexiones que ya existen y usas sus herramientas.

GET/api/connectors#

Lista las conexiones que puedes ver, con las herramientas de cada una. No se devuelve ningún secreto.

curl https://doublex.ai/api/connectors -H "Authorization: Bearer $DOUBLEX_API_KEY"
JSON
{
  "connectors": [
    {
      "id": "con_7a9b1c3d5e2f",
      "catalogId": "gmail",
      "name": "Gmail",
      "status": "connected",
      "accountLabel": "[email protected]",
      "scope": "personal",
      "ownerId": "usr_1a2b3c4d5e6f",
      "tools": [
        { "name": "search_emails", "description": "Busca correos en Gmail con la misma sintaxis que el cuadro de búsqueda…", "readOnly": true },
        { "name": "send_email", "description": "Envía un correo…", "readOnly": false }
      ],
      "canEdit": true
    }
  ]
}
CampoDescripción
catalogIdLa app en el catálogo (gmail, slack, hubspot, postgres…). Los conectores MCP personalizados no lo tienen.
statusconnected, needs_auth (vuelve a conectarlo en la pantalla Conectores) o error.
tools[].readOnlytrue si la herramienta solo consulta; false si cambia algo en la app.
scopeQuién usa la conexión: personal, team u organization.

La respuesta también trae el catálogo de apps disponibles (catalog) y las categorías.

GET/api/connectors/{id}#

Devuelve una conexión: { "connector": {...} }. Error 404 si no existe o no puedes verla.

POST/api/connectors/{id}/call#

Ejecuta una herramienta de la conexión.

CampoTipoDescripción
toolstringObligatorio. Nombre de la herramienta, como aparece en tools[].name.
argumentsobjetoArgumentos de la herramienta. Predeterminado: {}.
curl -X POST https://doublex.ai/api/connectors/con_7a9b1c3d5e2f/call \
  -H "Authorization: Bearer $DOUBLEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool": "search_emails", "arguments": {"query": "is:unread newer_than:1d", "max_results": 5}}'
JSON
{ "text": "5 correos encontrados:\n1. De: …", "isError": false }

El resultado llega como texto en text (hasta 20.000 caracteres). Cuando la propia herramienta falla (argumento incorrecto, elemento inexistente en la app), la respuesta es 200 con "isError": true y la explicación en text.

EstadoCuándo
404La conexión no existe o no puedes usarla.
409Hay que volver a conectar la conexión (status distinto de connected).
400Argumentos no válidos para una herramienta de base de datos.

Quién puede usarla#

AlcanceQuién la usa
personalSolo quien la conectó. Ni los administradores usan la cuenta personal de otra persona.
teamLos miembros del equipo.
organizationTodos en la organización.