General DHCP event history with filtering
GET /api/history/events
Auto-generated from server.go. Handler: s.getHistoryEvents.
Supports format=csv query param for CSV export — the operation
carries x-validation: skip (D-120) because the CSV branch is not
JSON.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Query Parameters
Section titled “Query Parameters ”Responses
Section titled “ Responses ”Paginated list response (JSON) or CSV attachment when format=csv
General DHCP event history response (JSON branch only — when
format=csv is set, the operation streams text/csv instead;
the path file marks the whole operation x-validation: skip,
D-120).
Schema hand-written in Session 10. The events array reuses the
shared HistoryEventItem schema. Pagination block matches
internal/api/models.go::PaginationInfo; filters_applied matches
FiltersApplied.
object
A single DHCP event row from history. Many fields are optional
(omitempty in Go) — DHCPv6 fields are only present for v6 events,
DHCPv4 packet fields only for v4 events. Required fields below are
those the lift saw populated in the seed sample; treat the rest as
optional.
Hand-extracted in Session 10 from internal/api/models.go::HistoryEventItem
so both /api/history/events and /api/history/device/{mac}/events can
reference the same shape.
object
RFC3339Nano formatted; emitted by handler as string.
DHCPv6 only; omitempty.
DHCPv6 only; omitempty.
DHCPv6 only; omitempty.
DHCPv6 only; omitempty.
DHCPv6 only; omitempty.
DHCPv6 only; omitempty.
DHCPv6 only; omitempty.
DHCPv6 only; omitempty.
DHCPv6 only; omitempty.
DHCPv6 only; omitempty.
DHCPv6 only; omitempty.
DHCPv6 only; omitempty.
DHCPv6 only; omitempty.
DHCPv6 only; omitempty.
DHCPv6 only; omitempty.
DHCPv6 only; omitempty.
object
object
object
RFC3339 string emitted by handler time.Time.Format.
RFC3339 string emitted by handler time.Time.Format.
Omitempty in Go; absent when no message_type filter is applied.
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.
Result set too large for CSV export
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.