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