Delete an entity type
Delete a kind of object, which is only allowed while no record of it exists.
A type that still holds records refuses to go, and answers 422 saying how many it holds. Taking a hundred animals down with the word "Animal" is not something one call should be able to do. The two ways forward are to delete those records first, deliberately, or to stop the type being offered and keep everything filed under it.
The deletion is soft, so nothing is destroyed, but no endpoint here brings a type back today. The slug is not released with it either: a link that went out pointing at this type must not later land on a different one, so declaring a new type with the same slug is refused.
Path parameters
Sent as JSON. Anything not listed here is ignored.
The id of the type. A path that is not a uuid answers 404 without a query being run, so neither a sequential number nor the slug reaches anything here.
Returns
Nothing at all. A type that still holds records answers 422 and stays. A type belonging to somebody else answers 404, and so does one you have already deleted, so calling this twice does not report a second deletion.
Rate limit
Sixty requests per minute, per user, shared by every key and device. Every answer carries the budget left in X-RateLimit-Remaining.
No content.
Keys act as you, with exactly the access you have. Make one per integration so you can revoke it alone.