---
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
  - `managementMode` 'manual' | 'group', required
  - `memberIds` string[] — Required when managementMode is manual
  - `groupIds` string[] — Required when managementMode is group

## 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
    - `groupIds` string[], required
    - `isRestricted` boolean, required
    - `managementMode` 'manual' | 'group', required
    - `createdAt` integer
    - `updatedAt` integer

## Other responses

- `401` — Unauthorized

---

[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/5fb378acc79f/schema)