GET /head

This lightweight endpoint fetches metadata about the latest confirmed entry in the replication log for the authenticated agent. It is designed to run in under 15ms.

Request URL

GET /head

Response Schema (200 OK)

Returns details about the latest block sequence:

{
  "sequence_number": 10,
  "merkle_root": "84c8a8d11d95e0cce8da70c1a96c14b7454f738f65429384f9b4f3b7d1597f8c",
  "updated_at": "2026-06-09T16:45:30.123Z"
}

Errors

• 404 no_replication_entries: The agent has not pushed any replication entries yet.