Restores videos from the trash (status DELETING). Videos remain recoverable for up to 30 days after deletion. Body is a JSON array of {video_id} — supports bulk recovery.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
POST /videos/recover
Restores videos that were moved to the trash via the Delete Video endpoint. When a video is deleted, it is not immediately removed from the platform — its status changes to DELETING and it remains recoverable for up to 30 days. After 30 days, the video is permanently deleted and can no longer be restored.
The request body is a JSON array of objects, each containing a video_id — supporting bulk recovery in a single request.
AuthorizationRequires a valid Panda API token sent in the
Authorizationheader (no Bearer prefix).
HTTP Method & Path
POST /videos/recover
Base URL: https://api-v2.pandavideo.com.br
Authentication Requirements
| Security Scheme | Header | Note |
|---|---|---|
| API Key | Authorization | Panda API token (without Bearer prefix) |
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Authorization | header | string | Yes | Panda API token (without Bearer prefix) |
Request Body
Content-Type: application/json
The request body is a JSON array. Send one object per video to recover. To recover a single video, send an array with a single element.
Body (array of objects)
| Field | Type | Required | Description | Constraints |
|---|---|---|---|---|
video_id | string (uuid) | Yes | ID of the trashed video (in DELETING status). | uuid |
Recover a single video
[
{ "video_id": "dfb633cf-9ec9-496d-b440-d71e0b5c1d4c" }
]Recover multiple videos (bulk)
[
{ "video_id": "dfb633cf-9ec9-496d-b440-d71e0b5c1d4c" },
{ "video_id": "7aa40713-b39c-44ce-8483-9e27781eb2b5" }
]
Heads up: the body must be an array, even when recovering a single video. Sending a plain object will be rejected. Videos older than 30 days in the trash cannot be recovered.
Response
Success Response (200)
Returns a confirmation message listing the recovered video IDs.
{
"message": "Video with video_ids: dfb633cf-9ec9-496d-b440-d71e0b5c1d4c was recovered"
}Response Schema
| Field | Type | Description |
|---|---|---|
message | string | Confirmation message listing the recovered video IDs. |
Error Responses
- 400 Bad Request — Missing or invalid
video_id, or malformed body (e.g., not an array). - 401 Unauthorized — Missing or invalid API token.
- 404 Not Found — Video not found in the trash (already permanently deleted, or never deleted).
- 500 Internal Server Error — Server-side error.
Example Usage
cURL — recover a single video
curl -X POST \
'https://api-v2.pandavideo.com.br/videos/recover' \
-H 'Authorization: your_api_token_here' \
-H 'Content-Type: application/json' \
-d '[
{ "video_id": "dfb633cf-9ec9-496d-b440-d71e0b5c1d4c" }
]'cURL — bulk recover
curl -X POST \
'https://api-v2.pandavideo.com.br/videos/recover' \
-H 'Authorization: your_api_token_here' \
-H 'Content-Type: application/json' \
-d '[
{ "video_id": "dfb633cf-9ec9-496d-b440-d71e0b5c1d4c" },
{ "video_id": "7aa40713-b39c-44ce-8483-9e27781eb2b5" }
]'