Update profile

Updates a player profile, propagating to linked videos

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

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:

  1. Read the current profile with Get profile details
  2. Modify the section you need
  3. Send the complete modified section back

Request body

All fields are optional. Only send what you want to change.

FieldTypeDescription
namestring3-255 characters
exclusivebooleanExclusive flag
hideControlsOnStartbooleanHide controls on load
colorsobjectFull color config (replaces entirely)
vslobjectFull VSL config (replaces entirely)
saveProgressobjectFull save-progress config (replaces entirely)
generalobjectGeneral settings (replaces entirely)
controlsstring[]Enabled controls list
availableQualitiesstring[] | nullAllowed resolutions with the p suffix, e.g. ["480p","720p"]. null or empty array = no restriction

⚠️ pandaBranding and refCode no longer affect playback.
Since September 2026, these fields are read only from your account's global player settings. Values sent in the vsl object 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

StatusCause
400availableQualities item does not match \d+p
400initQuality is not in availableQualities
404Profile not found or does not belong to your account
Path Params
uuid
required
Body Params
string
length between 3 and 255
boolean
boolean | null
colors
object

Color configuration for the video player

vsl
object

Video Sales Letter and advanced player configuration

saveProgress
object

Configuration for save progress functionality

general
object
controls
array of strings
controls
availableQualities
array of strings | null

Allowed resolutions with the p suffix, e.g. ["480p","720p"]. null or empty array means no restriction.

availableQualities
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json