curl 'https://stream.tonbo.dev/ds/demo/streams'
curl 'https://stream.tonbo.dev/ds/demo/streams?prefix=session-&limit=100'
{
"bucket_id": "demo",
"prefix": "",
"stream_count": 2,
"streams": [
{
"stream_id": "hello",
"status": "open",
"content_type": "application/json",
"tail_offset": 42,
"created_at_ms": 1711234567890,
"last_write_at_ms": 1711234599000
}
],
"next_cursor": "hello",
"has_more": false
}
Buckets
List streams
List streams within a bucket with optional prefix filtering and pagination.
GET
/
ds
/
{bucket}
/
streams
curl 'https://stream.tonbo.dev/ds/demo/streams'
curl 'https://stream.tonbo.dev/ds/demo/streams?prefix=session-&limit=100'
{
"bucket_id": "demo",
"prefix": "",
"stream_count": 2,
"streams": [
{
"stream_id": "hello",
"status": "open",
"content_type": "application/json",
"tail_offset": 42,
"created_at_ms": 1711234567890,
"last_write_at_ms": 1711234599000
}
],
"next_cursor": "hello",
"has_more": false
}
string
required
Bucket ID. Must match
[a-z0-9_-]{4,64}.string
default:""
Only return streams whose ID starts with this prefix.
string
Cursor for pagination. Return streams after this stream ID.
number
default:"1000"
Maximum number of streams to return. Must be between 1 and 1000.
Response
| Status | Meaning |
|---|---|
200 | Streams listed. |
400 | Invalid bucket ID or limit out of range. |
404 | Bucket not found. |
string
required
The bucket identifier.
string
required
The prefix filter applied.
number
required
Number of streams in this page.
object[]
required
Show properties
Show properties
string
required
Stream ID (local to the bucket).
string
required
Stream status:
open or closed.string
required
The stream’s content type.
number
required
Current tail offset (next writable position).
number
required
Creation timestamp in milliseconds since epoch.
number
required
Last write timestamp in milliseconds since epoch.
string
Cursor for the next page. Pass as
after to fetch the next page.boolean
required
Whether more streams exist beyond this page.
curl 'https://stream.tonbo.dev/ds/demo/streams'
curl 'https://stream.tonbo.dev/ds/demo/streams?prefix=session-&limit=100'
{
"bucket_id": "demo",
"prefix": "",
"stream_count": 2,
"streams": [
{
"stream_id": "hello",
"status": "open",
"content_type": "application/json",
"tail_offset": 42,
"created_at_ms": 1711234567890,
"last_write_at_ms": 1711234599000
}
],
"next_cursor": "hello",
"has_more": false
}