list_recordings
list_recordings
Section titled “list_recordings”List Protect recordings for one camera over the last hours_back hours.
Side effects: None (read-only).
Returns one record per stored clip segment with id, start,
end, type, and size (bytes). Useful for finding the
recording window around a specific motion event.
Example
Section titled “Example”list_recordings(camera_id="65f...", hours_back=6)Parameters
Section titled “Parameters”| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
camera_id |
string |
yes | — | Protect camera id. |
hours_back |
integer |
no | 24 | Look-back window in hours. Defaults to 24. |
controller |
string |
no | “default” | Name of the UniFi controller to target. Defaults to "default". |