workspaces

Create Workspace

View as Markdown

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
clone_fromstring or nullOptional
Optional source workspace selector to clone from.
imagestring or nullOptional

Optional OCI image pinned to this workspace (sandbox only).

namestring or nullOptional

Optional human-readable workspace name (slug). Auto-generated when omitted.

session_typeenum or nullOptional
Allowed values:
templateboolean or nullOptional
Mark this workspace as a reusable template.

Response

Workspace created
created_atstring
idstring
namestring

Human-readable workspace identifier (unique per user).

persistenceboolean
active_session_idstring or null

Active session id (best-effort based on stored state).

assistant_homeboolean or null
True when this workspace is the dedicated home workspace for a CHASM assistant.
github_repostring or null
imagestring or null

Optional OCI image pinned to this workspace (sandbox only).

last_session_idstring or null
Most recent session id recorded for this workspace.
node_endpointstring or null

Best-effort node endpoint where the workspace disk currently lives.

session_typestring or null
source_workspace_idstring or null
statusstring or null
templateboolean or null