Skip to content

Append a signed event to its issuer's log

POST
/v1/events
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}).

Media typeapplication/json
object
event
required
object
hss
required
Allowed value: 1
issuer
required
string
seq
required
integer
prev
required
One of:
string
/^[0-9a-f]{64}$/
type
required
string
case
string
<= 128 characters
ts
required
string format: date-time
public
required
object
docs
required
Array<object>
object
label
required
string
commitment
required
string
/^[0-9a-f]{64}$/
mime
string
size
integer
actor
required
string
sig
required
One of:
object
kind
required
Allowed value: passkey
authenticatorData
required
string
clientDataJSON
required
string
signature
required
string
publish
Array<object>
object
commitment
required
string
/^[0-9a-f]{64}$/
digest
required
string
/^[0-9a-f]{64}$/
salt
required
string
/^[0-9a-f]{64}$/

{ 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.