Create a player profile (POST /profile) already configured — colors, controls, caption appearance (colors.captionsColor / captionsBackgroundColor + captionsSize), VSL, save progress, general (speed, theme, gear menu, offline) and availableQualities, all in one call. Send only what you want to set; the rest uses the player defaults. `name` is any label (3–100 chars). The new profile has no videos: link them with panda_apply_profile_to_videos. To make it the account default use panda_set_default_profile. Returns {id, name, isDefault}.
View input schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 3,
"maxLength": 100,
"description": "Profile name shown in the dashboard (3–100 chars)"
},
"exclusive": {
"type": "boolean",
"description": "True = a single video's own profile (hidden from panda_list_profiles). Leave unset for a shared profile."
},
"controls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of enabled player controls (incl. \"play-large\" = Botão de Play Grande). Values: \"play-large\", \"rewind\", \"play\", \"fast-forward\", \"progress\", \"current-time\", \"volume\", \"captions\", \"settings\", \"pip\", \"fullscreen\", \"airplay\", \"cast\""
},
"hideControlsOnStart": {
"type": "boolean",
"description": "Hide controls until user interacts"
},
"colors": {
"type": "object",
"properties": {
"primaryColor": {
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}([0-9a-fA-F]{2})?$",
"description": "Primary accent color (#RRGGBB)"
},
"controlsColor": {
"$ref": "#/properties/colors/properties/primaryColor",
"description": "Controls color (#RRGGBB)"
},
"background": {
"$ref": "#/properties/colors/properties/primaryColor",
"description": "Player background color (#RRGGBB)"
},
"captionsColor": {
"$ref": "#/properties/colors/properties/primaryColor",
"description": "Caption (subtitle) text color — #RRGGBB, or #RRGGBBAA with transparency (e.g. '#FFFFFFFF' = opaque white)."
},
"captionsBackgroundColor": {
"$ref": "#/properties/colors/properties/primaryColor",
"description": "Caption background color — #RRGGBB, or #RRGGBBAA with transparency (e.g. '#000000B3' = 70% opaque black)."
}
},
"additionalProperties": false,
"description": "Player colors, including caption text/background. Only the colors you send change — the others are kept."
},
"captionsSize": {
"type": "string",
"enum": [
"extra_small",
"small",
"normal",
"large",
"extra_large"
],
"description": "Caption font size by the dashboard name: extra_small (10px), small (12px), normal (14px, default), large (16px), extra_large (18px). Use the user's word ('legenda grande' / 'large captions' → large)."
},
"vsl": {
"type": "object",
"properties": {
"autoplay": {
"type": "boolean",
"description": "Auto-play video"
},
"smartAutoplay": {
"type": "boolean",
"description": "Smart Autoplay — auto-plays muted, unmutes on interaction"
},
"disablePause": {
"type": "boolean",
"description": "Disable pause button (VSL mode)"
},
"disableForward": {
"type": "boolean",
"description": "Disable forward/seek (VSL mode)"
},
"restartAfterEnd": {
"type": "boolean",
"description": "Restart video after it ends"
},
"alternativeProgress": {
"type": "boolean",
"description": "Fake progress bar (VSL mode)"
},
"alternativeProgressHeight": {
"type": "number",
"description": "Fake progress bar height in px"
},
"alternativeProgressVelocity": {
"type": "number",
"description": "Fake progress bar speed (1-10)"
},
"alternativeProgress2xLimit": {
"type": "number",
"description": "Percentage at which fake progress accelerates"
},
"alternativeProgressDefaultVelocity": {
"type": "boolean",
"description": "Use recommended fake progress speed"
},
"timeDisplayType": {
"type": "string",
"enum": [
"CURRENT_TIME",
"REMAINING_TIME"
],
"description": "Time display format"
},
"defaultLanguage": {
"type": "string",
"description": "Default subtitle language"
},
"mutedIndicatorIcon": {
"type": "boolean",
"description": "Show muted indicator overlay"
},
"mutedIndicatorSize": {
"type": "string",
"enum": [
"none",
"small",
"medium",
"large"
],
"description": "Muted indicator size"
},
"mutedIndicatorFontSize": {
"type": "number",
"description": "Muted indicator font size (12-32)"
},
"mutedIndicatorTextTop": {
"type": "string",
"description": "Muted indicator top text (max 40 chars)"
},
"mutedIndicatorTextBottom": {
"type": "string",
"description": "Muted indicator bottom text (max 40 chars)"
},
"mutedIndicatorBackgroundColor": {
"type": "string",
"description": "Muted indicator background color"
},
"mutedIndicatorTextColor": {
"type": "string",
"description": "Muted indicator text color"
},
"mutedIndicatorAnimation": {
"type": "string",
"description": "Muted indicator animation style"
}
},
"additionalProperties": false,
"description": "VSL (Video Sales Letter) settings — controls autoplay, smart autoplay, fake progress bar, muted indicator"
},
"saveProgress": {
"type": "object",
"properties": {
"saveProgress": {
"type": "boolean",
"description": "Enable resume from last position"
},
"initQuality": {
"type": "number",
"description": "Initial video quality (e.g. 720). Must be one of availableQualities when that list is set."
},
"saveProgressScreen": {
"type": "boolean",
"description": "Show resume screen"
},
"saveProgressTitle": {
"type": "string",
"description": "Resume screen title"
}
},
"additionalProperties": false,
"description": "Save progress / resume settings"
},
"general": {
"type": "object",
"properties": {
"default_speed": {
"type": "number",
"description": "Default playback speed (1, 1.1, 1.2, 1.3, 1.4, 1.5)"
},
"smartSearch": {
"type": "boolean",
"description": "(Legacy) Enable smart search in video. v2 sends `searchInsideVideo` — both accepted."
},
"startsWithSubtitle": {
"type": "boolean",
"description": "Whether the video starts with the subtitle track visible by default."
},
"searchInsideVideo": {
"type": "boolean",
"description": "Enable smart search inside the video (same semantic as legacy smartSearch)."
},
"theme": {
"type": "string",
"enum": [
"auto",
"dark",
"light"
],
"description": "Player theme: auto, dark or light."
},
"settingsControls": {
"type": "object",
"properties": {
"speed": {
"type": "boolean",
"description": "Speed item in the gear menu"
},
"quality": {
"type": "boolean",
"description": "Quality item in the gear menu"
},
"dubbing": {
"type": "boolean",
"description": "Dubbing (audio track) item in the gear menu"
},
"captionsLanguage": {
"type": "boolean",
"description": "Caption language item in the gear menu"
}
},
"additionalProperties": false,
"description": "Items of the gear (settings) menu. The profile stores the whole object — send all four."
},
"video_offline_enabled": {
"type": "boolean",
"description": "Allow offline viewing in the Panda app for the videos of this profile"
},
"expire_in_days_video": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "Days an offline download stays available"
},
"external_link_button_enabled": {
"type": "boolean",
"description": "Show an external link button in the offline app"
},
"external_link_url": {
"type": "string",
"maxLength": 2048,
"description": "External link URL (offline app)"
},
"external_link_text": {
"type": "string",
"maxLength": 200,
"description": "External link button text (offline app)"
}
},
"additionalProperties": false,
"description": "General player settings (speed, search-in-video, theme, gear menu, offline). Merged into the current values — keys you omit are kept."
},
"availableQualities": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d+p$"
},
"description": "Qualities the viewer can pick, e.g. [\"480p\",\"720p\",\"1080p\"]. Empty list = all qualities."
}
},
"required": [
"name"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}