---
title: "Page-level Auto Tune status for an all-purpose cluster"
method: GET
path: "/api/v1/databricks/clusters/{cluster_id}/auto-tune/status"
tags: ["DATABRICKS", "Databricks", "Databricks Clusters"]
---

# Page-level Auto Tune status for an all-purpose cluster

`GET /api/v1/databricks/clusters/{cluster_id}/auto-tune/status`

Read-only status for the Auto Tune tab on mount. Surfaces the
master toggle position, a live preflight snapshot for UI gating, and
the recommendation / enabled counts. No DB writes.

## Path parameters

- `cluster_id` string, required

## Query parameters

- `instance_id` integer, required — Tenant instance ID (workspace)
- `workspace_id` string, nullable — Optional Databricks workspace_id to scope the lookup.
- `navigationSource` string, nullable

## Headers

- `x-tenant` string, required

## Response `200`

Successful Response

- AutoTuneStatusResponse — Page-level status for the Auto Tune tab. Returned by GET /databricks/jobs/{job_id}/auto-tune/status. The FE uses this on JobDetail page mount to drive: - Master toggle position in the page header (auto_tune_mode). - Whether the toggle is interactive or disabled with a HoverCard explaining why (preflight.blocked + actionable_message). - Whether the Auto Tune tab content renders the full panel or the empty state (recommendation_count + auto_tune_mode). Read-only — no DB writes happen on this call.
  - `auto_tune_mode` string, 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.
  - `preflight` ToggleAutoTunePreflight — Surfaced to the FE so it can render an actionable error inline. When ``blocked=False`` the toggle pipeline ran. When ``blocked=True`` no DB writes happened and ``actionable_message`` should be shown to the user verbatim (e.g. "ask your workspace admin to add r5.xlarge to the policy allowlist").
    - `blocked` boolean
    - `reason` string, nullable
    - `actionable_message` string, nullable
  - `recommendation_count` integer
  - `axis_flags` object, nullable
  - `at_scoped_spend_usd` number, nullable
  - `tasks_enabled` integer
  - `tasks_total` integer

## Other responses

- `403` — Not authorized
- `422` — Validation Error

## Changes

- **2026-08-14** `7b73a4034706` — 1 info
  - added the optional property `axis_flags` to the response with the `200` status

[Change history](https://skmtc.dev/myaltimate/apis/fastapi/changes/api/v1/databricks/clusters/:cluster_id/auto-tune/status/get.md)

---

[API](https://skmtc.dev/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.dev/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/myaltimate/fastapi/revisions/82206441f16e/schema)