fix(routes): added undocumented responses

2026-04-20 01:23:07 -04:00
parent 4abfac1a98
commit 5b70a34c94
8 changed files with 52 additions and 6 deletions
--- a/decnet/web/router/swarm/api_heartbeat.py
+++ b/decnet/web/router/swarm/api_heartbeat.py
@@ -96,7 +96,15 @@ async def _verify_peer_matches_host(
    return host


-@router.post("/heartbeat", status_code=204, tags=["Swarm Health"])
+@router.post(
+    "/heartbeat",
+    status_code=204,
+    tags=["Swarm Health"],
+    responses={
+        403: {"description": "Peer cert missing, or its fingerprint does not match the host's pinned cert"},
+        404: {"description": "host_uuid is not enrolled"},
+    },
+)
 async def heartbeat(
    req: HeartbeatRequest,
    request: Request,