v3

OpenAPI 3.1.02026-07-31350397683.8 KB

Self-Improve

Start Run

Start a self-improve run. Confirm-gated: call once to preview, then again with confirmed=true.

post/v1/self-improve/runs

X-API-Keystring required

API key required to authenticate requests.

agent_idinteger required

VAPI agent to self-improve in place (prompt iterated; one new 'latest' version written at the end).

simulation_idinteger required

Simulation (digital humans + metrics) to run each round against the agent.

target_pass_ratenumber

max_iterationsinteger

min_improvementnumber

Minimum pass-rate gain to keep an iteration; non-negative so worse prompts are never kept.

metric_countinteger

success_metric_idsstring[] nullable

Reuse these metrics instead of generating new ones.

confirmedboolean

Successful Response

{"stackTrail":"paths:/v1/self-improve/runs:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}