Skip to main content
GET
/
v1
/
machines
/
{machine_id}
/
status
/
stream
Typescript
const client = new Dedalus();

const result = await client.machines.watch({ ...params });
{ "desired_state": "running", "machine_id": "<string>", "memory_mib": 123, "status": { "last_progress_at": "2023-11-07T05:31:56Z", "last_transition_at": "2023-11-07T05:31:56Z", "phase": "accepted", "reason": "<string>", "retryable": true, "revision": "<string>", "last_error": "<string>" }, "storage_gib": 123, "vcpu": 123 }

Authorizations

​
x-api-key
string
header
required

Dedalus API key. Alternative to Bearer token.

Headers

​
X-Dedalus-Org-Id
string<uuid>

Organization ID header applied to all DCS requests.

​
Last-Event-ID
string

Optional resourceVersion bookmark used to resume a previous stream.

Path Parameters

​
machine_id
string
required

Machine identifier.

Response

Server-Sent Event stream (text/event-stream) of machine lifecycle updates.

​
desired_state
enum<string>
required
Available options:
running,
sleeping,
destroyed
​
machine_id
string
required
​
memory_mib
integer<int64>
required

Memory in MiB.

​
status
object
required
​
storage_gib
integer<int64>
required
​
vcpu
number<double>
required

CPU in vCPUs.

Last modified on April 9, 2026