Delete a universe
DELETE
https://api.tickerbot.io/ v2/ universes/ {universe}Permanently deletes one of your universes.
Path parameters
stringrequiredUniverse slug.
Query parameters
booleandefault falseA 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.
Status codes
| Code | Meaning |
|---|---|
204 | Deleted. |
400 | Invalid universe slug format, or an invalid force value (accepted: true/1/yes, false/0/no). |
403 | system_universe_immutable: built-in universes are read-only. |
404 | not_found: the slug matches none of your universes. |
409 | universe_referenced: webhooks still reference this universe; re-point or delete them, or pass ?force=true. |
Notes
- 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.