Classify an event
Return a Firewall verdict for one complete event.
text. For multiple independent events, use batch classification.
Use your provisioned SILMARIL_API_URL as the full request URL. Inspect prediction and optional governance.action before consuming the event.
Choose cURL, TypeScript, JavaScript, Python, Go, or Java in the request examples. They use standard HTTP libraries; the Java example requires Java 17 or later.
BENIGN. See confidence scores for interpretation and threshold behavior.
Handle the verdict
HTTP200 returns a classification. In Block mode, stop an event when prediction is MALICIOUS or governance.action is block. In Warn or Shadow mode, record the would-block decision and continue.
Handle request failures with your application’s error policy. See modes and enforcement for the full decision model.
Optional review depth
The optional top-levelreview field accepts standard or deep. See review depth for requirements, selection behavior, and acknowledgement rules.Body
One complete event to classify. Input-size limits depend on your deployment.
1"Summarize this release note."
Optional request-wide review selection. standard selects standard review. deep requests an additional review of eligible potentially harmful events when available on your deployment. An event may complete without additional review. Omit review to inherit the deployment default. Review depth is independent of enforcement mode.
standard, deep "deep"
Response
One verdict. A malicious or governance-blocked result still returns HTTP 200.
Score from 0 to 1 expressing confidence in the model assessment as harmful, safe, or uncertain. A high-confidence safe assessment can return BENIGN. Where present, malicious_score is an alias. Route on prediction and applicable governance.action. See confidence scores.
0 <= x <= 1Threshold reported by the deployment. The configured confidence threshold applies to potentially harmful events with available confidence, using the value before display rounding; equality passes. Your policy determines how results below the threshold are handled. See confidence scores.
0 <= x <= 1Optional forward-compatible outcome detail. The examples are known legacy labels, not a closed enum. Prediction remains authoritative; a missing or unknown malicious outcome should be blocked by default in Block mode.
"benign"
"information_disclosure"
"secret_exposure"
"control_abuse"
"system_compromise"
"service_disruption"
On a single response, this top-level field acknowledges an explicit request selection. Within a batch prediction, this field is not the batch acknowledgement; use BatchResponse.review. It confirms the applied setting. An event may complete without additional review.
standard, deep "deep"