---
title: "Gossip Claims"
method: POST
path: "/cluster/claims/gossip"
---

# Gossip Claims

`POST /cluster/claims/gossip`

Fold peer claim receipts into this node's signed journal (#2558).

The leaderless counterpart to ``POST /cluster/steal``: no node decides who
gets what here. Each receipt is folded only after its Ed25519 signature and
its chain link both verify, so an unverifiable receipt is never written.

A receipt that does not extend the local head is *not* merged. It produces
a signed ``fork`` receipt carrying the divergence entry index, which the
response surfaces through ``forked``. Silent merge would be the one failure
mode a leaderless design cannot recover from: two partitions would each
hold a coherent-looking journal describing incompatible work.

Authorisation reuses the node-heartbeat scope: gossip is a peer-to-peer
fleet-membership operation, not an administrative one.

## Request body

- ClaimGossipRequest — Body for POST /cluster/claims/gossip - push signed claim receipts to a peer. ``receipts`` are the raw :class:`ClaimReceipt` wire dicts in journal order. ``head`` is the sender's journal head, echoed back so the sender can tell convergence from divergence without a second round trip.
  - `receipts` object[], required
  - `head` string, nullable
  - `node_id` string, nullable

## Response `200`

Successful Response

- ClaimGossipResponse — Response for POST /cluster/claims/gossip. ``forked`` is surfaced at the top level because a fork is the one outcome that must not be lost in a per-receipt list an integrator might ignore.
  - `head` string, required
  - `accepted` integer, required
  - `results` ClaimGossipResult[], required
    - `entry_hash` string, required
    - `status` string, required
    - `reason` string, nullable
    - `divergence_index` integer, nullable
  - `forked` boolean

## Other responses

- `401` — Cluster authentication failed
- `409` — Node is not running the MESH topology
- `422` — Validation Error

---

[API](https://skmtc.net/sipyourdrink-ltd/apis/bernstein-task-server.md) · [All operations](https://skmtc.net/sipyourdrink-ltd/apis/bernstein-task-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sipyourdrink-ltd/bernstein-task-server/versions/86f514b4e920/schema)