---
title: "PATCH /api/spaces/{space}"
method: PATCH
path: "/api/spaces/{space}"
tags: ["SpaceService"]
---

# PATCH /api/spaces/{space}

`PATCH /api/spaces/{space}`

## Request

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

UpdateSpace updates space metadata. Only a space administrator can update
 a space.

## Path parameters

- `space` string, required

## Query parameters

- `updateMask` string, field-mask

## 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/:space/patch.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)
