Skip to main content

Documentation Index

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

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

S2’s data plane lets you append records at the tail, read starting from any position in the stream, and check-tail to figure out the tail.
seq_num: 42
timestamp: 1713812735000
headers:
  role: agent
  response-type: tool-call
  format: json
body:
  

Anatomy of a record

Sequence number
Strictly increasing position within the stream.Always assigned by S2.
Timestamp
Arrival timestamp in milliseconds, when assigned by S2 (default).It can also be client-specified.
Headers
Name-value pairs, similar to HTTP headers.Both the name and value can be arbitrary bytes.
Body
The core payload of a record.Arbitrary bytes.

Size

A single record can be up to 1 MiB in metered bytes.

See also

SDK

Appending and reading records

API Reference

Append, read, and check-tail endpoints