DATABRICKS
Databricks
Databricks Jobs

Page-level Auto Tune status for a job

Changed on

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

Request

  • Base URL: https://api.myaltimate.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.myaltimate.com/api/v1/databricks/jobs/{job_id}/auto-tune/status
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

job_idstring required

Query parameters

instance_idinteger required

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 omitted, resolves ownership from job inventory.

navigationSourcestring nullable

Headers

x-tenantstring required

Response

Successful Response

state'enabled_active' | 'enabled_monitoring' | 'disabled' | 'unavailable' nullable
has_appliedboolean
auto_tune_modestring nullable

"enabled" if any task on the job has Auto Tune turned on. "disabled" if all active-recommendation tasks are off. None when there are no recommendations and no stored enrollment.

recommendation_countinteger
axis_flagsobject nullable
axis_preflightobject nullable
at_scoped_spend_usdnumber nullable
tasks_enabledinteger
tasks_totalinteger
annualized_cost_savings_usdnumber nullable
additional_potential_savings_usd_per_monthnumber nullable
realized_savings_usdnumber nullable
infra_cost_availableboolean nullable

Changes

  • 1b2d675195d7Revision changes
    • info

      added the optional property /// to the response with the status

    • info

      added the optional property / to the response with the status

  • a1870d258a3aRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property / to the response with the status