Skip to main content

Managing Simulations

Simulations are isolated Sandbox environments that host your mock API endpoints. This guide covers creating, configuring, and managing simulations through the web application.

Creating a Simulation​

  1. Click New Simulation from the dashboard
  2. Fill in the simulation details:
    • Name - A descriptive name for the simulation
    • Description (optional) - What this simulation models
    • Base path - The URL prefix for all routes (e.g., /api/v1)
    • Protocol - HTTP/HTTPS (default), or multi-protocol
  3. Click Create

Your simulation is assigned a unique URL:

https://<simulation-id>.srstg.io/<base-path>

Simulation Settings​

Access settings via the gear icon on any simulation:

General​

  • Name & description - Update simulation metadata
  • Base path - Change the URL prefix (caution: breaks existing consumers)
  • Tags - Categorize simulations for organization

Behavior​

  • Default response delay - Add simulated latency to all responses (ms)
  • CORS configuration - Control cross-origin access
  • Request logging - Enable/disable request capture for debugging

State​

  • State management - Enable/disable stateful mocking
  • Reset state - Clear all state data for this simulation
  • State snapshot - Save/restore state at a point in time

Simulation Lifecycle​

ActionDescription
StartActivate the simulation to accept requests
StopDeactivate without deleting configuration
ResetClear all state and logs, keep configuration
CloneCreate a copy with all routes and settings
DeletePermanently remove the simulation

Live Request Log​

The request log shows real-time traffic hitting your simulation:

  • Request method, path, and timestamp
  • Response status code and latency
  • Request/response headers and body
  • Match details (which route and response was selected)

Use the request log to:

  • Debug routing issues
  • Verify mock behavior
  • Monitor test traffic during development

Next Steps​