Agents

Record a runner machine heartbeat and telemetry snapshot

OAuth-authenticated machine presence sidecar. Upserts the caller-owned machine and refreshes its heartbeat timestamp. Users with access to multiple billing accounts must send an in-scope billing_account_id. Rate limited (600/min/IP).

post/agents/machines/heartbeat

Request

  • Base URL: https://api.apphandoff.com/api
  • URL: https://api.apphandoff.com/api/agents/machines/heartbeat
  • Auth: API key in cookie sb-access-token

Request body

machine_idstring required
namestring required
hostnamestring
backendstring
capabilitiesstring[]
cli_metaobject
usage_snapshotobject
sessionsobject[]
billing_account_idstring uuid

Response

Machine heartbeat recorded

oktrue required
machine_idstring required
server_timestring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.