Connections

List connections

get/api/v1/connections

Query parameters

databasestring

Filter by database name (case-insensitive contains)

Example:analytics

Filter by database name (case-insensitive contains)

dialectstring

Filter by dialect(s). Comma-separated list for multiple values

Example:snowflake,bigquery

Filter by dialect(s). Comma-separated list for multiple values

includeDeletedboolean

Include soft-deleted connections in results

Include soft-deleted connections in results

namestring

Filter by connection name (case-insensitive contains)

Example:Production

Filter by connection name (case-insensitive contains)

sortDirection'asc' | 'desc'

Sort direction

Example:desc

Sort direction

sortField'database' | 'dialect' | 'name'

Field to sort by

Example:name

Field to sort by

Response

List of connections

Example response

{
  "connections": [
    {
      "baseRole": "QUERIER",
      "createdAt": "2024-01-15T10:30:00Z",
      "database": "analytics_db",
      "defaultSchema": "public",
      "dialect": "snowflake",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Production Snowflake",
      "updatedAt": "2024-01-15T10:30:00Z",
      "userAttributeNameForConnectionEnvironments": "region",
      "userAttributeValuesForDefaultEnvironment": [
        "us-east",
        "us-west"
      ]
    }
  ]
}

Changes