{"openapi":"3.1.0","info":{"title":"Databricks Workspace (BYOK) API","version":"0.1.0","description":"Databricks Workspace (BYOK) lets an AI assistant read your own Databricks Workspace data through the Databricks Workspace API with a key you supply (personal access token). Read-only: 12 tools (list_clusters, list_cluster_policies, list_jobs, list_job_runs, list_sql_warehouses, list_pipelines, list_catalogs, list_schemas, list_tables, list_workspace_objects, list_repos, list_serving_endpoints)....\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-databricks-workspace.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-databricks-workspace/docs"},"termsOfService":"https://connectorbay.com/byok-databricks-workspace/terms"},"servers":[{"url":"https://byok-databricks-workspace.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-databricks-workspace/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/list_clusters":{"post":{"operationId":"list_clusters","summary":"List all-purpose and job clusters of the workspace with state, Spark version, node type, worker count, auto-termination ","description":"List all-purpose and job clusters of the workspace with state, Spark version, node type, worker count, auto-termination and creator. Cursor paginated. Use for \"Which Databricks clusters are running\".","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"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"Maximum clusters per page (1 to 100); the server may return fewer.","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Token from next_page_token of the previous answer; leave empty for the first page.","title":"Page Token"}},"required":["workspace"],"title":"list_clustersArguments","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_cluster_policies":{"post":{"operationId":"list_cluster_policies","summary":"List cluster policies with name, description, default flag, per-user cluster limit and creator; the policy definition JS","description":"List cluster policies with name, description, default flag, per-user cluster limit and creator; the policy definition JSON is not returned. Use for \"Which cluster policies exist in my Databricks workspace\".","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_cluster_policiesArguments","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_jobs":{"post":{"operationId":"list_jobs","summary":"List jobs with name, schedule, creator and creation time. Up to 100 per page, token paginated. Use for \"Which scheduled ","description":"List jobs with name, schedule, creator and creation time. Up to 100 per page, token paginated. Use for \"Which scheduled jobs does my Databricks workspace have\".","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"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Jobs per page (1 to 100, default 20).","title":"Limit"},"name":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only jobs whose name matches this text exactly (case-insensitive).","title":"Name"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Token from next_page_token of the previous answer; leave empty for the first page.","title":"Page Token"}},"required":["workspace"],"title":"list_jobsArguments","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_job_runs":{"post":{"operationId":"list_job_runs","summary":"List job runs, newest first, with run name, job, lifecycle and result state, start and end time, duration and trigger. U","description":"List job runs, newest first, with run name, job, lifecycle and result state, start and end time, duration and trigger. Up to 24 per page. Use for \"Which Databricks job runs failed recently\".","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"},"job_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only runs of this job ID.","title":"Job Id"},"active_only":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for runs that are queued, pending, running or terminating only.","title":"Active Only"},"completed_only":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for completed runs only (cannot be combined with active_only).","title":"Completed Only"},"limit":{"anyOf":[{"maximum":24,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Runs per page (1 to 24, default 20).","title":"Limit"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Token from next_page_token of the previous answer; leave empty for the first page.","title":"Page Token"}},"required":["workspace"],"title":"list_job_runsArguments","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_sql_warehouses":{"post":{"operationId":"list_sql_warehouses","summary":"List SQL warehouses with state, size, cluster limits, auto-stop minutes, type, serverless flag and active sessions. Use ","description":"List SQL warehouses with state, size, cluster limits, auto-stop minutes, type, serverless flag and active sessions. Use for \"Which SQL warehouses are running 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_sql_warehousesArguments","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_pipelines":{"post":{"operationId":"list_pipelines","summary":"List Lakeflow (Delta Live Tables) pipelines with state, health and creator. Up to 100 per page, token paginated. Use for","description":"List Lakeflow (Delta Live Tables) pipelines with state, health and creator. Up to 100 per page, token paginated. Use for \"Which Databricks pipelines are failing\".","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":"Pipelines per page (1 to 100, default 25).","title":"Max Results"},"filter":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Optional filter such as name LIKE '%sales%' or notebook='/Users/me/nb'.","title":"Filter"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Token from next_page_token of the previous answer; leave empty for the first page.","title":"Page Token"}},"required":["workspace"],"title":"list_pipelinesArguments","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_catalogs":{"post":{"operationId":"list_catalogs","summary":"List Unity Catalog catalogs with owner, comment, type and timestamps. Use for \"What Unity Catalog catalogs exist in my D","description":"List Unity Catalog catalogs with owner, comment, type and timestamps. Use for \"What Unity Catalog catalogs exist in my Databricks workspace\".","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":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"Catalogs per page (up to 1000).","title":"Max Results"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Token from next_page_token of the previous answer; leave empty for the first page.","title":"Page Token"}},"required":["workspace"],"title":"list_catalogsArguments","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_schemas":{"post":{"operationId":"list_schemas","summary":"List the Unity Catalog schemas of one catalog with owner, comment and timestamps. Use for \"Which schemas are in the main","description":"List the Unity Catalog schemas of one catalog with owner, comment and timestamps. Use for \"Which schemas are in the main catalog of 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"},"catalog_name":{"description":"Name of the parent catalog.","maxLength":255,"title":"Catalog Name","type":"string"},"max_results":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"Schemas per page (up to 1000).","title":"Max Results"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Token from next_page_token of the previous answer; leave empty for the first page.","title":"Page Token"}},"required":["workspace","catalog_name"],"title":"list_schemasArguments","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_tables":{"post":{"operationId":"list_tables","summary":"List the tables and views of one Unity Catalog schema with type, format, owner, comment and timestamps. Column lists and","description":"List the tables and views of one Unity Catalog schema with type, format, owner, comment and timestamps. Column lists and view SQL are not requested. Use for \"Which tables are in main.default 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"},"catalog_name":{"description":"Name of the parent catalog.","maxLength":255,"title":"Catalog Name","type":"string"},"schema_name":{"description":"Name of the parent schema.","maxLength":255,"title":"Schema Name","type":"string"},"max_results":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"Tables per page (up to 1000).","title":"Max Results"},"omit_columns":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":true,"description":"True to leave out column details (recommended).","title":"Omit Columns"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Token from next_page_token of the previous answer; leave empty for the first page.","title":"Page Token"}},"required":["workspace","catalog_name","schema_name"],"title":"list_tablesArguments","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_workspace_objects":{"post":{"operationId":"list_workspace_objects","summary":"List the notebooks, files and folders directly under a workspace path with type, language and modification time. Use for","description":"List the notebooks, files and folders directly under a workspace path with type, language and modification time. Use for \"What notebooks are in my Databricks home folder\".","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"},"path":{"description":"Absolute workspace path, for example /Users/me@example.com or /Shared.","maxLength":500,"title":"Path","type":"string"}},"required":["workspace","path"],"title":"list_workspace_objectsArguments","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_repos":{"post":{"operationId":"list_repos","summary":"List Git folders (repos) with path, Git provider, URL, branch and head commit. Use for \"Which Git repos are linked in my","description":"List Git folders (repos) with path, Git provider, URL, branch and head commit. Use for \"Which Git repos are linked in my Databricks workspace\".","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"},"path_prefix":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Only repos under this workspace path prefix.","title":"Path Prefix"},"next_page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Token from next_page_token of the previous answer.","title":"Next Page Token"}},"required":["workspace"],"title":"list_reposArguments","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_serving_endpoints":{"post":{"operationId":"list_serving_endpoints","summary":"List model serving endpoints with name, task, creator, readiness and timestamps. Use for \"Which model serving endpoints ","description":"List model serving endpoints with name, task, creator, readiness and timestamps. Use for \"Which model serving endpoints are ready 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_serving_endpointsArguments","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}}}}