Suggest a Fix
Ask for a prompt change that would make a failed test attempt pass.
Preparing a suggestion takes time, especially for agents with long prompts, so this starts the work and waits up to 105 seconds. If the suggestion is ready in that time it is returned directly; if not, the response is status: running and you fetch it with Get Suggested Fix.
Pass wait=0 to skip the wait and always get status: running straight away. This is the recommended pattern, because the request never depends on how long preparation takes.
Asking again while a suggestion is already being prepared joins the one in progress instead of starting another, and a suggestion prepared within the last 10 minutes is returned immediately, so repeating a request after a timeout is instant. Suggestions are available for failed attempts only.
Authorizations
API key for authentication. Generate API keys from the RevRing dashboard.
Path Parameters
Test suite ID
Test attempt ID, from a test run's attempts
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 that would make a failed test pass.