---
title: "Heartbeat fail (subpath variant)"
method: POST
path: "/api/v1/heartbeats/{token}/fail"
tags: ["ingestion"]
---

# Heartbeat fail (subpath variant)

`POST /api/v1/heartbeats/{token}/fail`

## Request

- Base URL: `https://monit.rs`
- URL: `https://monit.rs/api/v1/heartbeats/{token}/fail`
- Auth: none declared

Semantically identical to POST /heartbeats/{token}?state=fail. Ships alongside the query-param form because different cron ecosystems ship different conventions.

## Path parameters

- `token` string, required

## Response `204`

Fail heartbeat recorded.

## Other responses

- `404`: Token not recognized.

---

[API](https://skmtc.dev/monit/apis/monit-rs-public-api.md) · [All operations](https://skmtc.dev/monit/apis/monit-rs-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/monit/apis/monit-rs-public-api/revisions/7e1923981112?raw)