Docs / IPAM

Delete a subnet

Leftover occupancy blocks DELETE unless you check Force. That drops remaining lease rows and tells DNS to remove live names.

Bottom of /subnets/{id}, admin only.

Occupancy is every remaining lease row — Lattice does not prune expired or released leases. Deleting a pool after leases expire succeeds; those occupancy rows stay (the pool id is detached). Deleting the subnet still counts those rows.

  • Without Force: API 409 if any occupancy remains (live or leftover).
  • With Force: remaining occupancy is dropped, then the subnet. DNS deletes go through the outbox (lease.released).

There is no undo. Prefixes stay. Pools, reservations, excludes, and options on that subnet go with it.

API: DELETE /api/v1/subnets/{id}?force=true.