list_failed_access_attempts
list_failed_access_attempts
Section titled “list_failed_access_attempts”Return only result == "denied" events within the window.
Side effects: None (read-only).
Convenience wrapper around list_access_events for security audits.
Each entry includes reason (e.g. "expired", "off-hours",
"unknown_pin") so the LLM can summarise the cause distribution.
Example
Section titled “Example”list_failed_access_attempts(hours_back=12, door_id="abc...")Parameters
Section titled “Parameters”| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
hours_back | integer | no | 24 | Look-back window in hours. Defaults to 24. |
door_id | string | no | "" | Optional door id filter. Empty returns denials across every door. |
limit | integer | no | 100 | Maximum events returned. Defaults to 100. |
controller | string | no | ”default” | Name of the UniFi controller to target. |