---
title: "Connect"
method: POST
path: "/api/databricks/partner-connect/connect"
tags: ["databricks"]
---

# Connect

`POST /api/databricks/partner-connect/connect`

Accept provisioning details for a workspace.

An unconnected workspace parks its payload under a one-time token, since
Databricks does not know which organization to bind it to. A connected one
is refreshed in place rather than duplicated.

## Response `200`

Successful Response

- ConnectResponse — The contract's ``Connection`` schema. ``redirect_uri`` is the URL Databricks opens; ``redirect_value`` names the scenario that URL serves, which is a fixed enum rather than the URL again. ``already_connected`` is ours, not the contract's, and the settings page reads it. ``configured_resources`` is a boolean in the contract, not an inventory: it answers whether we kept the resources Databricks provisioned. Answering ``False`` for a workspace whose payload we are still holding would have Databricks delete that warehouse before the admin ever redeems it, so both paths answer ``True`` and name what they kept in ``connection_id``, which the contract requires whenever the flag is set.
  - `redirect_uri` string, required
  - `redirect_value` 'create_trial' | 'purchase_product' | 'sign_in' | 'contact_admin' | 'not_applicable', required — Which scenario ``redirect_uri`` opens. Not a second spelling of the URL: Databricks reads this to check that the tile sent the customer somewhere appropriate, and its certification suite asserts against the enum.
  - `user_status` 'new' | 'existing' | 'not_applicable', required — Whether we have seen this user before, per the contract's vocabulary.
  - `account_status` 'new' | 'active' | 'expired' | 'not_applicable', required — Whether we have seen this account before, and whether it still runs.
  - `configured_resources` boolean
  - `connection_id` string, nullable
  - `already_connected` boolean

---

[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/e99c1b6139c8/schema)