Skip to main content
Create a workspace

Authorizations

Authorization
string
header
required

The server's token (MIRAGE_AUTH_TOKEN) or a JWT. A daemon in the default local mode with no token accepts requests without one.

Query Parameters

explain
boolean
default:false

Return what the call would do without running it.

Body

application/json

A workspace to create: from config, or from the saved template of that name, never both.

config
WorkspaceConfig · object | null
template
string | null
id
string | null

Response

An identical retry answers the existing workspace; with explain=true, what the server's policies say about the config

id
string
required
mode
string
required
created_at
number
required
fuse_mountpoints
Fuse Mountpoints · object
system_time
string | null
sessions
SessionSummary · object[]
mounts
MountSummary · object[]
internals
WorkspaceInternals · object | null