Skip to content
HALOWERK

Codewerk

heartbeat monitor

Persistent heartbeat monitor with separate ping, status and management tokens. A first missed deadline permanently closes the monitor and queues one stable signed event, retried up to three times. Webhook origin must explicitly authorize heartbeat-missed POST with the private secret preimage. Existing hub scans state every second and resumes after restart. Best effort, no independent availability or guaranteed delivery.

POST https://code.halowerk.com/v1/heartbeat-monitor

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
labelstringYesTechnical monitor label, no personal data or secrets.
interval_secondsintegerNoTime until first heartbeat, and deadline interval after each accepted ping.
duration_secondsintegerNoFixed monitoring window, at least twice the interval.
webhook_urlstringYesOwned public HTTPS POST receiver with purpose-specific origin proof.
webhook_secretstringYesPrivate ownership proof preimage and HMAC signing secret; publish only its hash.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "label",
    "webhook_url",
    "webhook_secret"
  ],
  "properties": {
    "label": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Technical monitor label, no personal data or secrets."
    },
    "interval_seconds": {
      "type": "integer",
      "minimum": 10,
      "maximum": 3600,
      "default": 60,
      "description": "Time until first heartbeat, and deadline interval after each accepted ping."
    },
    "duration_seconds": {
      "type": "integer",
      "minimum": 60,
      "maximum": 86400,
      "default": 3600,
      "description": "Fixed monitoring window, at least twice the interval."
    },
    "webhook_url": {
      "type": "string",
      "maxLength": 1200,
      "description": "Owned public HTTPS POST receiver with purpose-specific origin proof."
    },
    "webhook_secret": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{43,128}$",
      "description": "Private ownership proof preimage and HMAC signing secret; publish only its hash."
    }
  }
}

Open original schema

Published input example

{
  "label": "Synthetic heartbeat demo",
  "interval_seconds": 60,
  "duration_seconds": 3600,
  "webhook_url": "https://code.halowerk.com/heartbeat/demo-receiver",
  "webhook_secret": "halowerk-public-demo-heartbeat-ack-only-v1-20261115"
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’