---
title: "Upsert Connection"
method: PUT
path: "/api/databricks/connection"
tags: ["databricks"]
---

# Upsert Connection

`PUT /api/databricks/connection`

Create or update the organization's Databricks connection.

## Request body

- QuadrillionCloudApiRoutersDatabricksConnectionRequest — Org-admin configuration for the tenant's Databricks workspace.
  - `workspace_host` string, required
  - `cloud` 'aws' | 'azure' | 'gcp', required — Cloud a Databricks workspace is hosted on. Determines the account console host used for account-level OIDC, so it is persisted rather than inferred from the workspace hostname.
  - `oauth_client_id` string, required
  - `oauth_client_secret` string, nullable
  - `oauth_redirect_uri` string, required
  - `enabled_auth_modes` string[]
  - `service_principal_client_id` string, nullable
  - `federation_audience` string, nullable

## Response `200`

Successful Response

- QuadrillionCloudApiRoutersDatabricksConnectionResponse — Non-secret view of a Databricks connection.
  - `configured` boolean, required
  - `workspace_host` string, nullable
  - `workspace_id` string, nullable
  - `cloud` string, nullable
  - `oauth_client_id` string, nullable
  - `oauth_redirect_uri` string, nullable
  - `has_client_secret` boolean
  - `enabled_auth_modes` string[]
  - `service_principal_client_id` string, nullable
  - `federation_audience` string, nullable
  - `federation_ready` boolean
  - `warehouse_id` string, nullable
  - `genie_agent_id` string, nullable
  - `default_catalog` string, nullable
  - `default_schema` string, nullable
  - `disabled` boolean

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-12** `dcf9b4550387` — 5 info
  - added the new optional request property `federation_audience`
  - added the new optional request property `service_principal_client_id`
  - added the optional property `federation_audience` to the response with the `200` status
  - added the optional property `federation_ready` to the response with the `200` status
  - …1 more
- **2026-08-07** `5ebc654175d4` — 2 warning
  - removed the request property `account_id`
  - removed the optional property `account_id` from 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/connection/put.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)