---
title: "Permanently delete selected teams in one transaction"
method: POST
path: "/api/control/teams/delete"
tags: ["Operator"]
---

# Permanently delete selected teams in one transaction

`POST /api/control/teams/delete`

## Request

- Base URL: `https://sim.animahealth.com`
- URL: `https://sim.animahealth.com/api/control/teams/delete`
- Auth: HTTP bearer

Submit the world IDs and canonical names reviewed in the confirmation. The UI supplies names automatically; no manual typing is required. Validates every team before deleting any. Missing, renamed or duplicate targets reject the entire request. Revokes all selected team keys and removes their worlds and request history. Shared baselines and unselected teams remain intact.

## Request body

- object
  - `teams` object[], required
    - `world` string, required
    - `confirmTeamName` string, required

## Response `200`

Success

- object
  - `deleted` unknown, required
  - `teams` object[], required
    - `world` string, required
    - `teamName` string, required

## Other responses

- `400`: Invalid input or unsupported workflow
- `401`: Missing or invalid credentials
- `403`: Scope, origin or operator restriction
- `404`: Unknown resource
- `409`: Stale version, invalid transition or unavailable capacity
- `413`: Request exceeds this operation's body-size limit
- `429`: Deployment has reached its 5,000-team capacity
- `500`: Internal simulation error

---

[API](https://skmtc.dev/animahealth/apis/nhs-sim-api.md) - [All operations](https://skmtc.dev/animahealth/apis/nhs-sim-api/llms.txt) - [OpenAPI document](https://skmtc.dev/animahealth/apis/nhs-sim-api/revisions/c7803d7a3e58?raw)