Skip to main content
PATCH
/
v1
/
machines
/
{machine_id}
Update machine
curl --request PATCH \
  --url https://dcs.dedaluslabs.ai/v1/machines/{machine_id} \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "autosleep": "<string>",
  "memory_mib": 123,
  "storage_gib": 123,
  "vcpu": 123
}
'
{ "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
​
Idempotency-Key
string
required

Path Parameters

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

Body

application/json
​
autosleep
string

Idle window before autosleep. Accepts fixed duration units like 30s, 30m, 2h, 7d3h4s, or 1w3d, raw seconds ("1800"), or never to disable.

​
memory_mib
integer<int64>

Memory in MiB.

​
storage_gib
integer<int64>

Storage in GiB.

​
vcpu
number<double>

CPU in vCPUs.

Response

OK

​
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