Skip to main content
GET
/
v1
/
machines
/
{machine_id}
/
status
/
stream
Watch machine lifecycle status
curl --request GET \
  --url https://dcs.dedaluslabs.ai/v1/machines/{machine_id}/status/stream \
  --header 'x-api-key: <api-key>'
{ "autosleep_seconds": 4611686018, "machine_id": "<string>", "memory_mib": 123, "status": { "last_progress_at": "2023-11-07T05:31:56Z", "last_transition_at": "2023-11-07T05:31:56Z", "reason": "<string>", "retryable": true, "revision": "<string>", "last_error": "<string>" }, "storage_gib": 123, "vcpu": 123 }

Documentation Index

Fetch the complete documentation index at: https://docs.dedaluslabs.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.

Required string length: 4 - 253
Pattern: ^dm-[a-z0-9]([a-z0-9-]*[a-z0-9])?$

Response

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

​
autosleep_seconds
integer<int64>
required

Seconds of inactivity before autosleep. 0 disables autosleep.

Required range: 0 <= x <= 9223372036
​
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 May 29, 2026