---
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`

## Request

- Base URL: `https://api.myaltimate.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.myaltimate.com/api/v1/databricks/connections/{connection_id}/workspaces`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

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

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

---

[API](https://skmtc.dev/myaltimate/apis/myaltimate-api.md) - [All operations](https://skmtc.dev/myaltimate/apis/myaltimate-api/llms.txt) - [OpenAPI document](https://skmtc.dev/myaltimate/apis/myaltimate-api/revisions/727657ce54e9?raw)