---
title: "List spaces"
method: GET
path: "/api/w/{wId}/spaces"
tags: ["Private Spaces"]
---

# List spaces

`GET /api/w/{wId}/spaces`

Returns all spaces in the workspace.

## Path parameters

- `wId` string, required

## Query parameters

- `role` string
- `kind` string

## Response `200`

Success

- object
  - `spaces` union[]
    - union
      - PrivateSpace — A space in the workspace.
        - `sId` string, required
        - `name` string, required
        - `kind` 'global' | 'system' | 'conversations' | 'regular' | 'project', required
        - `groupIds` string[], required
        - `isRestricted` boolean, required
        - `managementMode` 'manual' | 'group', required
        - `createdAt` integer
        - `updatedAt` integer
      - PrivateProject — A space in the workspace.
        - `sId` string, required
        - `name` string, required
        - `kind` 'global' | 'system' | 'conversations' | 'regular' | 'project', required
        - `groupIds` string[], required
        - `isRestricted` boolean, required
        - `managementMode` 'manual' | 'group', required
        - `createdAt` integer
        - `updatedAt` integer
        - `description` string, nullable
        - `isMember` boolean
        - `archivedAt` integer, nullable
        - `todoGenerationEnabled` boolean — Whether automatic todo suggestions from project activity are enabled.
        - `lastTodoAnalysisAt` integer, nullable — Unix timestamp (ms) of the last automatic todo suggestion scan, if any.
        - `pinnedFramePath` string, nullable — Scoped path to the frame file pinned as the Pod banner (e.g. project/banner.html).

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.dev/dust-tt/apis/dust-api-documentation.md) · [All operations](https://skmtc.dev/dust-tt/apis/dust-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dust-tt/dust-api-documentation/revisions/2ee8d748e4e5/schema)