v43

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

Evaluate Response

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

Analyzes an LLM response payload for security threats after it is received from the model.

Accepts any valid provider response payload and returns:

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

Use this endpoint inline in your LLM pipeline to evaluate model outputs before returning them to users.

Supported provider formats:

post/detection/v2/response-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 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.