Append a signed event to its issuer's log
POST
/v1/events
const url = 'https://api.hardstate.net/v1/events';const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"event":{"hss":1,"issuer":"example","seq":1,"prev":"example","type":"example","case":"example","ts":"2026-04-15T12:00:00Z","public":{},"docs":[{"label":"example","commitment":"example","mime":"example","size":1}],"actor":"example"},"sig":{"kind":"passkey","authenticatorData":"example","clientDataJSON":"example","signature":"example"},"publish":[{"commitment":"example","digest":"example","salt":"example"}]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.hardstate.net/v1/events \ --header 'Content-Type: application/json' \ --data '{ "event": { "hss": 1, "issuer": "example", "seq": 1, "prev": "example", "type": "example", "case": "example", "ts": "2026-04-15T12:00:00Z", "public": {}, "docs": [ { "label": "example", "commitment": "example", "mime": "example", "size": 1 } ], "actor": "example" }, "sig": { "kind": "passkey", "authenticatorData": "example", "clientDataJSON": "example", "signature": "example" }, "publish": [ { "commitment": "example", "digest": "example", "salt": "example" } ] }'seq must be head+1 and prev the head hash. On 409 the head moved: rebuild on the returned head and sign again
(HardStateClient.append does this). publish lists documents whose salt and digest are revealed (then PUT the
file to /v1/docs/{commitment}).
Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
event
required
sig
required
publish
Array<object>
object
commitment
required
string
digest
required
string
salt
required
string
Responses
Section titled “Responses”{ hash, issuer, seq, status: queued, proof, receipt }
The plan’s monthly fair-use limit is spent (10% grace); issuer., key. and session.* events still go through: { error, plan, limit, records, upgrade }
Issuer does not exist and the event is not issuer.create
The log head moved: { error, head }
Shape
Rate limited
HardState is a Zevlat Intelligence venture. © 2026 Zevlat Intelligence.