Skip to main content
GET
Get namespace metadata, counts and budget

Authorizations

Authorization
string
header
required

An organization API key. Keys carry a role (read_write or read_only) and may be restricted to a namespace prefix such as acme/*, or to one namespace such as acme/prod/tenant_1. A prefix matches on a / boundary: acme/prod/tenant_1* covers acme/prod/tenant_1 and everything under acme/prod/tenant_1/, never acme/prod/tenant_12.

Path Parameters

ns
string
required

The namespace name, with any / sent as %2F. Up to 256 bytes. / separates levels of the hierarchy, as in acme/prod/tenant_123.

Required string length: 1 - 256
Pattern: ^[A-Za-z0-9._:/-]+$

Response

The namespace.

name
string
required

Up to 256 bytes. / separates levels of the hierarchy, as in acme/prod/tenant_123.

Required string length: 1 - 256
Pattern: ^[A-Za-z0-9._:/-]+$
created_at
string<date-time>
required

RFC 3339, UTC.

budget
object | null
required
budget_paused
boolean
required

True while evaluation is paused by the budget.

pinned
boolean
required
default_engine
object | null
required

An exact engine version. No aliases.

deleting
boolean
required
stats
object
required
fanout
object

Entities, E3a (§6.11). The fan-out settings in effect, every key present.