Sign in
Workspaces

Create a workspace and bootstrap its first owner

The workspace and creator membership are persisted atomically. Replaying the same idempotency key and normalized request returns the original result.

post/api/workspaces

Headers

Idempotency-Keystring required

Caller-generated key used to replay a mutation safely.

Request body

namestring required
descriptionstring

Response

Workspace created, or the original creation response replayed

idstring required

Opaque resource identifier. Clients must compare it only as a string.

namestring required
descriptionstring
role'owner' | 'admin' | 'member' required

Fixed base role. Custom roles are not part of the Beta workspace contract.

createdAtstring date-time required

UTC RFC 3339 timestamp. Writers emit a trailing Z.

updatedAtstring date-time required

UTC RFC 3339 timestamp. Writers emit a trailing Z.

Example response

{
  "createdAt": "2026-08-18T12:00:00Z",
  "updatedAt": "2026-08-18T12:00:00Z"
}

Changes

Changed in 1 of the 9 revisions of this API.1