---
title: "List Workspaces"
method: GET
path: "/v1/workspaces"
tags: ["workspace"]
---

# List Workspaces

`GET /v1/workspaces`

## Response `200`

Successful Response

- ListWorkspacesResponse — Response containing the organization's workspace when provisioned.
  - `workspaces` WorkspaceOutput[] — The singleton workspace, or empty before it has been provisioned.
    - `name` string, required — Resource name in the form `workspaces/{workspace}`.
    - `sqlDefaults` SqlDefaults, required — Default SQL names used when a query omits qualifiers.
      - `defaultCatalog` string, required — Catalog selected when SQL omits the catalog qualifier.
      - `defaultSchema` string, required — Schema selected when SQL omits the schema qualifier.
    - `revision` string — Monotonically increasing version of the complete workspace state.
    - `createTime` string, nullable — Time at which the workspace was created.
    - `updateTime` string, nullable — Time at which the workspace was most recently updated.
  - `nextPageToken` string — Always empty while workspaces are singleton resources.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/outerproduct/apis/outerproduct-api.md) · [All operations](https://skmtc.net/outerproduct/apis/outerproduct-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/outerproduct/outerproduct-api/revisions/6c6e81fb3282/schema)