Self-Improve
POST /v1/self-improve/runs
Start a Self-Improve run.
POST /v1/self-improve/runs
Starts a loop that changes the agent prompt, pushes it to the provider, and runs the simulation to score it. At the end, Bluejay saves the best prompt as one new
latest version. The previous version stays. The production label does not move.
Confirm the run
- Send the request without
confirmed. The response hasneeds_confirmation: trueand apreviewtext. Nothing runs. - Send the same request with
confirmed: true. The response hasrun_id.
Limits
- The agent must be a Vapi, ElevenLabs, or Retell agent with a provider ID. Other agents return 400.
max_iterationsis 5 by default and 20 at most.metric_countis 5 by default and 20 at most.- One agent can have one active run. A second run returns 409.
Headers
Request body
Response
A200 response has no body.
Status codes
Example request
Last modified on October 21, 2026