Get one evaluation record
One evaluation of any document in the namespace, any incarnation and
any judgment, with its compiled context and the engine’s raw response. Shadow evaluations are included, marked shadow. Unlike a
document’s history, it is found by id alone.
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.
Path 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._:/-]+$The evaluation id, ev_ and a ULID.
^ev_[0-9a-z]{26}$Response
The evaluation, with context and raw.
An immutable record of one computation.
Up to 128 bytes. Never exactly . or .., which a URL path can't carry.
1 - 128^(?!\.\.?$)[A-Za-z0-9._:/-]+$x >= 0x >= 0A judgment, attribute or threshold name. Names are path segments in field references, so they never contain ..
1 - 128^[A-Za-z0-9_-]+$x >= 1^sha256:[0-9a-f]{64}$x >= 0The engine's numbers. Null when the evaluation failed.
success, failed Why the evaluation failed. Null on success.
True for shadow evaluations from activation reports, which never produce answers.
For a replay after a Jev drift, the evaluation whose stored context it judged again in the new epoch: its context is that evaluation's, so it has none of its own. Replays recalibrate the new epoch; they never produce answers and are never billed. Null for every other evaluation.
RFC 3339, UTC.
How long the engine request that produced it took, retries excluded. Absent for evaluations recorded before it was measured.
x >= 0Entity judgments only. The log position the context was read at.
x >= 0Entity judgments only. How far the context had read other judgments' answers and block changes, beside watermark, as on the answer.
x >= 0Entity judgments only, beside answers_generation. True when a document whose answers the context read had a newer revision still pending, so its last answer was rendered. Wait it out rather than act on it, since that document's new answer re-judges this one if it changes what a relation shows.
Entity judgments only, with
include=history,context or from GET .../evaluations/{id}.
Every related document the context read, rendered or aggregated,
with the revision it was read at.
For a recipe with previous, the revision the previous rendering came from; absent with first_revision.
x >= 0For a recipe with previous, true when the context showed nothing under previous, such as a document's first evaluation in its incarnation or a re-created id, and then previous_revision is absent. Absent for a recipe without previous.
With include=history,context, the compiled context the engine saw.
With include=history,raw, the engine's answer to this judgment alone, in the shape of output. It never carries other judgments' answers or the engine's token counts.