API: Namespace Metadata
Retrieve metadata about a specific namespace.
Endpoint
GET /v1/namespaces/:namespace/metadataResponse
{
"schema": {},
"approx_logical_bytes": 0,
"approx_row_count": 500,
"created_at": "2026-02-26T00:00:00Z",
"updated_at": "2026-02-26T00:00:00Z",
"index": {
"status": "indexing"
},
"performance": {
"cache_hit_ratio": 0.85,
"cache_temperature": "warm",
"server_total_ms": 3,
"query_execution_ms": 1
}
}
Fields
| Field | Type | Description |
|---|---|---|
schema | object | Namespace schema (reserved for future use) |
approx_logical_bytes | number | Approximate total logical size in bytes |
approx_row_count | number | Approximate number of rows |
created_at | string | ISO 8601 creation timestamp |
index.status | string | Index status: "empty", "indexing", or "ready" |
performance | object | Cache and latency performance info |
Example
const meta = await ns.metadata();
console.log(Rows: ${meta.approx_row_count});
console.log(Index: ${meta.index.status});