DoubleX AgentesDocs

API reference › Resources

Connectors

List your app connections and run their tools without going through an agent.

Connecting a new app requires signing in to the provider (OAuth) and is done on the Connectors page. Through the API, you list the connections that already exist and use their tools.

GET/api/connectors#

Lists the connections you can see, with each one's tools. No secrets are returned.

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": "Searches Gmail using the same syntax as the search box…", "readOnly": true },
        { "name": "send_email", "description": "Sends an email…", "readOnly": false }
      ],
      "canEdit": true
    }
  ]
}
FieldDescription
catalogIdThe app in the catalog (gmail, slack, hubspot, postgres…). Custom MCP connectors don't have one.
statusconnected, needs_auth (reconnect on the Connectors page) or error.
tools[].readOnlytrue if the tool only reads; false if it changes something in the app.
scopeWho uses the connection: personal, team or organization.

The response also includes the catalog of available apps (catalog) and the categories.

GET/api/connectors/{id}#

Returns one connection: { "connector": {...} }. Error 404 if it doesn't exist or you can't see it.

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

Runs one of the connection's tools.

FieldTypeDescription
toolstringRequired. The tool name, as it appears in tools[].name.
argumentsobjectThe tool's arguments. Default {}.
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": "Found 5 emails:\n1. From: …", "isError": false }

The result comes as text in text (up to 20,000 characters). When the tool itself fails (a wrong argument, an item that doesn't exist in the app), the response is 200 with "isError": true and the explanation in text.

StatusWhen
404The connection doesn't exist or you can't use it.
409The connection needs to be reconnected (status other than connected).
400Invalid arguments for a database tool.

Who can use it#

ScopeWho uses it
personalOnly the person who connected it. Not even admins can use someone else's personal account.
teamMembers of the team.
organizationEveryone in the organization.