UniFi Protect icon

UniFi Protect

Interact with UniFi Protect API
Join our community

Actions18

Overview

This node interacts with the UniFi Protect API to download video recordings from specified cameras. It is useful for retrieving recorded footage within a defined time range and quality, enabling users to archive or review surveillance videos. For example, a security team can use this node to download recordings from a specific camera for a particular event or time period.

Use Case Examples

  1. Download a high-quality recording from a specific camera between two timestamps for security review.
  2. Automatically retrieve and save medium-quality video footage from multiple cameras for backup purposes.

Properties

Name Meaning
Camera ID The unique identifier (UUID) of the camera from which to download the recording.
Start Time The start time for the recording to download, specified as a date and time.
End Time The end time for the recording to download, specified as a date and time.
Channel The video channel or quality to download, with options for High, Medium, or Low quality.
Filename The filename to assign to the downloaded recording file.
Request Options Additional request settings such as batching, SSL certificate validation, proxy configuration, and timeout settings.

Output

JSON

  • data - The downloaded recording data or metadata returned from the UniFi Protect API.

Dependencies

  • UniFi Protect API
  • API key credential for authentication

Troubleshooting

  • Ensure the Camera ID is correct and corresponds to an existing camera in the UniFi Protect system.
  • Verify that the start and end times are valid and that the end time is after the start time.
  • Check network connectivity and proxy settings if the request fails to reach the UniFi Protect controller.
  • If SSL certificate validation fails, consider enabling the option to ignore SSL issues, but be aware of security risks.
  • Timeout errors may occur if the server is slow to respond; increase the timeout setting if necessary.

Links

Discussion