agents

Dry Run Agent

Render what this agent WOULD send to specific (or sampled) real customers, with the per-customer fire/suppress decision. Read-only: nothing is persisted or sent. Powers the "preview against N people" UI and the golden snapshot tests.

post/api/v1/agents/{agent_id}/dry-run

Path parameters

agent_idstring uuid required

Headers

authorizationstring nullable

Bearer <token>

Bearer <token>

Request body

customer_idsstring[]
sample_sizeinteger
renderboolean
copy_modestring nullable

Response

Successful Response

Changes

Changed in 1 of the 2 revisions of this API.2

    • the meta response's property default value changed from {"request_id":"","timestamp":"2026-09-01T18:59:27.102736"} to {"request_id":"","timestamp":"2026-09-02T16:58:28.431377"} for the status 200

      response-property-default-value-changed

    • the timestamp response's property default value changed from 2026-09-01T18:59:27.102736 to 2026-09-02T16:58:28.431377 for the status 200

      response-property-default-value-changed