PUT /library/{library_id}/hls-encryption

Enables or disables HLS encryption for new uploads in this library.

⚠️

Enabling encryption does not change existing videos

It applies to new uploads. To protect videos that already exist, reprocess them — see Reprocess a video for a single video, or Reprocess videos in bulk for up to 100 at a time. Reprocessing requires the library to have keep_original_files enabled and consumes credits.

📘

Authorization

Requires a valid API token in the Authorization header (without Bearer prefix). The library_id must belong to the authenticated user.

HTTP Method & Path

PUT /library/{library_id}/hls-encryption

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

Authentication Requirements

Path Parameters

Request Body

Content-Type: application/json

Body Parameters

{ "status": true }

Response

Success Response (200)

{ "status": true }

⚠️

Important

• Changes take a few minutes to apply. Security settings are cached: allow up to ~6 minutes before the change affects playback, and responses may stay cached at the CDN for a short while after that.
• Unlike the strict playback mode, this switch has no dependency on block_download.
• Turning encryption off does not decrypt videos that were already encrypted.

Error Responses

Example Usage

cURL

curl -X PUT \
  "https://api-v2.pandavideo.com.br/library/{library_id}/hls-encryption" \
  -H "Authorization: $PANDA_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status": true}'

Related

• Read the current value: GET /library/{library_id}/hls-encryption
• Library settings that gate reprocessing: Get user library (keep_original_files)
• Apply encryption to existing videos: Video Reprocessing