View as markdown
Endpoints · Universes

Delete a universe

DELETEhttps://api.tickerbot.io/v2/universes/{id}

Permanently delete one of your universes.

Body parameters

stringrequired

Universe slug.

booleandefault false

A universe still referenced by live webhooks refuses to delete with 409 universe_referenced. Pass force=true to delete anyway — those webhooks will match nothing until re-pointed or deleted.

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.
409
universe_referenced — webhooks still reference this universe; re-point or delete them, or pass ?force=true.

Notes

  • System universes (top_10, top_100) cannot be deleted and return 403 system_universe_immutable.
  • If webhooks still reference the universe the delete is refused with 409 universe_referenced, listing them, unless you pass ?force=true. A forced delete leaves those webhooks matching nothing — each eval records a last_error on the webhook — until they are re-pointed or deleted.