Skip to main content
HEAD
/
ds
/
{bucket}
/
{stream}
curl -I https://stream.tonbo.dev/ds/demo/hello

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.

​
bucket
string
required
Bucket ID.
​
stream
string
required
Stream ID within the bucket.
​
If-None-Match
string
ETag for conditional request. Returns 304 if the stream state has not changed.

​
Response

StatusMeaning
200Stream found.
304Stream state unchanged (when If-None-Match matches).
404Stream not found or expired.
Response headers include:
HeaderDescription
Content-TypeThe stream’s content type.
Stream-Next-OffsetThe next writable offset (= current length).
ETagStream state ETag (encodes offset and open/closed state).
Stream-ClosedPresent and true if the stream is closed.
Stream-Snapshot-OffsetPresent if a snapshot exists, showing its offset.
Stream-TTLRemaining TTL in seconds (if a TTL was set).
Stream-Expires-AtExpiration timestamp (if set).
Cache-Controlno-store.
curl -I https://stream.tonbo.dev/ds/demo/hello
Use If-None-Match with a previously received ETag to efficiently poll for state changes without transferring data.