Skip to main content
GET
/
v1
/
machines
/
{id}
Get machine details
import requests

url = "https://api.13-215-85-171.sslip.io/v1/machines/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
{
  "id": "<string>",
  "config": {
    "vcpus": 123,
    "memory_mb": 123,
    "disk_mb": 123
  },
  "template": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "metadata": {},
  "started_at": "2023-11-07T05:31:56Z",
  "timeout_ms": 123,
  "timeout_at": "2023-11-07T05:31:56Z",
  "expires_at": "2023-11-07T05:31:56Z",
  "remaining_ms": 123,
  "last_active_at": "2023-11-07T05:31:56Z",
  "inactivity_timeout_ms": 123,
  "auto_delete_after_ms": 123,
  "ephemeral": true,
  "cwd": "<string>",
  "snapshot_id": "<string>",
  "warm_pool_checkout": {
    "hit": true,
    "id": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

API key passed as Bearer token

Path Parameters

​
id
string
required

Machine ID (e.g. mch_a1b2c3d4)

Query Parameters

​
fields
string

Comma-separated field mask for machine list/get responses. Supported fields: id, status, config, template, metadata, started_at, timeout_ms, timeout_at, expires_at, timeout_action, created_at, cwd, snapshot_id, traffic_access_token.

Response

Machine details

​
id
string
required
​
status
enum<string>
required
Available options:
creating,
running,
paused,
destroyed,
error
​
config
object
required
​
template
string
required
​
created_at
string<date-time>
required
​
metadata
object

Machine metadata. Attached volume state is exposed under volume_attachments in request order. Free-form user-supplied object stored verbatim; deliberately open.

​
started_at
string<date-time>
​
timeout_ms
integer<int64>
​
timeout_at
string<date-time>
​
expires_at
string<date-time>

Alias of timeout_at for clients that expect an expiry timestamp field.

​
remaining_ms
integer<int64>

Milliseconds remaining until timeout_at (clamped at 0), computed at response time. Lets callers schedule a timeout refresh without re-deriving the deadline from timeout_at themselves.

​
timeout_action
enum<string>
Available options:
destroy,
hibernate
​
last_active_at
string<date-time> | null

Most recent activity timestamp (edge ingress or exec/file/pty/process traffic). Drives inactivity-relative deadlines. Absent if no activity has been observed yet.

​
inactivity_timeout_ms
integer<int64> | null

Effective idle timeout in milliseconds, if an inactivity policy is set.

​
auto_delete_after_ms
integer<int64> | null

Effective auto-delete window in milliseconds, if set.

​
ephemeral
boolean

Whether the machine is ephemeral (destroyed, never hibernated, on idle).

​
cwd
string

Normalized default working directory for this machine when one was configured.

​
snapshot_id
string

Present only when status is paused. The snapshot ID needed to resume this machine.

​
warm_pool_checkout
object

Create-time warm-pool checkout result. Omitted when create did not consider a warm pool.