---
title: "Run Connection Preflight"
method: GET
path: "/api/databricks/preflight"
tags: ["databricks"]
---

# Run Connection Preflight

`GET /api/databricks/preflight`

Discover warehouses and Genie Spaces, and report every access check.

Runs as the acting user rather than a service principal, because their
permissions are what Unity Catalog will enforce at query time.

## Response `200`

Successful Response

- PreflightResponse — Discovery results and check outcomes for the connection.
  - `ok` boolean, required
  - `workspace_id` string, nullable
  - `checks` CheckResponse[]
    - `name` string, required
    - `status` 'passed' | 'failed' | 'unknown', required — Outcome of one preflight check. ``UNKNOWN`` is for checks needing rights the caller may lack; folding those into ``PASSED`` renders a green tick beside text saying the opposite.
    - `detail` string, required
    - `remediation` string, nullable
  - `warehouses` WarehouseResponse[]
    - `warehouse_id` string, required
    - `name` string, required
    - `http_path` string, required
    - `state` string, nullable
    - `serverless` boolean
  - `genie_agents` GenieAgentResponse[]
    - `agent_id` string, required
    - `title` string, required
    - `description` string, nullable
  - `catalogs` string[]

## Changes

- **2026-08-12** `dcf9b4550387` — 1 breaking, 1 info
  - removed the required property `checks/items/passed` from the response with the `200` status
  - added the required property `checks/items/status` to the response with the `200` status
- **2026-08-06** `b83470407807` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/quadrillion/apis/quadrillion-cloud-api/changes/api/databricks/preflight/get.md)

---

[API](https://skmtc.dev/quadrillion/apis/quadrillion-cloud-api.md) · [All operations](https://skmtc.dev/quadrillion/apis/quadrillion-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/quadrillion/quadrillion-cloud-api/revisions/f4de1bab5efb/schema)