tickerbot.io

Delete a universe

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

Permanently deletes one of your universes.

stringrequired

Universe slug.

booleandefault false

A universe that any of your webhooks references (active or disabled) refuses to delete with 409 universe_referenced, listing them in referencing_webhooks. Pass force=true to delete anyway; those webhooks are disabled at their next evaluation.

CodeMeaning
204Deleted.
400Invalid universe slug format, or an invalid force value (accepted: true/1/yes, false/0/no).
403system_universe_immutable: built-in universes are read-only.
404not_found: the slug matches none of your universes.
409universe_referenced: webhooks still reference this universe; re-point or delete them, or pass ?force=true.
  • A forced delete disables the referencing webhooks at their next evaluation (disabled_reason: evaluation_failure, with an email), and re-enabling one is refused while its universe is gone: point it at another universe with Update a webhook (universe), then re-enable it.