Skip to main content
POST
Test Looker BI access for 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

Body

application/json

Looker credentials to test against an existing connection, without persisting them. Any field left out falls back to the connection's currently stored Looker configuration, so an empty body re-tests what's saved and a partial body tests a candidate change before it's written via a PATCH.

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.

looker_client_secret
string | null

The Looker API client secret.

Response

Successful Response

The result of validating a connection's configuration.

success
boolean
required

Whether every applicable check passed.

checks
ConnectionValidationCheck · object[]
required

The checks that ran, in the order they ran. Read top-down to find where setup stopped working.