---
title: "Node heartbeat."
method: POST
path: "/v1/nodes/{id}/heartbeat"
tags: ["nodes"]
---

# Node heartbeat.

`POST /v1/nodes/{id}/heartbeat`

## Request

- Base URL: `https://api.smolmachines.com`
- URL: `https://api.smolmachines.com/v1/nodes/{id}/heartbeat`
- Auth: none declared
- TypeScript: <https://skmtc.dev/smolmachines/apis/smolfleet-api/docs/v1/nodes/:id/heartbeat/post.ts> (a function with typed inputs; its response is checked against the schema)

Reports node liveness and capacity. Authenticated by the node's credential, not an API key.

## Path parameters

- `id` string, required

## Response `200`

Heartbeat accepted

---

[API](https://skmtc.dev/smolmachines/apis/smolfleet-api.md) - [All operations](https://skmtc.dev/smolmachines/apis/smolfleet-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smolmachines/apis/smolfleet-api/revisions/bc31fc04a568?raw)