---
title: "Job-level Auto Tune enabled/disabled events for chart markers"
method: GET
path: "/api/v1/databricks/jobs/{job_id}/auto-tune/toggle-events"
tags: ["DATABRICKS", "Databricks", "Databricks Jobs"]
---

# Job-level Auto Tune enabled/disabled events for chart markers

`GET /api/v1/databricks/jobs/{job_id}/auto-tune/toggle-events`

## 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/toggle-events`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Enable/disable events across every task under this job, for the
Cost Savings chart's vertical markers.

Each user toggle click writes one job-level ``JOB_AUTO_TUNE_ENABLED`` /
``JOB_AUTO_TUNE_DISABLED`` row, which is the marker for that click (one
per click and direction, however many tasks it touched). History
written before those rows existed has no such row: its human
``APPLY_REQUESTED`` (enable) and ``REVERTED`` (disable) rows, one PER
TASK, are returned as markers instead. Slot rows stamped with
``toggle_audit_id`` are skipped so a click is never marked twice;
system re-arms, recovery requeues, and unattributed legacy requests are
not toggle markers.
``entity_type`` is intentionally NOT filtered on, mirroring
``/auto-tune/history`` above — the toggle pipeline and the
entity-generic config pipeline stamp different ``entity_type``
values for job rows, so filtering on it risks silently dropping
real events.

## Path parameters

- `job_id` string, required

## Query parameters

- `instance_id` integer, required: Tenant instance ID (workspace) the job runs in
- `workspace_id` string, nullable: Optional Databricks workspace_id to scope the lookup. Defends against cross-workspace job_id collisions.
- `start_date` string, date, nullable: Start date
- `end_date` string, date, nullable: End date

## Headers

- `x-tenant` string, required

## Response `200`

Successful Response

- ClusterAutoTuneToggleEventsResponse: List response for ``GET /auto-tune/toggle-events``.
  - `events` ClusterAutoTuneToggleEvent[]
    - `event_type` 'enabled' | 'disabled', required
    - `change_timestamp` string, date-time, required

## Other responses

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

## Changes

- **2026-09-02** `fcb62c79da95`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/myaltimate/apis/fastapi/changes/api/v1/databricks/jobs/:job_id/auto-tune/toggle-events/get.md)

---

[API](https://skmtc.dev/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.dev/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/myaltimate/apis/fastapi/revisions/d27f88f98337?raw)