Altimate AI

Altimate AI DATABRICKS API

The DATABRICKS API from Altimate AI — 139 operation(s) for databricks.

GitHub OpenAPI

Operations 142

GET /api/v1/databricks/datapilot/initial-questions Get AI Studio initial questions for Databricks resources #
GET /api/v1/databricks/cost/workspaces Get available Databricks workspaces #
GET /api/v1/databricks/cost/overview Get Databricks cost overview #
GET /api/v1/databricks/cost/breakdown/sku Get cost breakdown by SKU #
GET /api/v1/databricks/cost/breakdown/workspace Get cost breakdown by workspace #
GET /api/v1/databricks/cost/breakdown/product Get cost breakdown by product #
GET /api/v1/databricks/cost/comparison Get cost comparison between periods #
GET /api/v1/databricks/cost/total Get total cost with category breakdown #
GET /api/v1/databricks/cost/total/estimate Get total estimated cost for the year #
GET /api/v1/databricks/cost/compute-efficiency Get compute efficiency breakdown #
GET /api/v1/databricks/cost/workspace-efficiency Get efficiency metrics per workspace #
GET /api/v1/databricks/cost/cloud/projection Get cloud infrastructure cost projection (actual + month-end estimate) #
GET /api/v1/databricks/clusters/filters Get filter options for clusters #
GET /api/v1/databricks/clusters/filters/cluster_names Get paginated distinct cluster names for filtering #
GET /api/v1/databricks/clusters/filters/workspaces Get paginated distinct cluster workspaces for filtering #
GET /api/v1/databricks/clusters Get all Databricks clusters #
GET /api/v1/databricks/clusters/oversized Get oversized clusters #
GET /api/v1/databricks/clusters/{cluster_id} Get cluster details #
GET /api/v1/databricks/clusters/{cluster_id}/utilization Get cluster utilization metrics #
GET /api/v1/databricks/clusters/{cluster_id}/state-history Get cluster state history #
GET /api/v1/databricks/clusters/{cluster_id}/cost Get cluster cost data #
GET /api/v1/databricks/clusters/{cluster_id}/auto-tune/status Page-level Auto Tune status for an all-purpose cluster #
GET /api/v1/databricks/clusters/{cluster_id}/auto-tune/recommendations Active Auto Tune recommendations for an all-purpose cluster #
PATCH /api/v1/databricks/clusters/{cluster_id}/auto-tune/toggle Toggle Auto Tune for an all-purpose cluster (master or sub-toggle) #
GET /api/v1/databricks/clusters/{cluster_id}/auto-tune/history Paginated Auto Tune audit history for an all-purpose cluster #
GET /api/v1/databricks/clusters/{cluster_id}/auto-tune/savings-trends Per-day Possible Savings for an all-purpose cluster #
GET /api/v1/databricks/warehouses/filters Get filter options for warehouses #
GET /api/v1/databricks/warehouses Get all Databricks warehouses #
GET /api/v1/databricks/warehouses/total-savings Get total auto-tune savings across SQL warehouses #
GET /api/v1/databricks/warehouses/serverless-candidates Get serverless migration candidates #
GET /api/v1/databricks/warehouses/{warehouse_id} Get warehouse details #
GET /api/v1/databricks/warehouses/{warehouse_id}/events Get warehouse events #
GET /api/v1/databricks/warehouses/{warehouse_id}/state-history Get warehouse state history #
GET /api/v1/databricks/warehouses/{warehouse_id}/cost Get warehouse cost data #
GET /api/v1/databricks/warehouses/{warehouse_id}/auto-tune/savings-trends Get per-day auto-tune savings (realized + potential) for a SQL warehouse #
GET /api/v1/databricks/warehouses/{warehouse_id}/auto-tune/savings-summary Get realised savings range and estimated annual savings for a SQL warehouse #
GET /api/v1/databricks/warehouses/{warehouse_id}/running-stats-trends Get warehouse running stats trends #
GET /api/v1/databricks/warehouses/{warehouse_id}/utilization-efficiency Get warehouse utilization efficiency #
GET /api/v1/databricks/warehouses/{warehouse_id}/query-metrics-timeline Get time-bucketed query metrics timeline for a warehouse #
GET /api/v1/databricks/jobs/filters Get filter options for jobs #
GET /api/v1/databricks/jobs/filters/job_names Get paginated distinct job names for filtering #
GET /api/v1/databricks/jobs/filters/workspaces Get paginated distinct job workspaces for filtering #
GET /api/v1/databricks/jobs/filters/creators Get paginated distinct job creators for filtering #
GET /api/v1/databricks/jobs Get all Databricks jobs #
GET /api/v1/databricks/jobs/summary Get aggregate cost summary for the Jobs list #
GET /api/v1/databricks/jobs/failing Get jobs with high failure rates #
GET /api/v1/databricks/jobs/recent-failures Get recent job failures #
GET /api/v1/databricks/jobs/{job_id} Get job details #
GET /api/v1/databricks/jobs/{job_id}/runs Get job runs #
GET /api/v1/databricks/jobs/{job_id}/stats Get job run statistics #
GET /api/v1/databricks/jobs/{job_id}/trends Get job run trends over time #
GET /api/v1/databricks/jobs/{job_id}/auto-tune/savings-trends Get per-day auto-tune savings (realized + potential) for a job #
GET /api/v1/databricks/jobs/{job_id}/task-runs Get the job-level task summary (one row per task on the DAG) #
GET /api/v1/databricks/jobs/{job_id}/task-runs/detail Get run/task-scoped task runs (requires run_id or task_key) #
GET /api/v1/databricks/jobs/{job_id}/tasks/{task_key}/runs-graph Get chart-ready time series of runs for a single task #
GET /api/v1/databricks/jobs/{job_id}/tasks/{task_key}/stats Get aggregate run stats for a single task in a date window #
GET /api/v1/databricks/jobs/{job_id}/runs/{run_id}/spark-ui Get the Databricks Spark UI URL for a job run #
GET /api/v1/databricks/jobs/{job_id}/tasks-inventory Get the static task list for a Databricks job #
GET /api/v1/databricks/jobs/{job_id}/spark-analysis Get Spark analysis for job's latest run #
GET /api/v1/databricks/jobs/{job_id}/spark-analysis/stage-metrics Get paginated stage metrics for a job's Spark run #
GET /api/v1/databricks/jobs/{job_id}/spark-analysis/tasks Get paginated individual Spark tasks for a job's Spark run #
GET /api/v1/databricks/jobs/{job_id}/spark-analysis/opportunities Get optimization opportunities for a job's Spark run with code linkage #
GET /api/v1/databricks/jobs/{job_id}/auto-recommendations Get Databricks auto right-sizing recommendations for a job #
PATCH /api/v1/databricks/jobs/{job_id}/auto-tune/toggle Toggle auto-tune on/off for a job's recommendation #
GET /api/v1/databricks/jobs/{job_id}/auto-tune/status Page-level Auto Tune status for a job #
GET /api/v1/databricks/jobs/{job_id}/auto-tune/history Paginated Auto Tune audit history for a job #
GET /api/v1/databricks/queries/filters Get filter options for queries #
GET /api/v1/databricks/queries/filters/users Search query-history user names by prefix #
GET /api/v1/databricks/queries/filters/computes Search the unified compute list by prefix #
GET /api/v1/databricks/queries/filters/workspaces Search query-history workspaces by name prefix #
GET /api/v1/databricks/queries/filters/statement-ids Search statement IDs for the Query ID filter dropdown #
GET /api/v1/databricks/queries/summary Get query summary metrics #
GET /api/v1/databricks/queries Get queries #
GET /api/v1/databricks/queries/slow Get slow queries #
GET /api/v1/databricks/queries/spills Get queries with memory spills #
GET /api/v1/databricks/queries/full-scans Get queries with large data reads #
GET /api/v1/databricks/queries/failed Get failed queries #
GET /api/v1/databricks/queries/breakdown/statement-type Get query breakdown by statement type #
GET /api/v1/databricks/queries/breakdown/user Get query breakdown by user #
GET /api/v1/databricks/queries/unified Get unified queries with insights #
GET /api/v1/databricks/queries/{statement_id} Get query detail by statement ID #
GET /api/v1/databricks/queries/{statement_id}/sql-lineage Get SQL lineage visualization for a query #
GET /api/v1/databricks/insights/overview Get Databricks environment overview #
GET /api/v1/databricks/insights/workspace-activity Get activity by workspace #
GET /api/v1/databricks/opportunities/summary Get opportunities summary #
GET /api/v1/databricks/opportunities/oversized-clusters Get oversized cluster opportunities #
GET /api/v1/databricks/opportunities/serverless-candidates Get serverless migration candidates #
GET /api/v1/databricks/opportunities/high-failure-jobs Get high failure rate jobs #
GET /api/v1/databricks/opportunities/expensive-queries Get expensive queries #
GET /api/v1/databricks/opportunities/idle-clusters Get idle clusters #
GET /api/v1/databricks/opportunities/by-resource Get opportunities for a specific resource #
GET /api/v1/databricks/opportunities/redirection Get resource redirection URL for Databricks #
GET /api/v1/databricks/opportunities/resource Get opportunities for a specific resource #
GET /api/v1/databricks/savings/autonomous Get autonomous savings #
GET /api/v1/databricks/savings/assisted Get assisted savings #
GET /api/v1/databricks/savings/assisted/tracked Get tracked assisted savings from PostgreSQL #
GET /api/v1/databricks/savings/overall Get overall savings summary #
GET /api/v1/databricks/savings/overall/estimate Get overall savings estimate with projections #
GET /api/v1/databricks/users/filters Get filter options for users #
GET /api/v1/databricks/users Get all users with query statistics #
GET /api/v1/databricks/users/top/queries Get top users by query count #
GET /api/v1/databricks/users/top/data-read Get top users by data read #
GET /api/v1/databricks/users/service-principal-config Get service-principal classification config #
PUT /api/v1/databricks/users/service-principal-config Upsert service-principal classification config #
GET /api/v1/databricks/users/{user_name} Get user details #
GET /api/v1/databricks/users/{user_name}/trends Get user query trends #
GET /api/v1/databricks/users/{user_name}/statement-breakdown Get user statement breakdown #
GET /api/v1/databricks/ai-ml-services/summary Get AI/ML services summary with trend data #
GET /api/v1/databricks/ai-ml-services/endpoints Get unified list of AI/ML endpoints (Model Serving + Vector Search + AI Gateway) #
GET /api/v1/databricks/ai-ml-services/endpoints/filters Get filter values for the unified AI/ML endpoints list #
GET /api/v1/databricks/ai-ml-services/endpoints/filters/names Get searchable, paginated endpoint names for the name filter #
GET /api/v1/databricks/ai-ml-services/endpoints/{endpoint_name} Get endpoint detail (Model Serving, Vector Search or AI Gateway) #
GET /api/v1/databricks/ai-ml-services/endpoints/{endpoint_name}/trend Get endpoint trend (Model Serving, Vector Search or AI Gateway) #
GET /api/v1/databricks/ai-ml-services/endpoints/{endpoint_name}/callers Get jobs/queries calling a model serving endpoint #
GET /api/v1/databricks/ai-ml-services/endpoints/{endpoint_name}/usage-breakdown Get AI function usage breakdown by source #
GET /api/v1/databricks/spark Get all Spark applications #
GET /api/v1/databricks/spark/{application_id} Get Spark application details #
GET /api/v1/databricks/spark/{application_id}/stages Get Spark application stages #
GET /api/v1/databricks/spark/{application_id}/task-stats Get per-stage task statistics #
GET /api/v1/databricks/spark/{application_id}/config Get Spark application configuration #
GET /api/v1/databricks/spark/{application_id}/plan-analysis Get Spark plan analysis flags #
POST /api/v1/databricks/connections/test Test Databricks connection credentials #
POST /api/v1/databricks/connections Create a new Databricks connection #
GET /api/v1/databricks/connections List all Databricks connections #
GET /api/v1/databricks/connections/{connection_id} Get a Databricks connection by ID #
DELETE /api/v1/databricks/connections/{connection_id} Delete a Databricks connection #
POST /api/v1/databricks/connections/{connection_id}/validate Re-validate an existing connection #
GET /api/v1/databricks/access-rules/options List Databricks accounts/workspaces grantable in access rules #

