deleteElements Method
Deletes target element trees, using one native operation unless references between the trees require more. Requested roots in doNotUpdateElementIds are skipped. This does not prevent an element in that set from being deleted as part of another root's cascade. Elements that something outside the deleted trees still uses are kept, along with their child elements and sub-models and the elements that contain them. A warning lists them. That includes elements that native validation refuses because of a use the importer doesn't check in advance, such as geometry outside the deleted trees that places a geometry part in them.
deleteElements(elementIds: ReadonlySet<string>): Promise<void>
@throws ElementBulkDeleteError if a native operation fails with a database error, or refuses elements that no requested element contains. Deletions from that and earlier native operations stay pending in the caller-owned transaction. Abandon the transaction before retrying.
| Parameter | Type | Description |
|---|---|---|
| elementIds | ReadonlySet<string> |
Returns - Promise
Defined in
Last Updated: 06 November, 2026