Every signed-in screen has a lookup box in the header (placeholder: IP, MAC, hostname…). It is not a nav item. Type at least two characters; a dropdown appears after ~250ms. Enter opens /search?q=.
What it finds
| Kind | Match | Open |
|---|---|---|
lease | IP, MAC, or hostname | that subnet |
reservation | IP, MAC, or hostname | that subnet |
exclude | IP inside an exclude range | that subnet |
subnet | CIDR text, or an IP contained in the CIDR | /subnets/{id} |
prefix | CIDR / description (2+ chars) | /plan |
dns | static record name or rdata (2+ chars) | /dns |
No hits: No hits for <query>. Empty box does nothing.
This is a lookup, not a replacement for Leases filters (state, client-id, subnet dropdown). Use Leases when you need force-release. Use search when someone says “what is 10.20.20.55?”
API
curl -s -H "authorization: Bearer $TOKEN" \
'http://127.0.0.1:8080/api/v1/search?q=10.20.20.55'
Response: { "query": "…", "hits": [ { "kind", "id", "title", "detail", "href" } ] }. Readonly may search.