v2

latestOpenAPI 3.1.0raw.githubusercontent.com2026-02-1251112.9 KB

Append records

Append one or more records to the log. Each record has a key (used for partitioning scans) and a value (arbitrary bytes, both base64-encoded in JSON).

Set awaitDurable to true to block until the records are persisted to durable storage. When false (the default), the server acknowledges the write as soon as records are buffered in memory.

post/api/v1/log/append

Request body

awaitDurableboolean

Whether to wait for durable persistence before responding.

Response

Records appended successfully.

statusstring required
recordsAppendedinteger required

Number of records written.

startSequenceinteger required

Sequence number assigned to the first appended record.

Example response

{
  "status": "success"
}