---
title: "Fleet Router Heartbeat"
method: POST
path: "/fleet/routers/{router_id}/heartbeat"
---

# Fleet Router Heartbeat

`POST /fleet/routers/{router_id}/heartbeat`

## Request

- Base URL: `https://api-docs.session-exchange.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api-docs.session-exchange.com/fleet/routers/{router_id}/heartbeat`
- Auth: none declared

## Path parameters

- `router_id` string, required

## Request body

- RouterHeartbeatRequest: `POST /fleet/routers/{id}/heartbeat` — observed state from the router itself (01 §3.4). Kept in memory only; never contains secret values.
  - `router_id` string, nullable
  - `build` string, nullable
  - `image_digest` string, nullable
  - `role` string, nullable
  - `channel` string, nullable
  - `config_fingerprint` string, nullable
  - `env_names_sha256` string, nullable
  - `posture` object
  - `capabilities` string[]
  - `counters` object

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/session-exchange/apis/a4sx.md) · [All operations](https://skmtc.dev/session-exchange/apis/a4sx/llms.txt) · [OpenAPI document](https://skmtc.dev/session-exchange/apis/a4sx/revisions/abaefc33dfc7?raw)
