DELETE /subtitles/{video_id}

Remove a subtitle track from a video. This deletes the subtitle file(s) from storage and removes the entry from the video configuration. The change is reflected in the player after cache invalidation.

📘

Authorization

Send your API token in the Authorization header. For sub-accounts, use the parent account's API token.

HTTP Method & Path

DELETE /subtitles/{video_id}

Base URL: https://api-v2.pandavideo.com.br

Authentication Requirements

Parameters

Path Parameters

Request Body

Content-Type: application/json

Body Parameters

Response

Success Response (200)

Returns the video's remaining subtitle list.

{
  "response": [
    { "srclang": "en", "label": "English", "hidden": false, "is_uploaded": true }
  ]
}

📘

Both the subtitle file ({srclang}.vtt) and its ellipsis variant ({srclang}_ellipsis.vtt) are removed from storage.

Error Responses

• 400 Bad Request — srclang missing or invalid.
• 401 Unauthorized — Missing or invalid API token.
• 403 Forbidden — Failed to delete the subtitle file from storage.
• 404 Not Found — Video not found.
• 500 Internal Server Error — Unexpected server error.

Example Usage

cURL

curl --request DELETE \
  --url https://api-v2.pandavideo.com.br/subtitles/{video_id} \
  --header 'Authorization: <your_api_key>' \
  --header 'Content-Type: application/json' \
  --data '{"srclang":"pt-BR"}'