Create the caller's first Workspace
Create the caller's first Workspace
/api/v1/workspaces/bootstrapCreates the first Workspace, owner membership, and Actor for a signed-in account that has no active Workspace memberships. The caller selects both the visible name and canonical URL segment.
Success rotates the account-only session into the new Workspace and
replaces both browser-session cookies. Concurrent requests are
serialized so at most one first Workspace is created for an account.
A caller that already has a Workspace receives 409 and must use the
normal session-switch operation instead.
Header Parameters
Request Body
Responses
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.
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.