---
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
    - `passed` boolean, required
    - `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[]

---

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