Create a Workspace
Create a Workspace
/api/v1/workspacesClaims and creates the signed-in human account's one active Free Workspace, provisioning the Workspace, owner membership, Actor, default workflow, claim, and events in one transaction. Membership and role in the selected Workspace do not grant or deny this account-level command.
The optional slug selects the canonical URL segment. When omitted,
Core generates a collision-safe value from the name.
Creation does not switch the calling session onto the new
Workspace. Changing scope is PUT /api/v1/auth/session/workspace,
which always rotates the session and CSRF secrets; doing it as a side
effect here would rotate them invisibly.
Header Parameters
Request Body
Responses
stringQuoted decimal optimistic-concurrency version.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
stringServer-generated canonical Workspace URL segment. Authorized Workspace managers can change it through the revisioned Workspace update operation.
string <date-time>When set, the Workspace is archived: no data was deleted, every session scoped to it was revoked, and its scoped routes answer not-found for everyone but an owner.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.