Namespace metadata

Request

GET /v2/namespaces/products/metadata

{
  // Proxied from Turbopuffer verbatim
  "schema": { },
  "approx_row_count": 12500,
  "approx_logical_bytes": 48800000,
  "created_at": "2026-03-15T10:30:45Z",
  "updated_at": "2026-05-12T18:49:00Z",
  "last_write_at": "2026-05-12T18:48:30Z",
  "index": { "status": "up-to-date" },

  // Layer enhancement
  "layer": {
    "stable_as_of": 1715600400000,
    "is_stable": true
  }
}

The layer block

Field	Meaning
stable_as_of	Epoch-ms watermark from the most recent stable poll. Null on cold start before the watcher has observed a stable namespace.
is_stable	Whether the most recent poll observed index.status == "up-to-date". False on cold start, true once the watcher catches up.

is_stable is the current signal — it drives the per-query filter-skip decision on the query path. stable_as_of is the historical watermark — the cut a filtered query would apply.

For snapshot history derived from these freshness signals, see Snapshots.