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

# List workspaces

`GET /workspaces`

## Request

- Base URL: `https://api.vidmoat.com/v1`
- URL: `https://api.vidmoat.com/v1/workspaces`
- Auth: HTTP bearer

Every workspace you can see, personal and team, with how many projects are in each. Always one page (at most 60 per scope).

## Response `200`

List workspaces

- object
  - `data` object[]: Workspaces.
    - `id` string: Workspace id.
    - `name` string: Up to 48 characters.
    - `color` string, nullable: One of the palette colours.
    - `icon` string, nullable: An emoji.
    - `teamId` string, nullable: Set for a team workspace.
    - `projectCount` integer: Projects in it that you can see.
  - `hasMore` boolean: Always `false`.
  - `nextCursor` unknown

---

[API](https://skmtc.dev/vidmoat/apis/vidmoat-api.md) · [All operations](https://skmtc.dev/vidmoat/apis/vidmoat-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vidmoat/apis/vidmoat-api/revisions/23e24e25c756?raw)