---
title: "Delete object"
method: DELETE
path: "/v1/objects/{object-id}"
tags: ["Objects"]
---

# Delete object

`DELETE /v1/objects/{object-id}`

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.

## Path parameters

- `object-id` integer, required

## Query parameters

- `removeDCI` boolean

## Response `204`

Deletion accepted. The object is removed asynchronously.

## Other responses

- `400` — Invalid object ID
- `401` — Unauthorized
- `403` — User does not have delete access to the object, or the object is a built-in object that cannot be deleted.
- `404` — Object with given ID does not exist
- `409` — Object cannot be deleted in its current state — the zone still contains objects, or the asset is linked to an object and `Objects.Assets.AllowDeleteIfLinked` is disabled.

---

[API](https://skmtc.dev/netxms/apis/netxms-api.md) · [All operations](https://skmtc.dev/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/netxms/netxms-api/revisions/b04ea2fbcedb/schema)