DELETE /v1/objects/{id}
Permanently deletes an object from your subscription.
Path parameters
id, the object's UUID.
Query parameters
entity(optional), uppercase entity code, for routing to the correct backing store.
Responses
- 204, deleted successfully. Response body is empty.
- 403, the object belongs to another tenant.
- 404, object not found.
What happens on the server
- The object is removed from the primary store.
- Real-time push notifications fire so connected clients update their UIs.
- The deletion is recorded in the audit log.
Example
curl -X DELETE "https://rest.demandflow.com/v1/objects/a1b2c3d4-e5f6-4890-abcd-ef1234567890" \
-H "Authorization: Bearer $TOKEN"Caution
DELETE is immediate and not reversible via the API. For high-risk entities, prefer archiving (setting a status field to an archived value) rather than deleting.