Skip to main content
POST
Start a workspace
See error examples and recovery steps. The complete OpenAPI contract includes every response schema.

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.

Path Parameters

workspace_id
string
required

The workspace's id.

Response

200 - application/json

OK

id
string
required
mode
string
required
created_at
number
required

Creation time as Unix seconds. For example, 1794009600 is 2026-11-07T00:00:00Z. Fractional values include sub-second precision.

Example:

1794009600

fuse_mountpoints
Fuse Mountpoints · object
system_time
string | null
sessions
SessionSummary · object[]
mounts
MountSummary · object[]
internals
WorkspaceInternals · object | null