API reference · Schema
PodStatus
statestringrequiredqueued (waiting for capacity) · preempted (interruptible capacity reclaimed; waiting again) · pulling (downloading the image) · starting · running · restarting · stopping · stopped (compute released, volumes kept) · exited (the main process finished) · failed (see reason) · unreachable (its host stopped reporting) · terminating · terminated
One of
queuedpreemptedpullingstartingrunningrestartingstoppingstoppedexitedfailedunreachableterminatingterminatedreasonstring | nullrequiredMachine-readable cause of the state (why it waits, stopped or failed); null when there is none
messagestringrequiredOne sentence for people
sincestring (date-time)requiredWhen the pod entered this state
image_pullobject | nullrequiredImage download progress while the state is `pulling`; else null
ShowHide 6 fields of
image_pullimagestringrequiredContainer image reference
bytes_doneintegerrequiredBytes downloaded so far
bytes_totalintegerrequiredBytes to download in total (0 while unknown)
layers_doneintegerrequiredImage layers downloaded
layers_totalintegerrequiredImage layers in total
percentinteger | nullrequiredBytes downloaded, 0–100; null while the total is unknown
{
"state": "queued",
"reason": "waiting_for_capacity",
"message": "string",
"since": "2026-01-01T00:00:00.000Z",
"image_pull": {
"image": "string",
"bytes_done": 1,
"bytes_total": 1,
"layers_done": 1,
"layers_total": 1,
"percent": 1
}
}