v1

latestOpenAPI 3.1.02026-07-2618690613.4 KB

Connections

Get connection

<Note> This endpoint requires **Restricted Querier** permissions or higher. </Note>

Fetch a single connection by ID.

get/v1/connections/{connectionId}

Path parameters

connectionIdstring uuid required

Connection ID

Response

Connection retrieved successfully

Example response

{
  "connection": {
    "id": "c0f12353-4817-4398-bcc0-d501e6dd2f64",
    "name": "Production Database",
    "dialect": "postgres",
    "database": "prod_db",
    "baseRole": "NO_ACCESS",
    "createdAt": "2026-06-01T14:30:00.000Z",
    "updatedAt": "2026-06-11T10:15:30.000Z",
    "userAttributeNameForConnectionEnvironments": "environment",
    "defaultSchema": "public"
  }
}