# DELETE /v2/universes/{id}

**Delete a universe**

Permanently delete one of your universes. System universes (`top_10`, `top_100`) cannot be deleted — they return `403 system_universe_immutable`. Subscribed webhooks that reference the deleted universe will fail on their next eval with `unknown_universe`; clean them up first via `/v2/webhooks/{id}` and re-subscribe.

## Plan access

- **Plan access.** Included on every plan.
- **Rate limit.** Hobby 600/min · Pro 2,000/min · Scale 10,000/min.
- **Capacity.** Unlimited on every paid plan.

## Body parameters

| Name | In | Type | Required | Description |
|------|----|----|----------|-------------|
| `id` | path | string | yes | Universe slug. |

## Status codes

- **204** — Deleted.
- **400** — Invalid universe slug format.
- **403** — `system_universe_immutable` — system universes are read-only.
- **404** — `not_found` — slug doesn't match any of your universes.

## Examples

### Delete

Request:

```shell
curl -X DELETE "https://api.tickerbot.io/v2/universes/my_watchlist" \
  -H "Authorization: Bearer YOUR_KEY"
```

---

Interactive sandbox + parameter editor: https://tickerbot.io/docs/endpoints/universes/delete