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. Never exactly . or .., which a URL path can't carry.

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. Never exactly . or .., which a URL path can't carry.

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, because spend reached it or the next engine request would have passed it. Meanwhile a changed document's answer reads stale with stale_reason judging_paused, and a document never judged reads unavailable; on_change judgments judge them once the budget is raised or the next billing period starts.

pinned
boolean
required
default_engine
object | null
required

An engine and its version, which must be active in GET /engines: an exact version, or Jev's current, which runs whatever model the provider serves now and records the epoch of behaviour behind each answer in its engine_version, such as current+2026-09-24.1. There are no other aliases.

deleting
boolean
required
stats
object
required
fanout
object

The fan-out settings in effect, every key present.