Skip to content
Hayonix

API reference · Schema

PodStatus

  • statestringrequired

    queued (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 ofqueuedpreemptedpullingstartingrunningrestartingstoppingstoppedexitedfailedunreachableterminatingterminated

  • reasonstring | nullrequired

    Machine-readable cause of the state (why it waits, stopped or failed); null when there is none

  • messagestringrequired

    One sentence for people

  • sincestring (date-time)required

    When the pod entered this state

  • image_pullobject | nullrequired

    Image download progress while the state is `pulling`; else null

    Show 6 fields of image_pull
    • imagestringrequired

      Container image reference

    • bytes_doneintegerrequired

      Bytes downloaded so far

    • bytes_totalintegerrequired

      Bytes to download in total (0 while unknown)

    • layers_doneintegerrequired

      Image layers downloaded

    • layers_totalintegerrequired

      Image layers in total

    • percentinteger | nullrequired

      Bytes downloaded, 0–100; null while the total is unknown

Example
{
  "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
  }
}