> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.select.dev/llms.txt > Use this file to discover all available pages before exploring further. # List Databricks workspaces > List the Databricks workspaces SELECT has seen activity in. Ordered by identifier. The response does not include a total row count. ## OpenAPI ````yaml https://api.select.dev/v2/openapi.json get /databricks-workspaces openapi: 3.1.0 info: title: SELECT API (v2) version: 0.1.0 servers: - url: https://api.select.dev/v2 description: SELECT API v2 security: [] paths: /databricks-workspaces: get: tags: - databricks-workspaces summary: List Databricks workspaces description: |- List the Databricks workspaces SELECT has seen activity in. Ordered by identifier. The response does not include a total row count. operationId: list_databricks_workspaces_route_databricks_workspaces_get parameters: - name: page_token in: query required: false schema: anyOf: - type: string - type: 'null' description: Opaque cursor from a previous response. Omit on the first call. title: Page Token description: Opaque cursor from a previous response. Omit on the first call. - name: max_results in: query required: false schema: type: integer default: 50 title: Max Results - name: databricks_account_id in: query required: false schema: anyOf: - type: string - type: 'null' title: Databricks Account Id - name: databricks_connection_id in: query required: false schema: anyOf: - type: string - type: 'null' title: Databricks Connection Id - name: x-tenant-id in: header required: true schema: type: string description: The organization ID the request is scoped to. title: X-Tenant-Id description: The organization ID the request is scoped to. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ListResponse_DatabricksWorkspace_' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '405': $ref: '#/components/responses/MethodNotAllowed' '408': $ref: '#/components/responses/RequestTimeout' '422': $ref: '#/components/responses/ValidationFailed' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' '503': $ref: '#/components/responses/ServiceUnavailable' security: - HTTPBearer: [] components: schemas: ListResponse_DatabricksWorkspace_: properties: items: items: $ref: '#/components/schemas/DatabricksWorkspace' type: array title: Items page_token: anyOf: - type: string - type: 'null' title: Page Token description: Opaque cursor for the next page; empty/absent on the last page. row_count: anyOf: - type: integer - type: 'null' title: Row Count description: >- Best-effort total for the filtered result set; may be null when expensive. type: object required: - items title: ListResponse[DatabricksWorkspace] DatabricksWorkspace: properties: id: type: string title: Id description: >- The unique identifier of the workspace — the workspace id Databricks itself assigns, which also appears in Databricks workspace URLs. readOnly: true x-terraform-computed: true name: anyOf: - type: string - type: 'null' title: Name description: >- Display name of the workspace as Databricks reports it. Null when Databricks has not reported one. readOnly: true x-terraform-computed: true url: type: string title: Url description: >- Base URL of the workspace, for example `https://my-workspace.cloud.databricks.com`. Use it to build links into Databricks for the jobs, clusters and SQL warehouses that ran in this workspace. readOnly: true x-terraform-computed: true databricks_account_id: type: string title: Databricks Account Id description: The Databricks account this workspace belongs to. readOnly: true x-terraform-computed: true databricks_connection_id: anyOf: - type: string - type: 'null' title: Databricks Connection Id description: >- Identifier of the Databricks connection SELECT discovered this workspace through (see `GET /v2/databricks-connections/{databricks_connection_id}`). Null when the workspace has been observed but not yet attributed to a connection. readOnly: true x-terraform-computed: true created_time: anyOf: - type: string - type: 'null' title: Created Time description: >- When the workspace was created in Databricks. Null when Databricks has not reported a creation time. readOnly: true x-terraform-computed: true type: object required: - id - url - databricks_account_id title: DatabricksWorkspace description: One Databricks workspace SELECT has seen activity in. ProblemDetail: additionalProperties: true description: >- RFC 9457-style error payload, served as ``application/problem+json``. ``code`` is the stable, machine-readable identifier — consumers branch on it, never on ``title``. ``type`` stays ``about:blank``: we keep no per-error documentation pages. There is no ``instance``/request-id member (we don't run access logs). See the flat error-code catalogue in §4 of the standards doc. properties: type: default: about:blank title: Type type: string title: type: string title: Title status: title: Status type: integer detail: title: Detail type: string code: title: Code type: string retryable: title: Retryable type: boolean details: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' default: null title: Details required: - title - status - detail - code - retryable title: ProblemDetail type: object responses: BadRequest: description: Bad request content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' Unauthorized: description: Unauthorized content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' headers: WWW-Authenticate: description: Authentication challenge for the requested resource. required: true schema: type: string Forbidden: description: Forbidden content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' NotFound: description: Not found content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' MethodNotAllowed: description: Method not allowed content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' headers: Allow: description: HTTP methods supported by the requested resource. required: true schema: type: string RequestTimeout: description: Request Timeout content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' ValidationFailed: description: Validation failed content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' RateLimited: description: Rate limited content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' headers: Retry-After: description: Number of seconds to wait before retrying the request. required: true schema: type: integer minimum: 0 InternalError: description: Internal error content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' ServiceUnavailable: description: Service unavailable content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' headers: Retry-After: description: Number of seconds to wait before retrying the request. required: true schema: type: integer minimum: 0 securitySchemes: HTTPBearer: type: http description: Organization API key (sl_…). scheme: bearer ````