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"{
"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
}
]
}| Campo | Descripción |
|---|---|
catalogId | La app en el catálogo (gmail, slack, hubspot, postgres…). Los conectores MCP personalizados no lo tienen. |
status | connected, needs_auth (vuelve a conectarlo en la pantalla Conectores) o error. |
tools[].readOnly | true si la herramienta solo consulta; false si cambia algo en la app. |
scope | Quié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.
| Campo | Tipo | Descripción |
|---|---|---|
tool | string | Obligatorio. Nombre de la herramienta, como aparece en tools[].name. |
arguments | objeto | Argumentos 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}}'{ "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.
| Estado | Cuándo |
|---|---|
404 | La conexión no existe o no puedes usarla. |
409 | Hay que volver a conectar la conexión (status distinto de connected). |
400 | Argumentos no válidos para una herramienta de base de datos. |
Quién puede usarla#
| Alcance | Quién la usa |
|---|---|
personal | Solo quien la conectó. Ni los administradores usan la cuenta personal de otra persona. |
team | Los miembros del equipo. |
organization | Todos en la organización. |