Skip to content

Alive probe

Bartosz Kupidura edited this page Jul 29, 2026 · 7 revisions

DMH and Vault needs to be informed that you are still there to be able to execute action when you would be dead.

Easiest way to achive that is to visit https://dmh-domain/alive - it renders a small page with an "I am alive" button, which POSTs to the exact same URL when clicked. https://dmh-domain/api/alive does the same update without the page (GET or POST), for scripts/automation.

Both endpoints require authentication like any other DMH/Vault endpoint - a bearer token, a valid signed URL, or alive/api:alive listed in auth.anonymous_scope (see Security page).

Reminders

If you need an automated way to send yourself a reminder, use a regular action with a {sig_auth:alive} placeholder in data - DMH replaces it with a fresh, time-limited signed link each time the reminder is sent, so the mail/sms itself doesn't need to carry a permanent bearer token:

{
  "kind": "mail",
  "process_after": 24,
  "min_interval": 20,
  "data": "{\"message\": \"Are you still alive? Please visit https://dmh-domain/{sig_auth:alive}\", \"subject\": \"Are you good?\", \"destination\":[\"email@address.com\"]"
}

This will send mail after 24 hours of abstence, and then will repeat this action every 20 hours.

You can build "layers" of reminders:

{
  "kind": "mail",
  "process_after": 24,
  "min_interval": 30,
  "data": "..."
}
{
  "kind": "bulksms",
  "process_after": 72,
  "min_interval": 72,
  "data": "..."
}
{
  "kind": "bulksms",
  "process_after": 168,
  "min_interval": 168,
  "data": "..."
}

Clone this wiki locally