List Connections

Retrieves a list of all ClickHouse connections for the authenticated team. Passwords are never returned.

GET /api/v2/connections

Error

A valid request URL is required to generate request examples

200

{
  "data": [
    {
      "id": "507f1f77bcf86cd799439012",
      "name": "Production ClickHouse",
      "host": "https://clickhouse.example.com:8443",
      "username": "default",
      "hyperdxSettingPrefix": "hyperdx_",
      "isPrometheusEndpoint": false,
      "createdAt": "2025-01-01T00:00:00.000Z",
      "updatedAt": "2025-06-15T10:30:00.000Z"
    }
  ],
  "meta": {
    "skipped": 1,
    "skippedIds": [
      "507f1f77bcf86cd799439012"
    ]
  }
}

{
  "message": "Unauthorized access. API key is missing or invalid."
}

{
  "message": "NOT_FOUND: Alert not found"
}

التفويضات

Authorization · string · header · مطلوب

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

الاستجابة

200

application/json

Successfully retrieved connections

data · object[]

List of connection objects.

Show child attributes

meta · object

Present only when one or more stored connections could not be serialized and were omitted from data.

Show child attributes