---
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

- ConnectionRequest — 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[]

## Response `200`

Successful Response

- ConnectionResponse — 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[]
  - `warehouse_id` string, nullable
  - `genie_agent_id` string, nullable
  - `default_catalog` string, nullable
  - `default_schema` string, nullable
  - `disabled` boolean

## Other responses

- `422` — Validation Error

---

[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)