---
title: "List the workspaces under this connection's account"
method: GET
path: "/api/v1/databricks/connections/{connection_id}/workspaces"
tags: ["DATABRICKS", "Databricks", "Databricks Connections"]
---

# List the workspaces under this connection's account

`GET /api/v1/databricks/connections/{connection_id}/workspaces`

Workspaces belonging to the account this connection authenticates against.

Read from the ClickHouse workspace inventory, scoped to this connection's
account and, by default, to the workspaces we actually ingest from. RBAC
additionally scopes the result to the caller's granted workspaces, so
``scope=account`` cannot be used to enumerate workspaces the caller's group
was never granted.

## Path parameters

- `connection_id` integer, required

## Query parameters

- `scope` 'onboarded' | 'account' — 'onboarded' (default): RUNNING workspaces we hold data for — what the connections page means by connected. 'account': the raw Databricks account inventory, including workspaces nobody granted us access to and ones since BANNED — for an onboarding picker, not a status panel.
- `navigationSource` string, nullable

## Headers

- `x-tenant` string, required

## Response `200`

Successful Response

- DatabricksWorkspaceOption[]
  - `workspace_id` string, required
  - `workspace_name` string, required
  - `workspace_url` string, nullable
  - `status` string, nullable

## Other responses

- `404` — Connection not found, or it has no resolved account
- `422` — Validation Error

## Changes

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

[Change history](https://skmtc.dev/myaltimate/apis/fastapi/changes/api/v1/databricks/connections/:connection_id/workspaces/get.md)

---

[API](https://skmtc.dev/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.dev/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/myaltimate/fastapi/revisions/fcb62c79da95/schema)