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"{
"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
}
]
}| Field | Description |
|---|---|
catalogId | The app in the catalog (gmail, slack, hubspot, postgres…). Custom MCP connectors don't have one. |
status | connected, needs_auth (reconnect on the Connectors page) or error. |
tools[].readOnly | true if the tool only reads; false if it changes something in the app. |
scope | Who 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.
| Field | Type | Description |
|---|---|---|
tool | string | Required. The tool name, as it appears in tools[].name. |
arguments | object | The 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}}'{ "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.
| Status | When |
|---|---|
404 | The connection doesn't exist or you can't use it. |
409 | The connection needs to be reconnected (status other than connected). |
400 | Invalid arguments for a database tool. |
Who can use it#
| Scope | Who uses it |
|---|---|
personal | Only the person who connected it. Not even admins can use someone else's personal account. |
team | Members of the team. |
organization | Everyone in the organization. |