Delete a life event category
Remove a category you added that holds nothing.
Two categories cannot go. One the product supplied stays, because the wording it falls back to belongs to the product. One that still holds natures stays, and the answer says how many, because removing it would take them with it. Move them elsewhere first, or retire the category instead.
Both refusals bite today, since natures are filed under categories from the moment an account is created.
A deletion is recoverable, so an accident is not the end of anything.
Path parameters
Sent as JSON. Anything not listed here is ignored.
The id of the category. A path that is not a uuid answers 404 without a query being run.
Returns
Nothing. A supplied category, and one still holding a nature, each answer 422 naming that reason, and one belonging to somebody else answers 404.
Rate limit
Sixty requests per minute, per user, shared by every key and device. Every answer carries the budget left in X-RateLimit-Remaining.
Keys act as you, with exactly the access you have. Make one per integration so you can revoke it alone.