How can I retain video events indefinitely as part of a special retention request?

Retaining a few Events

Even though you can save individual Events, download a few multi-selected Events as a zip file, and download Events in bulk, you may sometimes need to retain many Events from a particular time period across hundreds cameras spanning multiple accounts.

Retaining many Events with retention requests

Camio enables you to submit retention requests that prevent any Event that matches your requests from being purged. You submit the requests as queries, and then verify that your retention requests protect the desired Events.

For example, to retain all video from 2am to 4am from all cameras at the San Mateo and San Jose offices on February 14th, 2024, you would send these queries to as your retention request:

2am PT February 14th 2024 to 4am PT February 14th 2024

2am PT February 14th 2024 to 4am PT February 14th 2024

Verifying retention requests

After the retention requests have been confirmed by Camio Support, you can verify that the Events you expect to be retained are in fact protected by your retention requests by using a debug tool accessible by pressing the lowercase L key (toggles on/off) when viewing the Events in question. For example, to verify the first request above, you would:

  1. View the search results at:;q=2am+PT+February+14th+2024+to+4am+PT+February+14th+2024
  2. Press the lowercase L key to see the yellow debug output on each tile like this, and then click the "event" link in the upper left (circled in orange):
    Screenshot 2024-02-14 at 4.16.46 PM.png

  3. Confirm "do_not_purge" is correctly true or false. True means the Event will be retained. False means the Event will be purged upon reaching the age specified by the retention period of your subscription.
    Screenshot 2024-02-14 at 4.19.49 PM.png

Retrieving motionless video too

For some retention requests, the continuous video history is required regardless of whether anything significant was moving in the scene. If you use upload query filters normally, then read how to override upload query filters.



Have more questions? Submit a request