v5

latestOpenAPI 3.1.02026-08-081,0211,3082.1 MB

DATABRICKS

Databricks

Databricks Warehouses

Enable or disable auto-tune for a SQL warehouse

Enable or disable auto-tune for a serverless SQL warehouse.

Applies inline and synchronously — unlike the job-cluster toggle, a warehouse /edit drains gracefully, so there is no async worker hand-off. See app.service.databricks.auto_tune.warehouse_toggle for the full enable/disable flow (recommendation resolution, write-once baseline capture, and the audit trail written).

post/api/v1/databricks/warehouses/{warehouse_id}/auto-tune/toggle

Path parameters

warehouse_idstring required

Headers

x-tenantstring required

Request body

enabledboolean required

Desired auto-tune state for the warehouse.

instance_idinteger required

Tenant instance ID (workspace) the warehouse runs in.

workspace_idstring required

Required Databricks workspace_id. Scopes credential resolution to the correct workspace on multi-workspace tenants (defends against cross-workspace warehouse_id collisions) AND is the join key the ingestion cost-savings mart (mrt_auto_tune_cost_savings) uses to attribute realized savings on (workspace_id, entity_id). An empty or mismatched value silently drops all actual savings for this warehouse.

Response

Successful Response

auto_tune_mode'enabled' | 'disabled' required

appliedboolean

True iff this call actually mutated the live warehouse.

auto_stop_mins_frominteger nullable

auto_stop_mins_tointeger nullable

blockedboolean

True iff the requested action could not proceed (see reason).

reasonstring nullable

audit_event_idsinteger[]