---
title: "trigger registered load scenario(s) to run"
method: PUT
path: "/mockserver/loadScenario/start"
tags: ["loadgen"]
---

# trigger registered load scenario(s) to run

`PUT /mockserver/loadScenario/start`

## Request

- Base URL: `http://localhost:1080`
- URL: `http://localhost:1080/mockserver/loadScenario/start`
- Auth: none declared

Triggers one or more registered load scenarios to start running concurrently. Each gets a fresh run id and honours its own startDelayMillis (a positive delay → the scenario is PENDING until the delay elapses, then RUNNING). Requires loadGenerationEnabled=true (else 403). 404 if a name is not registered. Rejected with 400 if it would exceed loadGenerationMaxConcurrentScenarios (default 10). Re-triggering an already-active name replaces that run.

## Request body

- object
  - `names` string[]
  - `name` string

## Response `200`

load scenario(s) triggered

- object
  - `status` 'started'
  - `started` object[]
    - `name` string
    - `state` 'PENDING' | 'RUNNING'

## Other responses

- `400`: bad request (no names given, or the concurrent-scenario cap would be exceeded)
- `403`: load generation not enabled (set loadGenerationEnabled=true)
- `404`: one of the named scenarios is not registered

---

[API](https://skmtc.dev/mock-server/apis/mockserver-api.md) · [All operations](https://skmtc.dev/mock-server/apis/mockserver-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mock-server/apis/mockserver-api/revisions/9239b693996e?raw)