Skip to main content
POST
Turn automated savings on or off for Databricks all-purpose clusters

Authorizations

Authorization
string
header
required

Organization API key (sl_…).

Headers

x-tenant-id
string
required

The organization ID the request is scoped to.

Body

application/json

Turn automated savings on or off for a batch of all-purpose clusters.

items
DatabricksApcClusterBatchItem · object[]
required

The clusters to update. Each cluster gets the same settings.

Required array length: 1 - 100 elements
enabled
boolean
required

True when the request leaves at least one automated savings feature on, false when it turns every feature off. The features themselves change only through config, so send a value that agrees with it.

config
DatabricksApcClusterConfigUpdate · object | null

The features to change. Only the fields you send change. Set auto_downscale or max_cluster_size_capping to turn that feature on or off. Automated savings is on while at least one of the two is on. Omit to keep the current settings.

Response

Successful Response

items
DatabricksApcCluster · object[]
required
row_count
integer
required

The number of applied entries.

failures
BatchItemFailure · object[]
required

The entries that were not applied, in request order. Empty when every entry was applied.

page_token
string | null

Opaque cursor for the next page; empty/absent on the last page.