Updates a player profile, propagating to linked videos
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
PUT /profile/{profile_id}
Updates a profile. Changes propagate to all linked videos.
Important: full-object replacement
When updating a nested section (colors, vsl, saveProgress, general), the entire object is replaced. Always:
- Read the current profile with Get profile details
- Modify the section you need
- Send the complete modified section back
Request body
All fields are optional. Only send what you want to change.
| Field | Type | Description |
|---|---|---|
name | string | 3-255 characters |
exclusive | boolean | Exclusive flag |
hideControlsOnStart | boolean | Hide controls on load |
colors | object | Full color config (replaces entirely) |
vsl | object | Full VSL config (replaces entirely) |
saveProgress | object | Full save-progress config (replaces entirely) |
general | object | General settings (replaces entirely) |
controls | string[] | Enabled controls list |
availableQualities | string[] | null | Allowed resolutions with the p suffix, e.g. ["480p","720p"]. null or empty array = no restriction |
⚠️
pandaBrandingandrefCodeno longer affect playback.
Since September 2026, these fields are read only from your account's global player settings. Values sent in thevslobject are stripped by the API. To hide the Panda logo, change it in your account's player settings.
Cross-field validation
If saveProgress.initQuality is set, it must be one of the availableQualities. Otherwise the API returns 400.
Restrict available qualities
curl -X PUT "https://api-v2.pandavideo.com.br/profile/{profile_id}" \
-H "Authorization: {api_key}" \
-H "Content-Type: application/json" \
-d '{ "availableQualities": ["480p", "720p"] }'Update VSL settings
curl -X PUT "https://api-v2.pandavideo.com.br/profile/{profile_id}" \
-H "Authorization: {api_key}" \
-H "Content-Type: application/json" \
-d '{
"vsl": {
"autoplay": true,
"mutedIndicatorIcon": true,
"mutedIndicatorTextTop": "Click here",
"mutedIndicatorSize": "small"
}
}'The response is the full updated profile, in the same format as Get profile details.
Errors
| Status | Cause |
|---|---|
| 400 | availableQualities item does not match \d+p |
| 400 | initQuality is not in availableQualities |
| 404 | Profile not found or does not belong to your account |
