---
title: "list all workspaces visible to me"
method: GET
path: "/workspaces/list"
tags: ["workspace"]
---

# list all workspaces visible to me

`GET /workspaces/list`

## Response `200`

all workspaces

- Workspace[]
  - `id` string, required
  - `name` string, required
  - `owner` string, required
  - `domain` string
  - `color` string
  - `parent_workspace_id` string, nullable
  - `deleted` boolean — Archived (soft-deleted) workspace
  - `is_dev_workspace` boolean
  - `dev_workspace_label` string, nullable — Environment label of the dev workspace, e.g. 'dev' or 'staging'; null defaults to 'dev'

## Changes

> 176 revisions in range; 2 could not be searched.

- **2026-08-03** `d64d91d392b3` — 3 info
  - added the optional property `items/deleted` to the response with the `200` status
  - added the optional property `items/dev_workspace_label` to the response with the `200` status
  - added the optional property `items/is_dev_workspace` to the response with the `200` status

[Change history](https://skmtc.dev/windmill/apis/windmill-api/changes/workspaces/list/get.md)

---

[API](https://skmtc.dev/windmill/apis/windmill-api.md) · [All operations](https://skmtc.dev/windmill/apis/windmill-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/windmill/windmill-api/revisions/7b281701c340/schema)