Referência da API › Recursos
Conectores
Liste as conexões com apps e execute as ferramentas delas sem passar por um agente.
Conectar um app novo exige login no provedor (OAuth) e é feito pela tela Conectores. Pela API você lista as conexões que já existem e usa as ferramentas delas.
GET/api/connectors#
Lista as conexões que você pode ver, com as ferramentas de cada uma. Nenhum segredo é devolvido.
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 e-mails no Gmail com a mesma sintaxe da caixa de pesquisa…", "readOnly": true },
{ "name": "send_email", "description": "Envia um e-mail…", "readOnly": false }
],
"canEdit": true
}
]
}| Campo | Descrição |
|---|---|
catalogId | O app no catálogo (gmail, slack, hubspot, postgres…). Conectores MCP personalizados não têm. |
status | connected, needs_auth (reconecte na tela Conectores) ou error. |
tools[].readOnly | true se a ferramenta só consulta; false se altera algo no app. |
scope | Quem usa a conexão: personal, team ou organization. |
A resposta traz também o catálogo de apps disponíveis (catalog) e as categorias.
GET/api/connectors/{id}#
Devolve uma conexão: { "connector": {...} }. Erro 404 se ela não existe ou você não pode vê-la.
POST/api/connectors/{id}/call#
Executa uma ferramenta da conexão.
| Campo | Tipo | Descrição |
|---|---|---|
tool | string | Obrigatório. Nome da ferramenta, como aparece em tools[].name. |
arguments | objeto | Argumentos da ferramenta. Padrão {}. |
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 e-mails encontrados:\n1. De: …", "isError": false }O resultado vem como texto em text (até 20.000 caracteres). Quando a própria ferramenta falha (argumento errado, item inexistente no app), a resposta é 200 com "isError": true e a explicação em text.
| Status | Quando |
|---|---|
404 | A conexão não existe ou você não pode usá-la. |
409 | A conexão precisa ser reconectada (status diferente de connected). |
400 | Argumentos inválidos para uma ferramenta de banco de dados. |
Quem pode usar#
| Escopo | Quem usa |
|---|---|
personal | Só quem conectou. Nem administradores usam a conta pessoal de outra pessoa. |
team | Os membros do time. |
organization | Todos da organização. |