Skip to main content
GET
Get a connection

Authorizations

Authorization
string
header
required

Organization API key (sl_…).

Headers

x-tenant-id
string
required

The organization ID the request is scoped to.

Path Parameters

connection_id
string
required

Response

Successful Response

A connection between SELECT and one data platform.

id
string
required
read-only

The unique identifier of the connection.

etag
string
required
read-only

Opaque strong ETag for this connection's configuration. Matches the ETag response header, and is what If-Match requires on a write. It changes whenever a configurable field on the connection changes.

name
string
required

Display name for the connection, as shown throughout SELECT.

connection_type
enum<string>
required
read-only

The data platform this connection reads from. Fixed when the connection is added; a connection cannot be moved to another platform.

Available options:
snowflake,
tableau,
databricks,
bigquery,
aws,
azure
sync_enabled
boolean
required

Whether SELECT is currently syncing data for this connection.

query_sanitization_enabled
boolean
required

Whether query text is sanitized before SELECT stores it.

looker_credentials_configured
boolean
required
read-only

Whether Looker credentials are configured for this connection. The credentials themselves are never returned.

create_time
string
required
read-only

When the connection was added.

update_time
string
required
read-only

When the connection was last changed.

looker_base_url
string | null

Base URL of the Looker instance to query.

looker_client_id
string | null

Identifier of the Looker API client SELECT uses.

added_by_email
string | null

Email address of the person who added the connection. Null when it was not added by a person.

last_successful_sync_time
string | null

When SELECT last completed a sync for this connection. Null before the first one succeeds.