PUT /library/{library_id}

Atualiza as configurações de qualidade e processamento de vídeo de uma library. Use este endpoint para definir quais resoluções estão disponíveis para playback, quais resoluções o pipeline de encoding deve gerar, se os arquivos originais devem ser preservados e qual o modo de compressão.

📘

Authorization

Requires a valid API token in the Authorization header (without Bearer prefix). The library is resolved by the token's user_id and the library_id in the path must belong to the authenticated user.

⚠️

Important — changes are not retroactive

Quality changes affect only new videos. Already-processed videos keep the qualities they were encoded with. To re-encode an existing video at the new qualities, use the reencode endpoint after updating settings.

HTTP Method & Path

PUT /library/{library_id}

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

Authentication Requirements

Path Parameters

Request Body

Content-Type: application/json

All body fields are optional — this is a partial update. Send only the fields you want to change.

Body Parameters

📘

Business rule (not enforced by the validator)

playback should be a subset of encoding — you can only deliver resolutions that were actually encoded. Configuring a playback value outside of encoding produces unavailable streams. The API does not reject this combination today; the recommendation is operational.

🚧

Do not send block_none_refer here

The Ajv validator is strict (additionalProperties: false) and the request will return 400 must NOT have additional properties: block_none_refer. To toggle the referer policy, use POST /library/{library_id}?action=referValidation.

{
  "playback": ["360p", "480p", "720p", "1080p"],
  "encoding": ["360p", "480p", "720p", "1080p", "1440p"],
  "keep_original_files": true,
  "compression_mode": "balanced"
}

Response

Success Response (200)

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "user_id": "2481ef9b-5642-4fcd-b9aa-094e98b5cf0a",
  "name": "My Video Library",
  "video_library_id": 12345,
  "pullzone_name": "my-pullzone",
  "pullzone_id": 67890,
  "api_key": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "video_library_pullzone_id": 54321,
  "parallel_upload_limit": 5,
  "playback": ["360p", "480p", "720p", "1080p"],
  "encoding": ["360p", "480p", "720p", "1080p", "1440p"],
  "keep_original_files": true,
  "compression_mode": "balanced",
  "created": "2024-01-15T10:30:00.000Z"
}

Response Schema

Side effects (server-side, not visible in response)

• encoding is synced to Bunny CDN via the EnabledResolutions setting on the video library.
• Memcache keys are invalidated: getLibraryById_{library_id}, getVerifyIfHasLibraryId_USER_ID.
• An audit log entry is queued (via SQS) for each changed attribute under the qualities category (encoding, playback, keep_original_files, compression_mode).

Error Responses

Example 400 (extra property):

{
  "error": "must NOT have additional properties: block_none_refer"
}

Example Usage

cURL — update encoding + playback together

curl -X PUT \
  -H "Authorization: $PANDA_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "encoding": ["360p","480p","720p","1080p","1440p"],
    "playback": ["360p","480p","720p","1080p"],
    "compression_mode": "balanced"
  }' \
  https://api-v2.pandavideo.com.br/library/123e4567-e89b-12d3-a456-426614174000

cURL — enable original file preservation only

curl -X PUT \
  -H "Authorization: $PANDA_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keep_original_files": true}' \
  https://api-v2.pandavideo.com.br/library/123e4567-e89b-12d3-a456-426614174000

Related

• Get current settings: GET /library or GET /library/{library_id}
• Toggle referer policy: POST /library/{library_id}?action=referValidation
• Manage allowed referrers: POST /library/{library_id}?action=refer
• Block download (per-library): PUT /block_download
• Per-video offline configuration: see configure-video-offline