v5

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

Paginated Auto Tune audit history for a job

Read-only audit history for the Auto Tune tab.

Returns the most-recent events first. Each row carries event_message composed server-side from event_type + mode + actor

  • payload via DBX_AUTO_TUNE_EVENT_UI_MAPPING so the FE renders one string verbatim.

User resolution is manual (PR #5070 hasn't merged): we batch-load altimate_users rows for the non-null changed_by ids on the page and attach changed_by_name before serialization.

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

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

event_typesstring nullable

Comma-separated list of event_type values to include. Empty/omitted defaults to the 5 customer-relevant states (APPLY_REQUESTED, APPLIED, REVERTED, BACKOFF, FAILED). Pass explicit values (e.g. MUTATION_STARTED, CANCELLED) to escape the default for internal/debug use.

Comma-separated list of event_type values to include. Empty/omitted defaults to the 5 customer-relevant states (APPLY_REQUESTED, APPLIED, REVERTED, BACKOFF, FAILED). Pass explicit values (e.g. MUTATION_STARTED, CANCELLED) to escape the default for internal/debug use.

periodinteger nullable

Look-back window in days. Excludes audit rows whose change_timestamp is older than now - period days.

Look-back window in days. Excludes audit rows whose change_timestamp is older than now - period days.

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.

pageinteger

Page number (1-indexed)

Page number (1-indexed)

page_sizeinteger

Items per page

Items per page

Headers

x-tenantstring required

Response

Successful Response

total_countinteger
pageinteger
page_sizeinteger
total_pagesinteger