v5

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

Get Databricks auto right-sizing recommendations for a job

Return rows from dbx_auto_recommendation scoped to this job.

Each row carries auto_tune_mode projected via LEFT JOIN on databricks_auto_tune_configuration (PRD §6 Option A — single source of truth for the toggle position) plus a server-computed monthly_savings_usd.

Each item also carries depends_on (upstream task DAG edges from dbx_job_tasks_inventory.depends_on_keys) and latest_action_event_type (most recent audit event_type per task_key — drives the FE status pill).

get/api/v1/databricks/jobs/{job_id}/auto-recommendations

Path parameters

job_idstring required

Query parameters

instance_idinteger required

Tenant instance ID (workspace) to scope the lookup

Tenant instance ID (workspace) to scope the lookup

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.

start_datestring date nullable

Start of the window the savings figures are summed over. Matches the shape of /auto-tune/savings-trends so the FE's date-range picker can drive both the chart and this drawer consistently. Defaults to 30 days before end_date when omitted.

Start of the window the savings figures are summed over. Matches the shape of /auto-tune/savings-trends so the FE's date-range picker can drive both the chart and this drawer consistently. Defaults to 30 days before end_date when omitted.

end_datestring date nullable

End of the savings window (inclusive). Defaults to today (UTC) when omitted.

End of the savings window (inclusive). Defaults to today (UTC) when omitted.

navigationSourcestring nullable

Headers

x-tenantstring required

Response

Successful Response

total_countinteger

Total number of recommendations returned