Docs / IPAM

Helpdesk leases

Search by MAC, IP, hostname, client-id, subnet, or state. Force-release returns the address.

Open Leases (/leases). For a single IP or MAC, search in the console is faster. Use this page for filters and force-release. Who held this IP last week, or what sat on a switch port, is History — the Expired tab is not that report.

Leases: 200 live, filters, Release on each row

Leases: 200 live, filters, Release on each row

Filters:

  • Subnet
  • IP
  • MAC
  • Hostname
  • Client-id
  • State (offered, leased, expired, released, declined, quarantined)

Force-release

Operator or admin. Select the lease, release. Inventory returns to free (or stays reserved if a reservation exists). The worker enqueues lease.released and deletes A+PTR. DNS failure does not undo the release.

API:

curl -s -H "authorization: Bearer $TOKEN" \
  'http://127.0.0.1:8080/api/v1/leases?mac=aa:bb:cc:dd:ee:ff'
curl -s -X POST -H "authorization: Bearer $TOKEN" \
  "http://127.0.0.1:8080/api/v1/leases/${ID}/release"

DHCPDECLINE puts the address in quarantine for LATTICE_QUARANTINE_TTL (default 15m). Do not use quarantine to hide clock bugs. See Quarantine and Clock.

Helpdesk steps (MAC → release → reserve): Helpdesk playbook.