DoubleX AgentesDocs

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"
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 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
    }
  ]
}
CampoDescrição
catalogIdO app no catálogo (gmail, slack, hubspot, postgres…). Conectores MCP personalizados não têm.
statusconnected, needs_auth (reconecte na tela Conectores) ou error.
tools[].readOnlytrue se a ferramenta só consulta; false se altera algo no app.
scopeQuem 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.

CampoTipoDescrição
toolstringObrigatório. Nome da ferramenta, como aparece em tools[].name.
argumentsobjetoArgumentos 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}}'
JSON
{ "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.

StatusQuando
404A conexão não existe ou você não pode usá-la.
409A conexão precisa ser reconectada (status diferente de connected).
400Argumentos inválidos para uma ferramenta de banco de dados.

Quem pode usar#

EscopoQuem usa
personalSó quem conectou. Nem administradores usam a conta pessoal de outra pessoa.
teamOs membros do time.
organizationTodos da organização.