Create stream

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

curl -X PUT https://stream.tonbo.dev/ds/demo/hello \
  -H 'Content-Type: application/json' \
  --data-binary '{"msg": "first entry"}'

curl -X PUT https://stream.tonbo.dev/ds/demo/ephemeral \
  -H 'Stream-TTL: 3600'

PUT

{bucket}

{stream}

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

curl -X PUT https://stream.tonbo.dev/ds/demo/hello \
  -H 'Content-Type: application/json' \
  --data-binary '{"msg": "first entry"}'

curl -X PUT https://stream.tonbo.dev/ds/demo/ephemeral \
  -H 'Stream-TTL: 3600'

string

required

Bucket ID. Must match [a-z0-9_-]{4,64}.

string

required

Stream ID within the bucket.

string

Content type of the initial payload (e.g. application/json). Becomes the stream’s content type.

string

Set to true to close the stream immediately after creation.

string

Time-to-live in seconds. The stream will expire after this duration.

string

Absolute expiration timestamp (RFC 3339). Mutually exclusive with Stream-TTL.

string

Conditional create: only succeed if the stream’s ETag matches.

string

Client-supplied sequence token for conflict detection.

string

Producer identity for exactly-once writes.

string

Producer epoch (must accompany Producer-Id).

string

Producer sequence number (must accompany Producer-Id).

binary

Optional initial payload. If provided, becomes the first entry in the stream.

Response

Status	Meaning
`201`	Stream created.
`200`	Stream already exists with identical configuration (idempotent).
`400`	Invalid stream ID, invalid headers, or bad JSON payload.
`404`	Bucket not found.
`409`	Stream already exists with different configuration, or sequence conflict.
`412`	`If-Match` precondition failed.

Response headers include Location, Content-Type, Stream-Next-Offset, and ETag.

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

curl -X PUT https://stream.tonbo.dev/ds/demo/hello \
  -H 'Content-Type: application/json' \
  --data-binary '{"msg": "first entry"}'

curl -X PUT https://stream.tonbo.dev/ds/demo/ephemeral \
  -H 'Stream-TTL: 3600'

If a stream with the same ID already exists and has identical configuration, the response is 200 OK (idempotent). If the existing stream differs in content type, closed state, or retention, the response is 409 Conflict.

List streams Append

Getting Started

Concepts

Architecture

API

Protocol Specification

Comparisons

Response

​Response

Response