Append an event

Requires writer. Send the root read just before the write as expected_root, and a stable Idempotency-Key per logical operation. A retry with the same key and the same type, entity_id, command and payload replays the original event.

post/v1/events

Request

  • Base URL: https://store.example.com
  • URL: https://store.example.com/v1/events
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

Request body

typestring required
entity_idstring
commandstring required
payloadunknown required
expected_rootstring required

Root read just before this write; "" only for the first event.

Example request

{
  "type": "business.fact",
  "entity_id": "customer:42",
  "command": "fact assert"
}

Response

Replayed an earlier identical request

hashstring
rootstring
replayedboolean

Changes

No recorded changes to this operation across all 1 revision of this API.