Skip to main content
POST
Detach an inherited judgment from its template

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.

Headers

Idempotency-Key
string

Returns the original response verbatim while the node still caches it. Correctness never depends on it.

Minimum string length: 1

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._:/-]+$
name
string
required

A judgment, attribute or threshold name. Names are path segments in field references, so they never contain ..

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

Response

The judgment, now the namespace's own.

name
string
required

A judgment, attribute or threshold name. Names are path segments in field references, so they never contain ..

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9_-]+$
active_version
integer<int32> | null
required

Null once the judgment is deactivated.

Required range: x >= 1
freshness
object
required

Settings, not part of the definition. Changing them creates no version.

thresholds
object
required

The judgment's named thresholds, a setting rather than part of a version (§6.5). Each is a number for a bool judgment (true when p is at least it) or a score judgment (true when score is at least it), and {value, gte} for a choice judgment (true when dist[value] is at least gte). They are evaluated at read time against the raw fields, never the calibrated ones. A threshold that does not fit the judgment's type is invalid_request.

versions
object[]
required

Every version, oldest first. Versions are retained forever.

template
string

Present when the judgment is inherited, the template prefix it comes from, such as acme/prod/* (§7.7).

Required string length: 1 - 256
Pattern: ^[A-Za-z0-9._:/-]+(/\*)?$
overrides
enum<string>[]

Present when the judgment is inherited. The settings this namespace overrides; the others follow the template (§7.7).

Available options:
thresholds,
freshness
fanout_sources
object

Entities, E3a (§6.5.2). Where each value in freshness.fanout comes from, key for key. Present exactly when freshness.fanout is. A where removed with null is the default, no filter; any other null the judgment set, such as created_within: null, is the judgment's.