Detach an inherited judgment from its template
Turns a judgment the namespace inherits from a template into an ordinary judgment of the namespace, a copy of the current version. The copy keeps the template’s version numbers, up to and including the active version, which stays active, so existing answers still name a version the judgment has. Its thresholds and freshness settings are the ones the namespace had, override or inherited. It no longer follows the template. Answers and evaluations stay where they are. Detaching a judgment the namespace already owns changes nothing and returns it, so a retry is safe. Takes no body.
Authorizations
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
One key per logical request, reused only on its retries. A key
belongs to one request: within your organization, the same method,
path, query and body. For 24 hours after a successful response, a
request with the key and the same body gets that response back
verbatim, with Idempotent-Replayed: true, and runs nothing. Only a
successful response is kept, so the retry of a request that failed
runs again. While the first request runs or its response is kept,
the key with a different request is idempotency_key_reused (422).
A request sent while one with its key is still running is
rate_limited with Retry-After: 1, without running: retry it to
get the first one's response. In the rare case the key can't be
checked, the request runs as if it had none.
1 - 255Path Parameters
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.
1 - 256^(?!\.\.?$)[A-Za-z0-9._:/-]+$A judgment, attribute or threshold name. Names are path segments in field references, so they never contain ..
1 - 128^[A-Za-z0-9_-]+$Response
The judgment, now the namespace's own.
A judgment, attribute or threshold name. Names are path segments in field references, so they never contain ..
1 - 128^[A-Za-z0-9_-]+$Null once the judgment is deactivated.
x >= 1Settings, not part of the definition. Changing them creates no version.
The judgment's named thresholds, a setting rather than part of a
version. 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.
How the judgment's outcomes are read and derived, a setting rather than part of a version. See calibration.
Every version, oldest first. Versions are kept until the namespace is deleted.
Present when the judgment is inherited, the template prefix it comes from, such as acme/prod/*.
1 - 256^(?!\.\.?$)[A-Za-z0-9._:/-]+(/\*)?$Present when the judgment is inherited. The settings this namespace overrides; the others follow the template.
thresholds, freshness 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.
Response only. How much of
freshness.fanout.rolling_limit the judgment's fan-outs have used:
the re-judgments counted in the rolling 30-day window. Present
exactly when freshness.fanout is. A fan-out that would take used
past the limit is deferred.
A setting of a fixed-option choice: when the
share of its answers over the last 7 days that are
none_of_the_above rises above this, the judgment gains the
taxonomy_drift warning and the events feed one
judgment.taxonomy_drift. Null (the default) turns it off. Nothing
changes on its own: run discover when you want proposals.
0 < x <= 1Conditions to act on, such as taxonomy_drift. Absent when there are none.
The judgments whose relations read this one's answers. While there are any, deleting or deactivating it, a policy other than on_change, or a version that is not plain or narrows applies_to below a reader's match is conflict naming them. Absent when there are none.
A judgment, attribute or threshold name. Names are path segments in field references, so they never contain ..
1 - 128^[A-Za-z0-9_-]+$Today's evaluations of the judgment in this namespace, UTC. The dashboard's per-judgment numbers. Before the day's
first evaluation only day, evaluations (0) and spend_usd (0)
are present.