USusememos
SpaceService

POST /api/spaces

Changed on

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

Request

  • The document declares no server URL.
  • Auth
    none declared

Query parameters

spaceIdstring

Optional. The ID to use for the space, which becomes the final segment of its resource name. If empty, a UUID v4 is generated. Must match ^a-zA-Z0-9?$.

Request body

namestring

Identifier. The resource name of the space. Format: spaces/{space}

titlestring required

Required. The human-readable title.

descriptionstring

Optional. A description of the space.

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.

memberCountinteger

Output only. The number of accepted members in this space. Pending invitations are excluded. Zero when this space is exposed as metadata only.

Response

OK

namestring

Identifier. The resource name of the space. Format: spaces/{space}

titlestring required

Required. The human-readable title.

descriptionstring

Optional. A description of the space.

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.

memberCountinteger

Output only. The number of accepted members in this space. Pending invitations are excluded. Zero when this space is exposed as metadata only.

Changes