Suggest a Fix for a Run
Ask for one prompt change that would make every failed test in a run pass.
Requesting a fix per attempt produces separate prompts that do not know about each other, and applying one can undo another. This endpoint analyzes all of the run’s failed attempts together and returns a single corrected prompt with a per-attempt breakdown, so failures that share a root cause get one coherent edit.
The wait, polling, and reuse behavior is identical to the per-attempt Suggest a Fix: the request waits up to 105 seconds, wait=0 returns status: running immediately for polling with Get Suggested Fix for a Run, asking again joins a preparation already in progress, and a suggestion prepared within the last 10 minutes is returned instantly.
The run must be finished and must contain at least one failed attempt. On runs with more than 12 failures, the most recent 12 are analyzed and the rest are listed in result.skippedAttemptIds.
Authorizations
API key for authentication. Generate API keys from the RevRing dashboard.
Query Parameters
Set to 0 to return immediately instead of waiting for the suggestion.
0 Response
The suggestion, when it was ready in time. The suggestion fields are also present at the top level of data.
A proposed prompt change covering every failed attempt in a test run.