Skip to main content
All you need is curl. The examples below use a public Tonbo Stream cluster at stream.tonbo.dev.

Create a bucket and a stream

curl -X PUT https://stream.tonbo.dev/ds/demo
curl -X PUT https://stream.tonbo.dev/ds/demo/hello

Append data

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

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

Read everything from the beginning

curl 'https://stream.tonbo.dev/ds/demo/hello?offset=-1'

Subscribe for live updates

Open a second terminal and start an SSE subscription:
curl 'https://stream.tonbo.dev/ds/demo/hello?offset=-1&live=sse'
Then go back to the first terminal and append more data — you’ll see it arrive in the SSE stream instantly.