Update Run Test Components
Change the agent definition, agent version, simulator agent, scenarios, or tool evaluation setting of an existing test run. Returns the updated test run
https://api.futureagi.com/simulate/run-tests/{run_test_id}/components/ Authentication
Path parameters
UUID of the test run to update.
Request body
UUID of the agent definition to test. The test run switches to that agent’s latest version.
UUID of the agent version to pin. It must belong to the test run’s agent definition, including one set by agent_definition_id in the same request.
UUID of the simulator agent that plays the customer.
Scenario UUIDs to run, each listed once. The list replaces the test run’s current scenarios. Send an empty array to remove them all.
Turns tool call evaluation on or off. While it is on, the test run’s agent version must have an API key and an assistant ID for voice agents.
Send only the fields you want to change. A field not listed above is rejected with 400.
Response
200 OKUUID of the test run.
Display name of the test run.
Description of the test run, or empty string if none provided.
UUID of the associated agent definition, or null if using a prompt template.
UUID of the specific agent version, or null if using the active version.
Expanded agent definition details, or null if none associated.
Either agent_definition or prompt.
Human-readable source type label.
UUID of the associated prompt template, or null if using an agent definition.
Expanded prompt template details, or null if none associated.
UUID of the specific prompt version, or null if none specified.
Expanded prompt version details, or null if none specified.
Array of linked scenario UUIDs.
Expanded scenario objects with full details.
Specific dataset row UUIDs this test run is restricted to. Empty array means all rows.
UUID of the custom simulator agent, or null if using the default.
Expanded simulator agent details, or null if none assigned.
Array of associated evaluation configuration UUIDs.
Expanded evaluation configuration objects.
Combined evaluation details for all configured evaluations.
Whether tool evaluation is enabled.
ISO 8601 creation timestamp.
ISO 8601 last-modified timestamp.
ISO 8601 timestamp of the most recent execution, or null if never executed.
Errors
A field is invalid or not recognized. Or tool evaluation is on for the test run after the update and its agent version has no API key or assistant ID, or the test run has no agent version (API_KEY_AND_ASSISTANT_ID_REQUIRED). This check runs on every update while tool evaluation is on, not only when the request turns it on.
Missing or invalid X-Api-Key or X-Secret-Key headers.
The test run, agent definition, agent version, simulator agent, or one of the scenarios was not found in your organization. A scenario UUID repeated in scenarios also returns 404.
Unexpected server error. Contact support if it persists.