---
title: "Delete a simulation scenario"
method: DELETE
path: "/v1/{organization}/simulation/scenario/{simulation_scenario_id}/"
tags: ["Simulation"]
---

# Delete a simulation scenario

`DELETE /v1/{organization}/simulation/scenario/{simulation_scenario_id}/`

Delete a simulation scenario. This endpoint only soft-deletes the simulation scenario so any existing references to it would still be valid.
However, they cannot be used in any new simulations.

This endpoint will error if the simulation scenario is used in any simulation unit tests.

#### Permissions
This endpoint requires the following permissions:
* `Simulation:DeleteSimulationScenario` on the simulation scenario to delete.

## Path parameters

- `organization` string, required
- `simulation_scenario_id` string, required — The ID of the simulation scenario to delete.

## Headers

- `x-mongo-cluster-name` string, nullable — The Mongo cluster name to perform this request in. This is usually not needed unless the organization does not exist yet in the Amigo organization infra config database.
- `Sec-WebSocket-Protocol` string[]

## Response `204`

Succeeded

## Other responses

- `400` — The specified simulation scenario is used in a simulation unit test.
- `401` — Invalid authorization credentials.
- `403` — Missing required permissions.
- `404` — The specified organization or simulation scenario does not exist.
- `422` — Invalid request path parameter failed validation.
- `429` — The user has exceeded the rate limit of 500 requests per minute for this endpoint.
- `503` — The service is going through temporary maintenance.

---

[API](https://skmtc.net/amigo/apis/amigo-api.md) · [All operations](https://skmtc.net/amigo/apis/amigo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/amigo/amigo-api/revisions/f0f28319e448/schema)