mirror/netbox-community-netbox
1
0
Fork 0
mirror of https://github.com/netbox-community/netbox.git synced 2024-05-10 07:54:54 +00:00
Code Activity

Merge pull request #5163 from netbox-community/3436-api-bulk-delete

Browse Source 
#3436: Support for bulk deletion via REST API
This commit is contained in:
Jeremy Stretch
2020-09-22 10:29:41 -04:00
committed by GitHub
parent 2b689239ae 54a4f84708
commit 961a491ea4
5 changed files with 108 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
docs/rest-api/overview.md
View File

@@ -529,3 +529,17 @@ Note that `DELETE` requests do not return any data: If successful, the API will
!!! note
You can run `curl` with the verbose (`-v`) flag to inspect the HTTP response codes.
### Deleting Multiple Objects
NetBox supports the simultaneous deletion of multiple objects of the same type by issuing a `DELETE` request to the model's list endpoint with a list of dictionaries specifying the numeric ID of each object to be deleted. For example, to delete sites with IDs 10, 11, and 12, issue the following request:
```no-highlight
curl -s -X DELETE \
-H "Authorization: Token $TOKEN" \
http://netbox/api/dcim/sites/ \
--data '[{"id": 10}, {"id": 11}, {"id": 12}]'
```
!!! note
The bulk deletion of objects is an all-or-none operation, meaning that if NetBox fails to delete any of the specified objects (e.g. due a dependency by a related object), the entire operation will be aborted and none of the objects will be deleted.