POST /api/chain/:slug/state
Append a state-hash snapshot. The caller computes the hash off-chain. Useful for periodic state attestations.
Auth
Bearer with operator role or higher.
Request
{
"state_hash": "0123abc…64hex"
}
state_hash is required. 64 hex chars, lowercased server-side.
Response — 201
{ "ok": true, "zeqondNumber": 2287439213, "transitionId": "9b1c-…uuid" }
Errors
| Status | error | Cause |
|---|---|---|
400 | invalid_request | state_hash missing or wrong length |
401/403/404 | as in POST /event |
Curl
curl -sS https://zeqapi.com/api/chain/my-iot-fleet/state \
-H "Authorization: Bearer ${ZSM_KEY}" \
-H "Content-Type: application/json" \
-d '{"state_hash":"0123abc1234567890abcdef0123456789abcdef0123456789abcdef0123abcd"}'