Skip to content

Create Space

POST
/spaces

Creates a new Space (tenant boundary). The authenticated user becomes the Owner. Each user can own at most one Space. A free-tier subscription is automatically provisioned on creation. If subscription provisioning fails, the Space creation is rolled back.

X-Space-Id
required
string format: uuid

UUID of the target Space (tenant boundary). Validated against user access.

object
name
required

Name of the new Space

string
Example
Rome North Site
object
id
required

Space ID

string format: uuid
Example
550e8400-e29b-41d4-a716-446655440000
name
required

Space name

string
Example
Rome North Site
status
required

Space status

string
Allowed values: active deleted
Example
active

Unauthorized — missing or invalid JWT

Forbidden — insufficient permissions

Validation failed — invalid input