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

# List workspaces

`GET /v2/workspaces`

## Request

- Base URL: `https://api.sigmacomputing.com`
- URL: `https://api.sigmacomputing.com/v2/workspaces`
- Auth: HTTP bearer

**Attention**: This endpoint will return only paginated responses starting June 2, 2026. To start returning paginated responses before that date, include the query parameter `limit` in your request.

  This endpoint returns a list of all workspaces. You can use pagination and optionally filter by name to manage large sets of data. See [Manage Workspaces](/docs/manage-workspaces) for more details about workspaces in Sigma.
  ### Usage notes
  - **Filtering by name**: Optionally, use the `name` parameter to filter workspaces by a case-insensitive substring match.
  - **Filtering by exact name**: Optionally, use the `exactName` parameter to filter workspaces by an exact name match (also case-insensitive). When provided, `exactName` takes precedence over `name` and uses an indexed equality lookup, which is significantly faster than substring search.

  ### Usage scenarios
  - **Pagination**: Use the `page` and `limit` parameters to control the size and segment of the workspace list returned.
  - **User interface display**: Populate a user interface with a list of all available workspaces, using pagination to efficiently load data and filtering to quickly find specific workspaces.
  - **Administrative overview**: Provide system administrators with an overview of all workspaces for management and monitoring purposes, with the ability to browse through pages and search by name.

  ### Best practices
  - Use caching to reduce load times and server demand when frequently accessing workspace lists.
  - Regularly update and synchronize workspace lists to ensure that displayed information is current and accurate.

## Query parameters

- `page` string
- `limit` number, double
- `name` string
- `exactName` string

## Response `200`

The response body.

- union
  - V2WorkspacesGetResponsesContentApplicationJsonSchemaOneOf0Items[]
    - `workspaceId` string, required
    - `workspaceUrlId` string, required: Base62-encoded identifier used in Sigma workspace URLs.
    - `name` string, required
    - `createdBy` string, required
    - `updatedBy` string, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - WorkspacesListWorkspacesResponse2001
    - `entries` V2WorkspacesGetResponsesContentApplicationJsonSchemaOneOf1EntriesItems[], required
      - `workspaceId` string, required
      - `workspaceUrlId` string, required: Base62-encoded identifier used in Sigma workspace URLs.
      - `name` string, required
      - `createdBy` string, required
      - `updatedBy` string, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
    - `nextPage` string, nullable, required

---

[API](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api.md) - [All operations](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/revisions/fb6036208c49?raw)