cloud-computers
post/cloud-computers/host/{computer_id}/heartbeat

Request

  • Base URL
    https://api.moda.app/v1
  • URL
    https://api.moda.app/v1/cloud-computers/host/{computer_id}/heartbeat
  • Auth
    none declared

Path parameters

computer_idstring required

Headers

X-Voyager-Cloud-Leasestring
X-Voyager-Cloud-Lease-Tokenstring
Moda-Version'2026-04-12' | '2026-05-01'
Example:2026-05-01

Calendar-dated API version pin. New integrations should pin 2026-05-01 to opt into the newest response shapes. For back-compat the server also accepts requests with no header and resolves them to the current default (today: 2026-04-12); that default advances on each sunset date. Any unsupported value returns 400 unsupported_version.

Request body

busyboolean required
busy_reasonstring nullable
next_wake_atstring date-time nullable
storage_bytesinteger required

Response

Successful Response

accept_new_workboolean required
blocked_reason'PLAN_REQUIRED' | 'INSUFFICIENT_CREDITS' | 'SPENDING_LIMIT_REACHED' | 'BILLING_UNAVAILABLE' nullable required
sleep_requestedboolean required
lease_expires_atstring date-time required

Changes