Append

curl -X POST https://stream.tonbo.dev/ds/demo/hello \
  -H 'Content-Type: application/octet-stream' \
  --data-binary 'hello world'

curl -X POST https://stream.tonbo.dev/ds/demo/hello \
  -H 'Content-Type: application/json' \
  --data-binary '{"event": "click", "ts": 1711234567}'

curl -X POST https://stream.tonbo.dev/ds/demo/hello \
  -H 'Stream-Closed: true'

POST

{bucket}

{stream}

curl -X POST https://stream.tonbo.dev/ds/demo/hello \
  -H 'Content-Type: application/octet-stream' \
  --data-binary 'hello world'

curl -X POST https://stream.tonbo.dev/ds/demo/hello \
  -H 'Content-Type: application/json' \
  --data-binary '{"event": "click", "ts": 1711234567}'

curl -X POST https://stream.tonbo.dev/ds/demo/hello \
  -H 'Stream-Closed: true'

string

required

Bucket ID.

string

required

Stream ID within the bucket.

string

required

Must match the stream’s content type. Required when the body is non-empty.

string

Set to true to close the stream after this append.

string

Conditional write: only succeed if the stream’s ETag matches.

string

Client-supplied sequence token for conflict detection.

string

Producer identity for exactly-once writes.

string

Producer epoch.

string

Producer sequence number.

binary

required

The bytes to append. Must not be empty unless Stream-Closed: true is set (close-only request).

Response

Status	Meaning
`200`	Append successful.
`400`	Empty body without `Stream-Closed: true`, missing content type, or bad JSON.
`404`	Stream not found.
`409`	Stream is already closed, or sequence/producer conflict.
`412`	`If-Match` precondition failed.
`503`	Write backpressure. Retry after the duration in `Retry-After`.

Response headers include Stream-Next-Offset and ETag.

curl -X POST https://stream.tonbo.dev/ds/demo/hello \
  -H 'Content-Type: application/octet-stream' \
  --data-binary 'hello world'

curl -X POST https://stream.tonbo.dev/ds/demo/hello \
  -H 'Content-Type: application/json' \
  --data-binary '{"event": "click", "ts": 1711234567}'

curl -X POST https://stream.tonbo.dev/ds/demo/hello \
  -H 'Stream-Closed: true'

Appends to JSON streams are validated and normalized. The server may coalesce multiple concurrent appends into a single batch for performance.