---
title: "remove one registered load scenario"
method: DELETE
path: "/mockserver/loadScenario/{name}"
tags: ["loadgen"]
---

# remove one registered load scenario

`DELETE /mockserver/loadScenario/{name}`

## Request

- Base URL: `http://localhost:1080`
- URL: `http://localhost:1080/mockserver/loadScenario/{name}`
- Auth: none declared

Removes a single load scenario from the registry, stopping it first if it is running.

## Response `200`

load scenario removed (or absent)

- object
  - `status` 'deleted' | 'absent'
  - `name` string

## Other responses

- `400`: failed to delete load scenario

---

[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)