---
title: "POST /api/spaces"
method: POST
path: "/api/spaces"
tags: ["SpaceService"]
---

# POST /api/spaces

`POST /api/spaces`

## Request

- The document declares no server URL.
- Auth: none declared

CreateSpace creates a space and makes the authenticated caller its first
 administrator.

## Query parameters

- `spaceId` string

## Request body

- Space: Space is a collaboration boundary for placed memos.
  - `name` string: Identifier. The resource name of the space. Format: spaces/{space}
  - `title` string, required: Required. The human-readable title.
  - `description` string: Optional. A description of the space.
  - `icon` SpaceIcon: Icon is the display icon of a space.
    - `emoji` string: A Unicode emoji sequence.
    - `lucide` string: A canonical Lucide icon name, such as "leaf".
  - `currentUserRole` 'ROLE_UNSPECIFIED' | 'ADMIN' | 'USER', enum: Output only. The authenticated user's membership role in this space. ROLE_UNSPECIFIED when this space is exposed as metadata only.
  - `memberCount` integer: Output only. The number of accepted members in this space. Pending invitations are excluded. Zero when this space is exposed as metadata only.

## Response `200`

OK

- Space: Space is a collaboration boundary for placed memos.
  - `name` string: Identifier. The resource name of the space. Format: spaces/{space}
  - `title` string, required: Required. The human-readable title.
  - `description` string: Optional. A description of the space.
  - `icon` SpaceIcon: Icon is the display icon of a space.
    - `emoji` string: A Unicode emoji sequence.
    - `lucide` string: A canonical Lucide icon name, such as "leaf".
  - `currentUserRole` 'ROLE_UNSPECIFIED' | 'ADMIN' | 'USER', enum: Output only. The authenticated user's membership role in this space. ROLE_UNSPECIFIED when this space is exposed as metadata only.
  - `memberCount` integer: Output only. The number of accepted members in this space. Pending invitations are excluded. Zero when this space is exposed as metadata only.

## Other responses

- `default`: Default error response

## Changes

- **2026-10-08** `1846a777b0ef`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/usememos/apis/untitled-api/changes/api/spaces/post.md)

---

[API](https://skmtc.dev/usememos/apis/untitled-api.md) - [All operations](https://skmtc.dev/usememos/apis/untitled-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usememos/apis/untitled-api/revisions/f587355e35b4?raw)