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

Body

application/json
​
memory_mib
integer<int64>
required

Memory in MiB.

​
storage_gib
integer<int64>
required

Storage in GiB.

​
vcpu
number<double>
required

CPU in vCPUs.

​
autosleep
string

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

Response

Create converged inline

​
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