Preview monitor content-filter matches
Read-only preview for a CANDIDATE monitor config: how many and which recent past sessions the given content filter and sampling percentage would select, over a trailing window. Runs no evaluations, spends no credits, and writes nothing (no processed marks). Use it while creating or editing a monitor. The match count is exact; for a create preview (no monitorId) the sampled subset is representative, not the exact set the created monitor will draw.
Authorizations
API key authorization. Pass your API key in the Authorization header as a Bearer token. Both new (gsk_*) and legacy (gsk-) API keys are accepted, e.g. Authorization: Bearer gsk_... or Authorization: Bearer gsk-....
Body
Product whose recent production sessions the preview scans.
"prod_123"
Candidate sampling percentage (greater than 0, at most 100).
0 < x <= 10010
Optional version to narrow the preview to. Null previews the whole product.
"version_123"
Candidate content filter. Null means every recent session matches (sampling only).
500"refund"
Which side of a turn filterQuery matches against. Set together with filterQuery.
INPUT, OUTPUT, EITHER "EITHER"
Candidate exclude filter. Comma-separated terms; a session is dropped when a turn whose chosen target (excludeTarget) contains ANY term. Null excludes nothing. Set together with excludeTarget. Independent of filterQuery.
500"test, internal"
Which side of a turn excludeQuery matches against. Set together with excludeQuery.
INPUT, OUTPUT, EITHER "EITHER"
Trailing window in days to look back over (default 90, max 90).
1 <= x <= 9090
Existing monitor id when previewing an EDIT, so sampling uses its real seed (exact). Omit for a create preview (representative sampling).
"monitor_123"
Response
Preview computed successfully
Read-only preview of how many and which recent past sessions a candidate monitor content filter and sampling percentage would select. No evaluations run and no credits are spent.
Recent closed production sessions considered (bounded by the window and an internal cap).
500
Sessions whose content matched the candidate filter (exact; a null filter matches every candidate).
120
Matched sessions that also fell in the sampling fraction.
12
True for a create preview (no monitorId): the sampled subset is representative, computed from a placeholder seed. The match count is always exact.
true
The would-be-selected sessions, most-recent first (capped at 100).