v43

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-0953227392.1 KB
interactions-v2_other

Evaluate Request

[BETA] This endpoint is not GA or Production ready and is subject to changes at any time. Breaking changes may occur.

Analyzes an LLM request payload for security threats before it is sent to the model.

Accepts any valid provider request payload and returns:

  • If detect or redact action: the request payload (potentially modified) in the provider's request format
  • If block action: a canned block message in the provider's response format

Use this endpoint inline in your LLM pipeline to evaluate prompts before they reach the model.

Supported provider formats:

post/detection/v2/request-evaluations

Headers

HL-Project-Idstring

The ID or alias for the Project to govern the request processing.

HL-Runtime-Session-Idstring

An externally-defined session identifier to group interactions in separate requests into a single session. The identifier should be unique across the all sessions.

Request body

ProviderPayload required

A pass-through payload in the native format of the LLM provider. Any valid provider request or response payload is accepted as-is and returned in the same format.

Response

Successful evaluation. Returns the (potentially modified) provider request payload, or if a block action was taken, a provider response payload.

ProviderPayload required

A pass-through payload in the native format of the LLM provider. Any valid provider request or response payload is accepted as-is and returned in the same format.