Documentation

📖
Documentation
https://help.altimate.ai/
📖
APIReference
https://api.myaltimate.com/docs

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/altimate-ai/refs/heads/main/openapi/altimate-ai-databricks-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/altimate-ai-databricks-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

altimate-ai-databricks-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Fast ACCOUNT_COSTS DATABRICKS API
  version: 0.1.0
servers:
- url: https://api.myaltimate.com
  description: Base URL reconciled from apis.yml
tags:
- name: DATABRICKS
paths:
  /api/v1/databricks/datapilot/initial-questions:
    get:
      tags:
      - DATABRICKS
      summary: Get AI Studio initial questions for Databricks resources
      description: Get suggested AI Studio questions for Databricks resources.
      operationId: get_databricks_initial_questions_api_v1_databricks_datapilot_initial_questions_get
      security:
      - HTTPBearer: []
      - HTTPBearer: []
      parameters:
      - name: resource_type
        in: query
        required: true
        schema:
          $ref: '#/components/schemas/DatabricksResourceType'
          description: Type of resource (cluster, warehouse, job, query, user)
        description: Type of resource (cluster, warehouse, job, query, user)
      - name: resource_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional resource ID for context
          title: Resource Id
        description: Optional resource ID for context
      - name: resource_name
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional resource name for context
          title: Resource Name
        description: Optional resource name for context
      - name: workspace_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional workspace ID for context
          title: Workspace Id
        description: Optional workspace ID for context
      - name: x-tenant
        in: header
        required: true
        schema:
          type: string
          title: X-Tenant
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/databricks/cost/workspaces:
    get:
      tags:
      - DATABRICKS
      summary: Get available Databricks workspaces
      description: Get list of available Databricks workspaces.
      operationId: get_workspaces_api_v1_databricks_cost_workspaces_get
      security:
      - HTTPBearer: []
      - HTTPBearer: []
      parameters:
      - name: navigationSource
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Navigationsource
      - name: x-tenant
        in: header
        required: true
        schema:
          type: string
          title: X-Tenant
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspacesResponse'
        '403':
          description: Not authorized
        '404':
          description: No ClickHouse database configured
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/databricks/cost/overview:
    get:
      tags:
      - DATABRICKS
      summary: Get Databricks cost overview
      description: 'Get cost overview with summary metrics.


        Returns total DBUs, estimated cost, and period-over-period comparison.'
      operationId: get_cost_overview_api_v1_databricks_cost_overview_get
      security:
      - HTTPBearer: []
      - HTTPBearer: []
      parameters:
      - name: start_date
        in: query
        required: true
        schema:
          type: string
          format: date
          description: Start date for the period
          title: Start Date
        description: Start date for the period
      - name: end_date
        in: query
        required: false
        schema:
          type: string
          format: date
          description: End date for the period
          title: End Date
        description: End date for the period
      - name: workspace_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Filter by workspace ID
          title: Workspace Id
        description: Filter by workspace ID
      - name: navigationSource
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Navigationsource
      - name: x-tenant
        in: header
        required: true
        schema:
          type: string
          title: X-Tenant
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CostOverviewResponse'
        '403':
          description: Not authorized
        '404':
          description: No ClickHouse database configured
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/databricks/cost/trends:
    get:
      tags:
      - DATABRICKS
      summary: Get Databricks cost trends over time
      description: 'Get cost trends over time.


        Returns time series data with DBU consumption and estimated cost per period.'
      operationId: get_cost_trends_api_v1_databricks_cost_trends_get
      security:
      - HTTPBearer: []
      - HTTPBearer: []
      parameters:
      - name: start_date
        in: query
        required: true
        schema:
          type: string
          format: date
          description: Start date for the period
          title: Start Date
        description: Start date for the period
      - name: end_date
        in: query
        required: false
        schema:
          type: string
          format: date
          description: End date for the period
          title: End Date
        description: End date for the period
      - name: granularity
        in: query
        required: false
        schema:
          type: string
          description: 'Time granularity: ''day'', ''week'', or ''month'''
          default: day
          title: Granularity
        description: 'Time granularity: ''day'', ''week'', or ''month'''
      - name: workspace_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Filter by workspace ID
          title: Workspace Id
        description: Filter by workspace ID
      - name: navigationSource
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Navigationsource
      - name: x-tenant
        in: header
        required: true
        schema:
          type: string
          title: X-Tenant
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CostTrendsResponse'
        '403':
          description: Not authorized
        '404':
          description: No ClickHouse database configured
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/databricks/cost/trends/by-product:
    get:
      tags:
      - DATABRICKS
      summary: Get Databricks cost trends by product over time
      description: 'Get cost trends over time, sliced for a UI category.


        Returns time series data with DBU consumption and estimated cost per

        period, with each row labelled by the category''s chosen segment. The

        ``products`` array in the response is the canonical legend for the

        category (in display order, including segments with no data) so the FE

        legend stays stable across date ranges.'
      operationId: get_cost_trends_by_product_api_v1_databricks_cost_trends_by_product_get
      security:
      - HTTPBearer: []
      - HTTPBearer: []
      parameters:
      - name: start_date
        in: query
        required: true
        schema:
          type: string
          format: date
          description: Start date for the period
          title: Start Date
        description: Start date for the period
      - name: end_date
        in: query
        required: false
        schema:
          type: string
          format: date
          description: End date for the period
          title: End Date
        description: End date for the period
      - name: granularity
        in: query
        required: false
        schema:
          type: string
          description: 'Time granularity: ''day'', ''week'', or ''month'''
          default: day
          title: Granularity
        description: 'Time granularity: ''day'', ''week'', or ''month'''
      - name: workspace_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Filter by workspace ID
          title: Workspace Id
        description: Filter by workspace ID
      - name: category
        in: query
        required: false
        schema:
          $ref: '#/components/schemas/CategoryName'
          description: Which UI category the chart is for. Drives both the product filter and the per-row segment label. ``total`` returns the 5 spec-group stack (Clusters / SQL Warehouse / AI/ML / Lakehouse / Platform). ``sql_warehouse`` returns Classic / Pro / Serverless. Other values return the products in that spec group.
          default: total
        description: Which UI category the chart is for. Drives both the product filter and the per-row segment label. ``total`` returns the 5 spec-group stack (Clusters / SQL Warehouse / AI/ML / Lakehouse / Platform). ``sql_warehouse`` returns Classic / Pro / Serverless. Other values return the products in that spec group.
      - name: navigationSource
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Navigationsource
      - name: x-tenant
        in: header
        required: true
        schema:
          type: string
          title: X-Tenant
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductTrendsResponse'
        '403':
          description: Not authorized
        '404':
          description: No ClickHouse database configured
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/databricks/cost/trends/by-product/estimate:
    get:
      tags:
      - DATABRICKS
      summary: Get Databricks cost trends by product with projections
      description: 'Get cost trends by product with future projections.


        Returns monthly cost data by product (JOBS, SQL, ALL_PURPOSE, etc.) with

        projections to end of period. Used for Future State visualization showing

        product-level historical + projected costs.'
      operationId: get_cost_trends_by_product_estimate_api_v1_databricks_cost_trends_by_product_estimate_get
      security:
      - HTTPBearer: []
      - HTTPBearer: []
      parameters:
      - name: start_date
        in: query
        required: true
        schema:
          type: string
          format: date
          description: Start date (typically start of year)
          title: Start Date
        description: Start date (typically start of year)
      - name: end_date
        in: query
        required: true
        schema:
          type: string
          format: date
          description: End date (typically end of year)
          title: End Date
        description: End date (typically end of year)
      - name: workspace_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Filter by workspace ID
          title: Workspace Id
        description: Filter by workspace ID
      - name: navigationSource
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Navigationsource
      - name: x-tenant
        in: header
        required: true
        schema:
          type: string
          title: X-Tenant
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductEstimateTrendsResponse'
        '403':
          description: Not authorized
        '404':
          description: No ClickHouse database configured
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/databricks/cost/breakdown/sku:
    get:
      tags:
      - DATABRICKS
      summary: Get cost breakdown by SKU
      description: 'Get cost breakdown by SKU.


        Returns DBU consumption and cost grouped by Databricks SKU type.'
      operationId: get_cost_breakdown_by_sku_api_v1_databricks_cost_breakdown_sku_get
      security:
      - HTTPBearer: []
      - HTTPBearer: []
      parameters:
      - name: start_date
        in: query
        required: true
        schema:
          type: string
          format: date
          description: Start date for the period
          title: Start Date
        description: Start date for the period
      - name: end_date
        in: query
        required: false
        schema:
          type: string
          format: date
          description: End date for the period
          title: End Date
        description: End date for the period
      - name: workspace_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Filter by workspace ID
          title: Workspace Id
        description: Filter by workspace ID
      - name: sortAttribute
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'Sort column: name, total_dbus, or total_cost. Default total_cost.'
          title: Sortattribute
        description: 'Sort column: name, total_dbus, or total_cost. Default total_cost.'
      - name: sortOrder
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'Sort direction: ''asc'' or ''desc''. Default ''desc''.'
          title: Sortorder
        description: 'Sort direction: ''asc'' or ''desc''. Default ''desc''.'
      - name: sku_names
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
          - type: 'null'
          description: Filter to specific SKU names (multi-value)
          title: Sku Names
        description: Filter to specific SKU names (multi-value)
      - name: navigationSource
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Navigationsource
      - name: x-tenant
        in: header
        required: true
        schema:
          type: string
          title: X-Tenant
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/app__schemas__databricks__cost__CostBreakdownResponse'
        '403':
          description: Not authorized
        '404':
          description: No ClickHouse database configured
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/databricks/cost/breakdown/workspace:
    get:
      tags:
      - DATABRICKS
      summary: Get cost breakdown by workspace
      description: 'Get cost breakdown by workspace.


        Returns DBU consumption and cost grouped by Databricks workspace.'
      operationId: get_cost_breakdown_by_workspace_api_v1_databricks_cost_breakdown_workspace_get
      security:
      - HTTPBearer: []
      - HTTPBearer: []
      parameters:
      - name: start_date
        in: query
        required: true
        schema:
          type: string
          format: date
          description: Start date for the period
          title: Start Date
        description: Start date for the period
      - name: end_date
        in: query
        required: false
        schema:
          type: string
          format: date
          description: End date for the period
          title: End Date
        description: End date for the period
      - name: navigationSource
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Navigationsource
      - name: x-tenant
        in: header
        required: true
        schema:
          type: string
          title: X-Tenant
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/app__schemas__databricks__cost__CostBreakdownResponse'
        '403':
          description: Not authorized
        '404':
          description: No ClickHouse database configured
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/databricks/cost/breakdown/product:
    get:
      tags:
      - DATABRICKS
      summary: Get cost breakdown by product
      description: 'Get cost breakdown by product.


        Returns DBU consumption and cost grouped by Databricks product type.'
      operationId: get_cost_breakdown_by_product_api_v1_databricks_cost_breakdown_product_get
      security:
      - HTTPBearer: []
      - HTTPBearer: []
      parameters:
      - name: start_date
        in: query
        required: true
        schema:
          type: string
          format: date
          description: Start date for the period
          title: Start Date
        description: Start date for the period
      - name: end_date
        in: query
        required: false
        schema:
          type: string
          format: date
          description: End date for the period
          title: End Date
        description: End date for the period
      - name: workspace_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Filter by workspace ID
          title: Workspace Id
        description: Filter by workspace ID
      - name: sortAttribute
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'Sort column: name, total_dbus, or total_cost. Default total_cost.'
          title: Sortattribute
        description: 'Sort column: name, total_dbus, or total_cost. Default total_cost.'
      - name: sortOrder
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'Sort direction: ''asc'' or ''desc''. Default ''desc''.'
          title: Sortorder
        description: 'Sort direction: ''asc'' or ''desc''. Default ''desc''.'
      - name: products
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
          - type: 'null'
          description: Filter to specific billing_origin_product values
          title: Products
        description: Filter to specific billing_origin_product values
      - name: navigationSource
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Navigationsource
      - name: x-tenant
        in: header
        required: true
        schema:
          type: string
          title: X-Tenant
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/app__schemas__databricks__cost__CostBreakdownResponse'
        '403':
          description: Not authorized
        '404':
          description: No ClickHouse database configured
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/databricks/cost/comparison:
    get:
      tags:
      - DATABRICKS
      summary: Get cost comparison between periods
      description: 'Get cost comparison between current and previous period.


        Automatically calculates the previous period based on the duration of the current period.'
      operationId: get_cost_comparison_api_v1_databricks_cost_comparison_get
      security:
      - HTTPBearer: []
      - HTTPBearer: []
      parameters:
      - name: start_date
        in: query
        required: true
        schema:
          type: string
          format: date
          description: Start date for the current period
          title: Start Date
        description: Start date for the current period
      - name: end_date
        in: query
        required: false
        schema:
          type: string
          format: date
          description: End date for the current period
          title: End Date
        description: End date for the current period
      - name: workspace_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Filter by workspace ID
          title: Workspace Id
        description: Filter by workspace ID
      - name: navigationSource
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Navigationsource
      - name: x-tenant
        in: header
        required: true
        schema:
          type: string
          title: X-Tenant
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CostComparisonResponse'
        '403':
          description: Not authorized
        '404':
          description: No ClickHouse database configured
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/databricks/cost/total:
    get:
      tags:
      - DATABRICKS
      summary: Get total cost with category breakdown
      description: 'Get total cost with category breakdown.


        Returns total cost and DBUs with breakdown by cost category

        (Compute, SQL, AI/ML, Data Platform, Infrastructure).'
      operationId: get_cost_total_api_v1_databricks_cost_total_get
      security:
      - HTTPBearer: []
      - HTTPBearer: []
      parameters:
      - name: start_date
        in: query
        required: true
        schema:
          type: string
          format: date
          description: Start date for the period
          title: Start Date
        description: Start date for the period
      - name: end_date
        in: query
        required: false
        schema:
          type: string
          format: date
          description: End date for the period
          title: End Date
        description: End date for the period
      - name: workspace_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Filter by workspace ID
          title: Workspace Id
        description: Filter by workspace ID
      - name: navigationSource
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Navigationsource
      - name: x-tenant
        in: header
        required: true
        schema:
          type: string
          title: X-Tenant
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CostTotalResponse'
        '403':
          description: Not authorized
        '404':
          description: No ClickHouse database configured
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/databricks/cost/overall/estimate:
    get:
      tags:
      - DATABRICKS
      summary: Get cost trends with future projections
      description: 'Get cost trends with future projections, segmented for a UI category.


        Returns monthly cost data with projections to end of period — each graph

        point carries the per-segment breakdown for the requested ``category``.

        Used for Future State visualization showing historical + projected costs.'
      operationId: get_cost_trends_estimate_api_v1_databricks_cost_overall_estimate_get
      security:
      - HTTPBearer: []
      - HTTPBearer: []
      parameters:
      - name: start_date
        in: query
        required: true
        schema:
          type: string
          format: date
          description: Start date (typically start of year)
          title: Start Date
        description: Start date (typically start of year)
      - name: end_date
        in: query
        required: true
        schema:
          type: string
          format: date
          description: End date (typically end of year)
          title: End Date
        description: End date (typically end of year)
      - name: workspace_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Filter by workspace ID
          title: Workspace Id
        description: Filter by workspace ID
      - name: category
        in: query
        required: false
        schema:
          $ref: '#/components/schemas/CategoryName'
          description: Which UI category to segment the projection by. ``total`` → the 6 spec groups; ``sql_warehouse`` → Classic / Pro / Serverless; other values → the products of that spec group. Mirrors ``/cost/trends/by-product``.
          default: total
        description: Which UI category to segment the projection by. ``total`` → the 6 spec groups; ``sql_warehouse`` → Classic / Pro / Serverless; other values → the products of that spec group. Mirrors ``/cost/trends/by-product``.
      - name: navigationSource
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Navigationsource
      - name: x-tenant
        in: header
        required: true
        schema:
          type: string
          title: X-Tenant
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CostEstimateTrendsResponse'
        '403':
          description: Not authorized
        '404':
          description: No ClickHouse database configured
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/databricks/cost/total/estimate:
    get:
      tags:
      - DATABRICKS
      summary: Get total estimated cost for the year
      description: 'Get total estimated cost for the period (actual + projected).


        Returns the grand total plus a per-segment breakdown for the requested

        ``category``. Used for Future State total cost display.'
      operationId: get_cost_total_estimate_api_v1_databricks_cost_total_estimate_get
      security:
      - HTTPBearer: []
      - HTTPBearer: []
      parameters:
      - name: start_date
        in: query
        required: true
        schema:
          type: string
          format: date
          description: Start date (typically start of year)
          title: Start Date
        description: Start date (typically start of year)
      - name: end_date
        in: query
        required: true
        schema:
          type: string
          format: date
          description: End date (typically end of year)
          title: End Date
        description: End date (typically end of year)
      - name: workspace_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Filter by workspace ID
          title: Workspace Id
        description: Filter by workspace ID
      - name: category
        in: query
        required: false
        schema:
          $ref: '#/components/schemas/CategoryName'
          description: Which UI category to segment the estimate by. See ``/cost/overall/estimate`` for the segmentation rules.
          default: total
        description: Which UI category to segment the estimate by. See ``/cost/overall/estimate`` for the segmentation rules.
      - name: navigationSource
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Navigationsource
      - name: x-tenant
        in: header
        required: true
        schema:
          type: string
          title: X-Tenant
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CostTotalEstimateResponse'
        '403':
          description: Not authorized
        '404':
          description: No ClickHouse database configured
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/databricks/cost/compute-efficiency:
    get:
      tags:
      - DATABRICKS
      summary: Get compute efficiency breakdown
      description: 'Get compute efficiency breakdown.


        Returns efficiency metrics including:

        - Jobs vs All-Purpose ratio (healthy = >70% jobs)

        - Serverless vs Provisioned breakdown

        - Photon vs Standard engine usage'
      operationId: get_compute_efficiency_api_v1_databricks_cost_compute_efficiency_get
      security:
      - HTTPBearer: []
      - HTTPBearer: []
      parameters:
      - name: start_date
        in: query
        required: true
        schema:
          type: string
          format: date
          description: Start date for the period
          title: Start Date
        description: Start date for the period
      - name: end_date
        in: query
        required: false
        schema:
          type: string
          format: date
          description: End date for the period
          title: End Date
        description: End date for the period
      - name: workspace_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Filter by workspace ID
          title: Workspace Id
        description: Filter 

# --- truncated at 32 KB (569 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/altimate-ai/refs/heads/main/openapi/altimate-ai-databricks-api-openapi.yml