# Get Tool Connections

List all connected accounts for a specific integration tool.

Returns both active and disabled connections so the UI can display the current toggle state for each. Use the `is_active` field to render enable/disable controls.

#### Path Parameters

**`tool_key`** string required

Integration key (e.g., `clickup`, `github`, `slack`).

#### Query Parameters

**`organization_id`** string required

Organization ID (e.g., `org_722dd7...`).

**`application_id`** string optional · Defaults to `flowplate`

Application scope for filtering connections.

## Returns

**`connections`** array — All connected accounts for this tool, including disabled ones.

Each connection object contains:

**`id`** string — Credential ID (e.g., `tcred_43a8fec...`). Use this with the [Toggle Connection](/docs/api-reference/connectors/toggle-connection) endpoint.

**`tool_key`** string — Integration key (e.g., `clickup`).

**`display_name`** string — Human-readable label shown in dropdowns (e.g., `My Account - ClickUp`).

**`credential_name`** string or null — User-set custom name for this connection.

**`account_email`** string or null — Email address of the connected account if available.

**`connection_id`** string or null — External connection identifier.

**`is_active`** boolean — Whether this connection is currently enabled. Disabled connections exist but their tools are not loaded in chat.

**`created_at`** string — ISO 8601 timestamp of when the connection was created.

**`tool_key`** string (top-level) — The tool key that was queried.

Request

```bash cURL
curl "https://api.aitronos.com/v1/personal-connectors/connections/clickup?organization_id=org_722dd7..." \
  -H "X-API-Key: $FREDDY_API_KEY"
```


```python Python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]

response = requests.get(
    "https://api.aitronos.com/v1/personal-connectors/connections/clickup",
    headers={"X-API-Key": api_key},
    params={"organization_id": "org_722dd7..."},
)

data = response.json()
for conn in data["connections"]:
    status = "enabled" if conn["is_active"] else "disabled"
    print(f"{conn['display_name']} — {status}")
```


```javascript JavaScript
const apiKey = process.env.FREDDY_API_KEY;

const response = await fetch(
  "https://api.aitronos.com/v1/personal-connectors/connections/clickup?organization_id=org_722dd7...",
  {
    headers: { "X-API-Key": apiKey },
  }
);

const data = await response.json();
data.connections.forEach(conn => {
  console.log(`${conn.display_name} — ${conn.is_active ? "enabled" : "disabled"}`);
});
```

Response

```json 200 OK
{
  "connections": [
    {
      "id": "tcred_43a8fec047f64ba991fbc5f8fa25d2c9",
      "tool_key": "clickup",
      "display_name": "Work Account - ClickUp",
      "credential_name": "Work Account",
      "account_email": null,
      "connection_id": "ca_G8Sua39z0-vl",
      "is_active": true,
      "created_at": "2026-02-20T05:02:59.268269Z"
    },
    {
      "id": "tcred_9b1dc2e047f64ba991fbc5f8fa99c1d0",
      "tool_key": "clickup",
      "display_name": "Account - ClickUp",
      "credential_name": null,
      "account_email": null,
      "connection_id": "ca_X2Tub11k9-mn",
      "is_active": false,
      "created_at": "2026-01-10T12:00:00.000000Z"
    }
  ],
  "tool_key": "clickup"
}
```


```json 401 Unauthorized
{
  "success": false,
  "error": {
    "code": "AUTHENTICATION_REQUIRED",
    "message": "Authentication required. Please provide a valid API key.",
    "system_message": "Missing or invalid authorization header",
    "type": "authentication_error",
    "status": 401,
    "trace_id": "req_abc123xyz",
    "timestamp": "2025-11-11T10:30:00Z",
    "details": {}
  }
}
```

## Related Resources

- [Toggle Connection](/docs/api-reference/connectors/toggle-connection)
- [Rename Connection](/docs/api-reference/connectors/rename-connection)
- [Delete Connection](/docs/api-reference/connectors/delete-connection)
- [Disconnect Credential](/docs/api-reference/connectors/disconnect-credential)