Sign in

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"
}

Changes

Changed in 1 of the 2 revisions of this API.21

  • 792e23c4330121See the full diff
    • ▲

      the request property records/items/key became required

      request-property-became-required

    • ▲

      the records/items/key request property type/format changed from object/ to string/byte

      request-property-type-changed

    • ●

      removed the request property records/items/key/value

      request-property-removed