Skip to main content
POST
Create a workspace

Authorizations

Authorization
string
header
required

Obtain a token via the CLI auth flow (POST /v1/auth/sessions) or GitHub OAuth

Body

application/json

POST /v1/workspaces — create one.

name
string | null

What the workspace will be called, when the caller cares.

Response

Created

What creating answers with.

name
string
required

Its name — echoed when chosen, revealed when generated.

request_id
string
required

The correlation token for this request, repeated in the body.

tenant_id
string
required

The tenant it was created in — the daemon's resolution, never a claim.

workspace_id
string
required

The new workspace's identifier.