Sign in

v5

latestOpenAPI 3.1.02026-08-081,0211,3082.1 MB
DATABRICKS
Databricks
Databricks Jobs

Page-level Auto Tune status for a job

Read-only status endpoint consumed by the Auto Tune tab on mount.

Aggregates auto_tune_mode across every (entity_id, task_key) row for this job: master is "enabled" if ANY task is enabled. Surfaces a job-level preflight result so the FE can disable the master Switch when the SP can't act on the workspace, with the exact actionable message we'd show on a real toggle attempt. Also returns recommendation_count so the FE can gate the Auto Tune tab. Savings figures are not computed here — the FE derives its overall savings tiles from the per-day /auto-tune/savings-trends series (ClickHouse dbx_jobs_cost_savings).

No DB writes — the preflight result is a snapshot for UI gating only.

get/api/v1/databricks/jobs/{job_id}/auto-tune/status

Path parameters

job_idstring required

Query parameters

instance_idinteger required

Tenant instance ID (workspace) the job runs in

Tenant instance ID (workspace) the job runs in

workspace_idstring nullable

Optional Databricks workspace_id to scope queries to a specific workspace within the tenant's Databricks account. Defends against cross-workspace job_id collisions. When None, falls back to (instance_id, entity_id) lookup.

Optional Databricks workspace_id to scope queries to a specific workspace within the tenant's Databricks account. Defends against cross-workspace job_id collisions. When None, falls back to (instance_id, entity_id) lookup.

navigationSourcestring nullable

Headers

x-tenantstring required

Response

Successful Response

auto_tune_modestring nullable

"enabled" if any task on the job has Auto Tune turned on. "disabled" if all tasks are off or no config exists. None when there are no recommendations for this job at all.

recommendation_countinteger
at_scoped_spend_usdnumber nullable
tasks_enabledinteger
tasks_totalinteger