Store any kind of record in one table.

teleon.dev/docs/records keeps every kind of record in one self-describing table. New kinds arrive with their own schema in the envelope, and row versions keep concurrent writes safe.

teleon.dev/docs/recordsUniversal flat storehttpsjsonmcp

Read the docs Copy the agent prompt

Different kinds, one table

Record	Kind	Schema	Version
rec_501	dataset_recipe	recipe/v1	4
rec_502	capability_note	note/v2	1
rec_503	scenario_seed	seed/v1	7

Every record names its own kind and schema, so new kinds fit the same table as they are.

What it does

Self-describing rows

Each record carries its kind and schema in an envelope.

Safe concurrent writes

A row version must match before an update lands.

Combinations streamed

Mixes of fields stream out as new rows for experiments.

The contract

A record is an envelope plus fields; the row version guards every write.

Tableteleon_universal_records

ConcurrencyRow versions, optimistic

StoreS21 records and switchboard

AccessRING-2

Identifiers

teleon_universal_flat_record/v1
teleon_combinatorial_emission/v1

Execution contracts

Single-table self-describing universal flat record and combinatorial engine

Request and responseCopy

PUT /v1/records/rec_501
If-Match: 3
{
  "kind": "dataset_recipe",
  "schema": "recipe/v1",
  "fields": {"source": "https://data.gov/...", "license": "CC-BY-4.0"}
}

# Response
{
  "id": "rec_501",
  "row_version": 4
}

Endpoints

Method	Path	Access	What it does	Status
`GET`	`/v1/records`	RING-2	List records by kind	Listed
`PUT`	`/v1/records/{id}`	RING-2	Write a record with its row version

Listed paths appear in the service’s published files today. In the one-host plan every path here is served under api.teleon.dev/v1/records.

How it connects

Reads from

Partitioned coreteleon.dev/docs/partitions Catch-all intaketeleon.dev/docs/catchall

Feeds into

Searchteleon.dev/docs/search Datasetsteleon.dev/docs/datasets

Queuesaq77 aq78

StoresS21 Universal Single-Table Flat Records and Switchboard

For agents

Give your agent the read-only guide first. It reports back before any write.

Agent prompt

Read https://teleon.dev/docs/records.md and list record kinds. Read only.

Copy

llms.txt Agent card MCP card

Words on this page

Full glossary

OKF: The schema-free record format at the first rung of the schema ladder, used for catch-all items.
Idempotent: Safe to repeat: running the same request twice leaves the same result as running it once.
Partition: One slice of a large table, chosen by a key such as site or queue, so reads and writes stay fast.