List 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
}

GET

{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

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
}

Delete bucket Create stream

Getting Started

Concepts

Architecture

API

Protocol Specification

Comparisons

Response

​Response

Response