Skip to main content
POST
Start workspace
Start the workspace using its saved configuration and retained state. The server checks policies and reloads credentials. If already running, return the existing workspace. RAM-backed files do not survive a stop/start cycle.
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
string<date-time>
required

When the workspace was created. A stopped workspace that kept no creation time reports 1970-01-01T00:00:00.000Z.

Example:

"2026-11-07T00:00:00.000Z"

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