Time	Status	User Agent
Retrieving recent requests…

Time

Status

User Agent

Retrieving recent requests…

PUT /subtitles/`{video_id}`

Hide or show a specific subtitle language in the video player. Updating the visibility status controls whether a language appears in the subtitle selection list inside the player. This operation does not delete the subtitle file — it only changes its visibility.

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

🚧
Same endpoint, two behaviors
PUT /subtitles/{video_id} toggles visibility when called with a JSON body (documented here). When called as multipart/form-data with a file, the same endpoint replaces the subtitle content instead.

HTTP Method & Path

PUT /subtitles/{video_id}

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

Authentication Requirements

Security Scheme	Header	Note
apiKey	Authorization	Your API token (no "Bearer" prefix)

Parameters

Parameter	Type	Required	Description
Authorization	string	Yes	Your API token

Path Parameters

Parameter	Type	Required	Description
video_id	string (uuid)	Yes	Unique identifier of the video that owns the subtitle track.

Request Body

Content-Type: application/json

Body Parameters

Parameter	Type	Required	Description
srclang	string	Yes	Language code of the subtitle track (e.g. `pt-BR`, `en-US`, `es`). Must match a subtitle previously added to the video.
hidden	boolean	Yes	`true` hides the language in the player; `false` makes it visible.

Response

Success Response (200)

Returns the video's subtitle list with the updated visibility.

{
  "response": [
    { "srclang": "pt-BR", "label": "Português (BR)", "hidden": true, "is_uploaded": true }
  ]
}

Error Responses

400 Bad Request — Missing or invalid field.
401 Unauthorized — Missing or invalid API token.
404 Not Found — Video config not found (video has no subtitles) or Subtitle not found (no track with that srclang).
500 Internal Server Error — Unexpected server error.

Example Usage

cURL

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