Skip to main content
POST
Create a workspace

Authorizations

Authorization
string
header
required

Send a dashboard session token, an account API key (agt_t), or a command-line credential (afc_) as a Bearer token. Each endpoint lists accepted credential types.

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

Account identifier assigned by the server to the new workspace.

workspace_id
string
required

The new workspace's identifier.