Configures default encoding and playback quality lists for the library. IMPORTANT: changes affect NEW videos only — existing videos keep their previously configured qualities.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
PUT /library/{library_id}
{library_id}Enables or disables the conversion (encoding) and playback quality lists applied to new videos uploaded to your account.
AuthorizationRequires a valid Panda API token sent in the
Authorizationheader (no Bearer prefix).
Affects NEW videos only — not retroactiveChanges to
encodingandplaybacksettings via this endpoint apply only to videos uploaded after the modification. Existing videos retain their previously configured qualities and are NOT re-encoded automatically.
HTTP Method & Path
PUT /library/{library_id}
Base URL: https://api-v2.pandavideo.com.br
Authentication Requirements
| Security Scheme | Header | Note |
|---|---|---|
| API Key | Authorization | Panda API token (without Bearer prefix) |
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Authorization | header | string | Yes | Panda API token (without Bearer prefix) |
Path Parameters
| Field | Type | Required | Description | Constraints |
|---|---|---|---|---|
library_id | string (uuid) | Yes | Library ID — obtain it via Get user library. | uuid |
Request Body
Content-Type: application/json
Body Parameters
| Field | Type | Required | Description | Constraints |
|---|---|---|---|---|
encoding | array of strings | Yes | Resolutions to convert during the encoding process after upload. | each: 240p, 360p, 480p, 720p, 1080p, 1440p, 2160p |
playback | array of strings | Yes | Resolutions available to viewers during playback. Should be a subset of encoding to make sense. | each: same enum as encoding |
{
"encoding": ["240p", "360p", "480p", "720p", "1080p"],
"playback": ["360p", "720p", "1080p"]
}
TipIf a value is in
playbackbut not inencoding, that resolution will not be generated on upload and will not actually be available to viewers. Keepplayback ⊆ encoding.
Response
Success Response (200)
Returns the updated library settings object (same shape as Get user library).
Error Responses
- 400 Bad Request — Invalid quality value in
encoding/playback, or missing fields. - 401 Unauthorized — Missing or invalid API token.
- 404 Not Found —
library_idnot found or not owned by user. - 500 Internal Server Error — Server-side error.
Example Usage
cURL — enable all qualities for encoding, restrict playback
curl -X PUT \
'https://api-v2.pandavideo.com.br/library/<library_id>' \
-H 'Authorization: your_api_token_here' \
-H 'Content-Type: application/json' \
-d '{
"encoding": ["240p", "360p", "480p", "720p", "1080p", "1440p", "2160p"],
"playback": ["480p", "720p", "1080p"]
}'