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

# List available spaces.

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

Retrieves a list of accessible spaces for the authenticated workspace.

## Path parameters

- `wId` string, required

## Query parameters

- `kinds` string

## Response `200`

Spaces of the workspace

- object
  - `spaces` Space[]
    - `sId` string — Unique string identifier for the space
    - `name` string — Name of the space
    - `kind` 'regular' | 'global' | 'system' | 'public' — The kind of the space
    - `groupIds` string[] — List of group IDs that have access to the space

## Other responses

- `400` — Bad Request. Missing or invalid parameters.
- `401` — Unauthorized. Invalid or missing authentication token.
- `404` — Workspace not found.
- `500` — Internal Server Error.

---

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