---
title: "Permanently delete a team and revoke all its keys"
method: DELETE
path: "/api/control/teams/{world}"
tags: ["Operator"]
---

# Permanently delete a team and revoke all its keys

`DELETE /api/control/teams/{world}`

## Request

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

Requires the exact canonical teamName shown in the team directory. Removes the selected team's world, records, events, receipts and request history, and revokes every key for that world. Shared population baselines and other teams are preserved. Confirmation mismatch returns 409; default and unknown worlds return 404. Reusing the name after deletion creates a fresh world.

## Path parameters

- `world` string, required

## Request body

- object
  - `confirmTeamName` string, required

## Response `200`

Success

- object
  - `deleted` unknown, 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)