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

# Delete a simulation persona

`DELETE /v1/{organization}/simulation/persona/{simulation_persona_id}/`

Delete a simulation persona. This endpoint only soft-deletes the simulation persona 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 persona is used in any simulation unit tests.

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

## Path parameters

- `organization` string, required
- `simulation_persona_id` string, required — The ID of the simulation persona 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 persona is used in a simulation unit test.
- `401` — Invalid authorization credentials.
- `403` — Missing required permissions.
- `404` — The specified organization or simulation persona does not exist.
- `422` — Invalid request path parameter failed validation.
- `429` — The user has exceeded the rate limit of 100 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)
