v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-19273210655.1 KB
Sites

Update heartbeat

Update a specific heartbeat for the site.

Processing mode: <small><code>sync</code></small>

put/orgs/{organization}/servers/{server}/sites/{site}/heartbeats/{heartbeat}

Path parameters

organizationstring required

The organization slug

serverinteger required

The server ID

siteinteger required

The site ID

heartbeatinteger required

The heartbeat ID

Request body

namestring required

The name of the heartbeat.

grace_period1 | 2 | 5 | 10 | 30 | 60 required
frequency1 | 5 | 10 | 30 | 60 | 1440 | 10080 | 312480 | -1 required
custom_frequencystring

A cron expression representing the custom frequency at which the client is expected to send a ping, if the frequency is set to -1.

Example request

{
  "name": "My Heartbeat",
  "custom_frequency": "* * * * *"
}

Response

HeartbeatResource