---
title: "Create a space"
method: POST
path: "/api/w/{wId}/spaces"
tags: ["Private Spaces"]
---

# Create a space

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

Creates a new space in the workspace.

## Path parameters

- `wId` string, required

## Request body

- object
  - `isRestricted` boolean, required
  - `name` string, required
  - `spaceKind` 'regular' | 'project', required
  - `memberIds` string[] — The space's manual member list. Omitted or empty means the space starts with no manual member.
  - `groupIds` string[] — The groups given access to the space. Omitted or empty means no group has access to it.
  - `managementMode` 'manual' | 'group' — Deprecated and ignored. A space's members are its manual member list plus the members of the groups given access to it.

## Response `201`

Successfully created space

- object
  - `space` PrivateSpace — A space in the workspace.
    - `sId` string, required
    - `name` string, required
    - `kind` 'global' | 'system' | 'conversations' | 'regular' | 'project', required
    - `managementMode` 'manual' | 'group', required — Deprecated. Derived from whether any group has access to the space; a space's members are its manual member list plus the members of those groups.
    - `createdAt` integer
    - `updatedAt` integer

## Other responses

- `401` — Unauthorized

## Changes

- **2026-09-08** `adca377e662d` — 1 info
  - the request property `managementMode` became optional
- **2026-08-26** `184ee47db4cc` — 1 breaking
  - removed the required property `space/isRestricted` from the response with the `201` status
- **2026-08-25** `916a8331ce55` — 1 breaking
  - removed the required property `space/groupIds` from the response with the `201` status

[Change history](https://skmtc.dev/dust-tt/apis/dust-api-documentation/changes/api/w/:wId/spaces/post.md)

---

[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.dev/dust-tt/apis/dust-api-documentation/revisions/c376d96c49a9?raw)