Skip to main content
POST
Evaluate policies
Evaluates all active policies that match the given action and target against the provided input. Use this endpoint to test how your policies behave before activating them in production. The response includes which rules matched, whether the request would be allowed, and a decision_id for audit trail queries.
The reasons field is only populated when the request is denied. Allowed responses return an empty array. If you previously relied on evaluation_ms for performance monitoring, that field has been removed — query resource_type=policy_decision in the decision audit trail instead.
Every evaluation is recorded in the audit log with a SHA-256 hash of the input for tamper-evidence. Use the decision_id to look up the decision in audit queries.

Responses

Response fields

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Body

application/json
action
string
input
object
target_id
string<uuid> | null
target_type
string

Response

Evaluation result

decision
enum<string>
Available options:
ALLOW,
DENY
matched_policy
string | null
matched_rule
string | null
reason
string