Prepare And Run Suite

Execute a test suite and start simulations immediately.

This endpoint combines suite preparation and execution in a single operation:

  1. Creates a test run record
  2. Generates simulation and evaluation records for all test case combinations
  3. Immediately starts executing simulations in the background

This is more efficient for running tests because it combines the prepare and run steps into a single operation, reducing the number of API calls and minimizing overall execution time.

What Happens After Request

  1. Test run is created and assigned a unique ID
  2. All scenario-persona combinations are prepared as individual simulations
  3. Simulations begin executing in the background
  4. Results become available as simulations complete
  5. Optional webhook notification sent when all simulations finish

Testing Modes

The response includes a testing_mode field indicating the type of testing:

  • voice - Voice AI agent testing with audio conversations (outbound or inbound)
  • text - Text-based chat agent testing with message exchanges
  • human - Human-in-the-loop testing where real people interact with the agent
Language
Credentials
Bearer
JWT
Click Try It! to start a request and see the response here!