Skip to main content
POST
Create an evaluation

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

org
string
required

Body

application/json
context
EvaluationContextInput · object
required
policy
InlinePolicyInput · object
required

The policy to evaluate: its files inline, or the identifier of a published one

params
Params · object

Values the policy reads as data.params. Checked against a published version's params schema; inline params are not checked

decision
DecisionInput · object | null

Record the outcome as a decision against a control. Absent, the evaluation stands alone and writes nothing to a trail. Only a published policy can record a decision

Response

Successful Response

id
string
required

Server-minted id of the evaluation

status
enum<string>
required

Whether the evaluation has run, and if so whether it recorded a result or an error

Available options:
pending,
completed,
failed
requested_at
number
required

When the evaluation was asked for

recorded_at
number
required

The instant on the recorded-time axis that every trail in the context resolves at

context
EvaluationContextResponse · object
required

What the evaluation was asked about

policy
EvaluationPolicyResponse · object
required

The policy version the evaluation runs

result
Result · object | null

The policy's output, present only when completed

error
EvaluationErrorResponse · object | null

Why the evaluation failed, present only when failed

opa_version
string | null

Version of the OPA evaluator that ran the evaluation, or unreported where it did not say. Absent while pending, and where the evaluation failed before reaching an evaluator

decision_attestation_id
string | null

Id of the decision attestation this evaluation wrote, present only where one was asked for and has been written. Address it with the attestation_id filter when listing attestations

decision
EvaluationDecisionResponse · object | null

Where the outcome is recorded as a decision, present only where one was asked for

Last modified on October 30, 2026