Objects

Delete object

Delete an object. A child object is deleted along with it only when this object is its last remaining parent; a child that is also reachable through another parent is detached instead. A node normally belongs to both a subnet and a container, so deleting a container usually leaves its nodes in place.

Deletion is asynchronous: the request is validated and queued, and 204 means the deletion was accepted, not that the object is already gone. Clients should re-read the tree rather than assume the object disappears immediately.

Built-in objects (ID below 10, such as "Entire Network" and the class roots) cannot be deleted.

delete/v1/objects/{object-id}

Path parameters

object-idinteger required

Query parameters

removeDCIboolean

Templates and clusters only. Whether to also remove the data collection items this object pushed onto its members. Ignored for every other object class.

Response

Deletion accepted. The object is removed asynchronously.

Changes