SaaS APIworkspaces

Create workspace

View as Markdown

Create a new workspace. Multiple workspaces per user are allowed; each has its own subscription. Returns 201 with workspace detail.

Headers

AuthorizationstringRequired

Bearer {access_token}

Request

name (required), slug (optional), billingEmail (optional), tier (optional: pro|team for 14-day trial)

billingEmailstringOptional
namestringOptional
slugstringOptional
tierstringOptional

Tier is optional: “pro” or “team” → 14-day trial; empty/“free” → free/active. Enterprise is NOT allowed via tier (use type=“enterprise” instead).

typestringOptional

Type is optional: “personal” (default) or “enterprise”. Use json:“type” (not omitempty) so request bodies always bind “type” reliably across JSON decoders.

Response

data: created workspace (id, name, slug, type, ownerId, logoUrl, billingEmail, settings, createdAt, updatedAt)

Errors

401
Unauthorized Error
409
Conflict Error
422
Unprocessable Entity Error