{"openapi":"3.1.0","info":{"title":"Databricks Compute (BYOK) API","version":"0.1.0","description":"Databricks Compute (BYOK) lets an AI assistant read your own Databricks Compute data through the Databricks Compute API with a key you supply (personal access token). Read-only: 10 tools (get_cluster, list_instance_pools, get_instance_pool, list_node_types, list_spark_versions, list_availability_zones, list_policy_families, list_global_init_scripts, get_cluster_library_status,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-databricks-compute.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-databricks-compute/docs"},"termsOfService":"https://connectorbay.com/byok-databricks-compute/terms"},"servers":[{"url":"https://byok-databricks-compute.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-databricks-compute/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_cluster":{"post":{"operationId":"get_cluster","summary":"Get one cluster: state and message, Spark runtime, node types, worker count or autoscale, auto-termination, access mode,","description":"Get one cluster: state and message, Spark runtime, node types, worker count or autoscale, auto-termination, access mode, policy, creator and start time. Spark settings and environment variables are not returned. Use for \"Why is Databricks cluster 0101-120000-abcd1234 terminated\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"workspace":{"description":"Your AWS Databricks workspace host label: the part before .cloud.databricks.com, for example dbc-a1b2c3d4-e5f6.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Workspace","type":"string"},"cluster_id":{"description":"Id of the cluster.","maxLength":200,"title":"Cluster Id","type":"string"}},"required":["workspace","cluster_id"],"title":"get_clusterArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_instance_pools":{"post":{"operationId":"list_instance_pools","summary":"List instance pools with node type, minimum idle and maximum capacity, idle auto-termination, state and usage counts. Us","description":"List instance pools with node type, minimum idle and maximum capacity, idle auto-termination, state and usage counts. Use for \"Which Databricks instance pools do we have and how many instances are idle\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"workspace":{"description":"Your AWS Databricks workspace host label: the part before .cloud.databricks.com, for example dbc-a1b2c3d4-e5f6.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Workspace","type":"string"}},"required":["workspace"],"title":"list_instance_poolsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_instance_pool":{"post":{"operationId":"get_instance_pool","summary":"Get one instance pool: node type, capacity limits, idle auto-termination, state, usage counts and preloaded runtimes. Us","description":"Get one instance pool: node type, capacity limits, idle auto-termination, state, usage counts and preloaded runtimes. Use for \"Show details of Databricks instance pool 0101-120000-pool123\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"workspace":{"description":"Your AWS Databricks workspace host label: the part before .cloud.databricks.com, for example dbc-a1b2c3d4-e5f6.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Workspace","type":"string"},"instance_pool_id":{"description":"Id of the instance pool.","maxLength":200,"title":"Instance Pool Id","type":"string"}},"required":["workspace","instance_pool_id"],"title":"get_instance_poolArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_node_types":{"post":{"operationId":"list_node_types","summary":"List the node types (instance types) that clusters can use: cores, memory, GPUs, category and Photon support. Use for \"W","description":"List the node types (instance types) that clusters can use: cores, memory, GPUs, category and Photon support. Use for \"Which node types can I use for Databricks clusters\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"workspace":{"description":"Your AWS Databricks workspace host label: the part before .cloud.databricks.com, for example dbc-a1b2c3d4-e5f6.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Workspace","type":"string"}},"required":["workspace"],"title":"list_node_typesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_spark_versions":{"post":{"operationId":"list_spark_versions","summary":"List the Databricks Runtime versions available for clusters, with the key to use and the display name. Use for \"Which Da","description":"List the Databricks Runtime versions available for clusters, with the key to use and the display name. Use for \"Which Databricks runtime versions are available\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"workspace":{"description":"Your AWS Databricks workspace host label: the part before .cloud.databricks.com, for example dbc-a1b2c3d4-e5f6.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Workspace","type":"string"}},"required":["workspace"],"title":"list_spark_versionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_availability_zones":{"post":{"operationId":"list_availability_zones","summary":"List the availability zones clusters can be created in and the workspace default zone. Use for \"Which availability zones","description":"List the availability zones clusters can be created in and the workspace default zone. Use for \"Which availability zones can my Databricks clusters use\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"workspace":{"description":"Your AWS Databricks workspace host label: the part before .cloud.databricks.com, for example dbc-a1b2c3d4-e5f6.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Workspace","type":"string"}},"required":["workspace"],"title":"list_availability_zonesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_policy_families":{"post":{"operationId":"list_policy_families","summary":"List the Databricks-provided cluster policy families (templates for cluster policies) with name and description. The def","description":"List the Databricks-provided cluster policy families (templates for cluster policies) with name and description. The definition JSON is not returned. Use for \"Which cluster policy families does Databricks offer\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"workspace":{"description":"Your AWS Databricks workspace host label: the part before .cloud.databricks.com, for example dbc-a1b2c3d4-e5f6.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Workspace","type":"string"},"max_results":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Maximum families per page.","title":"Max Results"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Token from next_page_token of the previous answer.","title":"Page Token"}},"required":["workspace"],"title":"list_policy_familiesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_global_init_scripts":{"post":{"operationId":"list_global_init_scripts","summary":"List workspace-wide init scripts with name, enabled flag, run position, creator and timestamps. Script bodies are not re","description":"List workspace-wide init scripts with name, enabled flag, run position, creator and timestamps. Script bodies are not returned. Use for \"Which global init scripts run on my Databricks clusters\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"workspace":{"description":"Your AWS Databricks workspace host label: the part before .cloud.databricks.com, for example dbc-a1b2c3d4-e5f6.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Workspace","type":"string"}},"required":["workspace"],"title":"list_global_init_scriptsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_cluster_library_status":{"post":{"operationId":"get_cluster_library_status","summary":"List the libraries installed or being installed on one cluster with install status and messages. Use for \"Which librarie","description":"List the libraries installed or being installed on one cluster with install status and messages. Use for \"Which libraries are installed on Databricks cluster 0101-120000-abcd1234\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"workspace":{"description":"Your AWS Databricks workspace host label: the part before .cloud.databricks.com, for example dbc-a1b2c3d4-e5f6.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Workspace","type":"string"},"cluster_id":{"description":"Id of the cluster.","maxLength":200,"title":"Cluster Id","type":"string"}},"required":["workspace","cluster_id"],"title":"get_cluster_library_statusArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_all_cluster_library_statuses":{"post":{"operationId":"list_all_cluster_library_statuses","summary":"List library install status for every cluster of the workspace. Use for \"Which clusters have failed library installs in ","description":"List library install status for every cluster of the workspace. Use for \"Which clusters have failed library installs in Databricks\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"workspace":{"description":"Your AWS Databricks workspace host label: the part before .cloud.databricks.com, for example dbc-a1b2c3d4-e5f6.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Workspace","type":"string"}},"required":["workspace"],"title":"list_all_cluster_library_statusesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}