MP2 (Media Protection Platform)
Content Trash

Content Trash

When media content is deleted in Fastevo MP2 (except for content in pendingUpload or queued status, which gets permanently deleted immediately), it is moved to a "trash" area for 30 days. During this period, items remain in pendingDeletion status. If not restored within 30 days, the items are permanently deleted.

This page documents how to work with trashed content. For general content attributes and structure, please refer to the Content Management documentation.

Getting Trashed Content

To retrieve a list of trashed media contents, perform a GET request to:

GET https://api.fastevo.net/api/v1/projects/mediaProtection/trash

Query Parameters

In most cases, this endpoint does not require additional query parameters to function. Pagination parameters such as page and limit may be available if you need them.
(If you need sorting, filtering, and other parameters, they may be introduced in future enhancements.)

Example Response

{
  "currentPage": 1,
  "totalPages": 1,
  "totalRecords": 1,
  "data": [
    {
      "_id": "67d9daf57ec087aa6e1299f8",
      "tags": [],
      "poster": {},
      "createdAt": "2025-03-18T20:43:33.072Z",
      "contentType": "audio",
      "durationInSeconds": 54,
      "status": "pendingDeletion",
      "watermarkProfile": "",
      "videoQualities": [],
      "folderPath": "/",
      "deletionInfo": {
        "scheduledDeletionAt": "2025-04-17T21:36:04.755Z",
        "recoveryFolderPath": "prueba/carpeta/123/imports/",
        "recoveryStatus": "ready"
      },
      engageKit": [
        {
          "fileType": "autoSnapshot",
          "signedUrl": "string"
        }
      ],
    }
  ]
}

Explanation of Fields

All standard fields (e.g., _id, contentType, status, etc.) match those documented in the Content Management page. However, when content is in trash:

  • status is always pendingDeletion.
  • deletionInfo:
    • scheduledDeletionAt: The date and time at which the content will be permanently removed if not restored before then.
    • recoveryFolderPath: The folder path in which the content will be placed upon restoration.
    • recoveryStatus: The status the content will have after being restored. Typically the status before it was deleted (e.g., ready).

Restoring Trashed Content

To restore a piece of content from trash, perform a POST request to:

POST https://api.fastevo.net/api/v1/projects/mediaProtection/trash/{contentId}/restore

Replace {contentId} with the actual unique identifier of the trashed media content.

Response

  • 204 (No Content) on successful restoration, indicating that the content has been removed from trash.
    • After restoration, the content will appear again in the normal content listing and will have its status set to the value stored in deletionInfo.recoveryStatus.

Permanent Deletion

After 30 days in trash, any content not restored is automatically and permanently deleted by the system. There is no self-service recovery after permanent deletion.

Content ManagementPlayer Embedding