Skip to main content
POST
Scan a URL for security threats using a specific policy.
Archived: This endpoint is legacy. Use the new Guardrail Scan URL endpoint instead, which supports separate input/output detectors via X-Enkrypt-Mode.

Authorizations

apikey
string
header
required

Headers

X-Enkrypt-Policy
string
required

Name of the policy to apply

Body

application/json
url
string<uri>
required

The URL to scan and analyze.

user_metadata
object

Optional arbitrary metadata object echoed back in the response. Limits: at most 16 top-level keys, key names up to 64 characters, nesting depth up to 3, total serialized size up to 4 KB. When provided and valid, this object is also echoed as a top-level user_metadata key on error responses (4xx/5xx) of endpoints that accept it; invalid or oversized metadata is never echoed, including on the 422 response it causes.

Example:

Response

200 - application/json

Scan results for the provided URL using the specified policy.

summary
object
required

Summary counts of detections by detector type.

details
ScanUrlDetails ยท object
required

Detailed scan results including URL metadata and fragment-level information.

user_metadata
object

Optional arbitrary metadata object echoed back in the response. Limits: at most 16 top-level keys, key names up to 64 characters, nesting depth up to 3, total serialized size up to 4 KB. When provided and valid, this object is also echoed as a top-level user_metadata key on error responses (4xx/5xx) of endpoints that accept it; invalid or oversized metadata is never echoed, including on the 422 response it causes.

Example: