Skip to main content
POST
Start 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

Workspace ID.

Response

200 - application/json

OK

id
string
required
status
enum<string>
required

running while the server holds the workspace in memory; stopped while it keeps only its config and state, until a start.

Available options:
running,
stopped
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

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