Remote Folders
The Remote Folders tab of the External Storage section catalogues the network shares C21 Live Control mounts to back up Recordings before retention deletes the local file. The other External Storage tab is Target Folders — credentials records used by the Editor to deliver clips.
What it is
When a Recording's Record-type Destination carries a delete_after retention window, Live Control copies the recording to the bound Remote Folder before deleting the local file. The Remote Folder is the long-term preservation tier; without one, the file is deleted outright when the window elapses.
Every operation requires the System Administrator role.
Form fields
| UI label | API field | Notes |
|---|---|---|
| Name | name | Display name reused across the UI, API and logs. |
| Host | host | IP address or FQDN of the share server. |
| Folder | folder | Share path (for example /exports/recordings). |
| Protocol | protocol | NFS or WEBDAV. |
| User | user | Username — WebDAV only. |
| Password | password | Password — WebDAV only. Write-only on the API — GET responses return has_password: true/false instead of the stored value. |
Listing columns
The Remote Folders list exposes six columns: Name, Host, Folder, Protocol, User and Status (a badge rendering Valid / Invalid / Unknown based on the current validation_status).
Mount status
The mount daemon reports one of the following codes on status:
| Code | Meaning |
|---|---|
MNTs000 | Mounted correctly. |
MNTs001 | Mount point cannot be resolved — DNS resolution failure or invalid hostname. |
MNTs002 | Share path does not exist on the server. |
MNTs003 | Server unreachable. |
MNTs004 | Mount attempt timed out. |
MNTs005 | Authentication failed (WebDAV). |
MNTs006 | I/O error on the mount. |
MNTs099 | Unknown mount error. |
Validate
The Validate Connection action calls POST /c21apiv2/crud/remotefolders/{id}/validate. NFS validation runs against the server's exports list with a 5-second timeout; WebDAV validation issues an HTTP HEAD against the host with the same timeout. The response updates validation_status, validation_date and (on failure) a sanitised validation_error.
API reference
| Action | Method + path |
|---|---|
| List | GET /c21apiv2/crud/remotefolders |
| Read | GET /c21apiv2/crud/remotefolders/{id} |
| Create | POST /c21apiv2/crud/remotefolders |
| Update | PUT /c21apiv2/crud/remotefolders/{id} |
| Delete | DELETE /c21apiv2/crud/remotefolders/{id} |
| Validate Connection | POST /c21apiv2/crud/remotefolders/{id}/validate |
Cross-links
- Recordings — retention backup workflow that consumes Remote Folders.
- Target Folders — the other External Storage tab, for Editor clip delivery.
FAQ
MNTs003 / MNTs004 depending on the cause). The next deletion attempt against that folder is skipped — the local file is preserved until the share is back. Run Validate Connection to refresh the status once the share has been restored.