Fast device search for autocomplete. Supports searching by MAC address, hostname, vendor class, or IP address. Returns matching devices with their current action status
GET /api/devices/search
Auto-generated from server.go. Handler: s.SearchDevices.
Authorizations
Section titled “Authorizations ”Responses
Section titled “ Responses ”Successful response
Fast device search for autocomplete. Supports searching by MAC address, hostname, vendor class, or IP address. Returns matching devices with their current action status.
Schema hand-corrected in Session 9 from the 70-03a auto-lift artifact:
the original lift sampled an empty results array, which inferred
map[string]interface{} instead of []DeviceSearchResult. Now correctly
typed as an array of typed device records.
object
object
object
Uint64 in Go; JSON number.
Time.Time, marshaled as RFC3339 by encoding/json.
All active action types for this device (allow, block, deny, monitor, throttle). Empty array when device has no active actions.
object
Authentication is required or the supplied token is invalid.
Standardised error envelope per RFC 7807. Many existing endpoints still
return an older shape (e.g. {"error": "..."}). This schema documents the
target shape; legacy endpoints will be migrated in Phase 70. Per D-21 the
spec describes current behaviour without enforcing the migration here.
object
A URI reference that identifies the problem type.
A short human-readable summary of the problem.
The HTTP status code generated by the origin server.
A human-readable explanation specific to this occurrence.
A URI reference that identifies the specific occurrence.
Legacy error message field. Will be removed once handlers are migrated.
Legacy per-field error details. Will be removed once handlers are migrated.
object
The request id middleware-assigned identifier for tracing.
Internal server error
Standardised error envelope per RFC 7807. Many existing endpoints still
return an older shape (e.g. {"error": "..."}). This schema documents the
target shape; legacy endpoints will be migrated in Phase 70. Per D-21 the
spec describes current behaviour without enforcing the migration here.
object
A URI reference that identifies the problem type.
A short human-readable summary of the problem.
The HTTP status code generated by the origin server.
A human-readable explanation specific to this occurrence.
A URI reference that identifies the specific occurrence.
Legacy error message field. Will be removed once handlers are migrated.
Legacy per-field error details. Will be removed once handlers are migrated.
object
The request id middleware-assigned identifier for tracing.