Permanently deletes one or more videos from your account. A JSON body is required even when deleting a single video — the endpoint accepts either a single object or an array of objects, each containing a video_id. After this call returns, the video status is set to DELETING and the asset cleanup happens asynchronously (a worker eventually drops the files from storage).
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
DELETE /videos
Deletes one or more videos by their IDs. Accepts an array of objects, each containing a video_id. This allows batch deletion in a single request.
AuthorizationRequires a valid API token with permission to delete videos.
HTTP Method & Path
DELETE /videos
Base URL: https://api-v2.pandavideo.com.br
Authentication Requirements
- Security Scheme:
PandaAuth(apiKey) - Header:
Authorization: <your_api_token>(no 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 an array of objects. Each object must contain a video_id.
Body Parameters
| Field | Type | Required | Description |
|---|---|---|---|
video_id | string (uuid) | Yes | ID of the video to delete |
Example Request
[
{
"video_id": "e9f3e6a7-42fb-4d1e-83ef-49e64a799498"
}
]Example Request — Batch (multiple videos)
[
{ "video_id": "e9f3e6a7-42fb-4d1e-83ef-49e64a799498" },
{ "video_id": "a1b2c3d4-5678-9012-abcd-ef1234567890" }
]Response
Success Response (200)
{
"message": "Video with video_ids: e9f3e6a7-42fb-4d1e-83ef-49e64a799498 was deleted"
}Response Schema
| Field | Type | Description |
|---|---|---|
message | string | Confirmation message listing the deleted video IDs |
Error Responses
- 401 Unauthorized — Invalid or missing API token
- 404 Not Found — Video not found
- 500 Internal Server Error — Internal server error
Example Usage
cURL
curl -X DELETE \
'https://api-v2.pandavideo.com.br/videos' \
-H 'Authorization: your_api_token_here' \
-H 'Content-Type: application/json' \
-d '[
{
"video_id": "e9f3e6a7-42fb-4d1e-83ef-49e64a799498"
}
]'Missing or invalid Authorization header. The Panda API token goes directly in the header without the Bearer prefix.