Read the faults fault_detector.py has actually detected.
List detected faults
query Parameters
statusFilter to only-open or only-resolved faults. Omit for both.
point_uriFilter to faults on one point, e.g. urn:point:fbf/mock-ahu-1/analogValue,1.
rule_idFilter to faults raised by one rule - the rule's id (from POST /fault/rules's response), not its name.
limitPage size. The list is paged so a long-running install doesn't answer with every fault it ever raised (5 MB on nash-srv, Baler#107); omit for the newest 500.
beforeA fault id from a previous page (its X-Next-Before header): return the faults after that one, in the same order.
sinceOnly faults that started at or after this time (ISO 8601, with a UTC offset).
List detected faults › Responses
One page of the matching faults, most recent first (ties by id). The body is the same bare array it always was; the paging facts are headers.
idrule_idpoint_uristatusstarted_atended_atdetailseverityCopied from the rule's severity at the moment this fault opened. See POST /rules's severity field.
acked_atSet by POST /faults/{id}/ack. Null if never acked.
acked_byThe X-User value (gateway-forwarded) at the time of the most recent ack.
snoozed_untilSet by POST /faults/{id}/snooze. Null if not currently snoozed.
Acknowledge a fault
Sets acked_at/acked_by on the fault row (acked_by from the gateway-forwarded X-User header). Re-acking an already-acked fault just overwrites who/when - there's no separate unacknowledge endpoint. Purely an operator-facing annotation: acking does not stop fault_detector.py from evaluating the rule, close the fault, or suppress webhook delivery.
path Parameters
idAcknowledge a fault › Responses
Acknowledged. No response body.
Snooze a fault for a number of minutes
Sets snoozed_until on the fault row. Same as acking, this is display/notification-suppression metadata only - it does not pause rule evaluation or webhook delivery. If the fault resolves and reopens while snoozed, the reopened row starts with snoozed_until: null (it's a new row - see POST /rules's description of how open/resolve transitions work).
path Parameters
idSnooze a fault for a number of minutes › Request Body
minutesMinutes from now until the snooze expires. Must be positive.
Snooze a fault for a number of minutes › Responses
Snoozed.
idsnoozed_until