v7

latestOpenAPI 3.1.02026-08-08356409701.0 KB

Red-Team Simulations

Start Simulation

Start a red-team test. Confirm-gated: call once to preview, then again with confirmed=true.

post/v1/red-team-simulations

Headers

X-API-Keystring required

API key required to authenticate requests.

Request body

agent_idinteger required

Target agent to red-team.

configobject nullable

Overrides for max_levels/max_branches_per_node/max_total_dhs/max_call_duration_minutes/recon_count/objective/extension/harm_categories/harm_first. Clamped to the mandatory ceilings. Content-safety probes run by default; pass harm_categories=[] for an OWASP-only test.

confirmedboolean

Response

Successful Response

{"stackTrail":"paths:/v1/red-team-simulations:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}