Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.snakream.tonbo.dev/llms.txt

Use this file to discover all available pages before exploring further.

All you need is curl. The examples below use a public Snakream 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.

Read more

  • API overview — all HTTP routes and request patterns
  • Streams — the core stream abstraction and lifecycle
  • Architecture — how the cluster works under the hood