v2

latestOpenAPI 3.0.3Apache-2.02026-08-07119359591.9 KB

Spaces

Create a space

Create a new space within an organization.

Payload Requirements

name and organization_id are required.
The space name must be unique within the organization.
description is optional and defaults to an empty string if omitted.
System-managed fields (id, created_at) are generated automatically and rejected if provided.

<Note>This endpoint is in beta, read more here.</Note>

post/v2/spaces

Request body

namestring required

Name of the space (must be unique within the organization)

organization_idstring required

A universally unique identifier (base64-encoded opaque string).

descriptionstring

A brief description of the space's purpose. Defaults to an empty string if omitted.

is_privateboolean

Whether to create the space as private. Private spaces are only visible to their members and account/org/space admins. Defaults to false (public) if omitted.

Example request

{
  "organization_id": "RW50aXR5OjEyMzQ1"
}

Response

A space object

idstring required

Unique identifier for the space

namestring required

Name of the space

descriptionstring required

A brief description of the space's purpose

created_atstring date-time required

Timestamp for when the space was created

is_privateboolean required

Whether the space is private. Private spaces are only visible to their members and account/org/space admins.