Metadata

GET /v1/namespaces/:namespace/metadata

Gets metadata about a namespace.

Billing

This request is billed as a query that returns zero rows.

Response

schema object

See the schema documentation.

approx_logical_bytes integer

The approximate number of logical bytes in the namespace.

This is a coarse approximation and may change over time as turbopuffer's data representation evolves.

approx_row_count integer

The approximate number of rows in the namespace.

created_at string

The timestamp when the namespace was created, in ISO 8601 format.

Example: "2024-03-15T10:30:45Z"

Example

// GET /v1/namespaces/:namespace/metadata

// Response payload
{
  "schema": {
    "id": {
      "type": "uint"
    },
    "my-number": {
      "type": "uint",
      "filterable": true,
      "full_text_search": null
    }
  },
  "approx_size_bytes": 4398046511104,
  "created_at": "2024-03-15T10:30:45Z"
}