Panda Video Profiles API

Operations for managing video player profiles

GitHub OpenAPI

Operations 9

GET /profile List user profiles #
POST /profile Create new profile #
GET /profile/{profile_id} Get profile details #
PUT /profile/{profile_id} Update profile #
DELETE /profile/{profile_id} Delete profile #
POST /profile/{profile_id}?type=duplicate Duplicate profile #
POST /profile/{profile_id}?type=restore Restore profile defaults #
PUT /profile/{profile_id}?type=set-default Set as default profile #
POST /profile?type=set-videos Set profile to videos #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/pandavideo-com:pandavideo-com-profiles-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

pandavideo-com-profiles-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Panda MS Profile Profiles API
  description: API for managing video player profiles.
  version: 1.0.0
  contact:
    name: Panda Team
    email: support@panda.video
servers:
- url: https://api-v2.pandavideo.com.br
  description: Production server
tags:
- name: Profiles
  description: Operations for managing video player profiles
paths:
  /profile:
    get:
      summary: List user profiles
      operationId: list-user-profiles
      description: Retrieves all shared player profiles for the account
      tags:
      - Profiles
      security:
      - PandaAuth: []
      responses:
        '200':
          description: Array of profile summaries
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ProfileSummary'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '500':
          $ref: '#/components/responses/InternalServerError'
    post:
      summary: Create new profile
      operationId: create-new-profile
      description: Creates a new player profile
      tags:
      - Profiles
      security:
      - PandaAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateProfileRequest'
      responses:
        '201':
          description: Profile created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProfileCreated'
        '400':
          $ref: '#/components/responses/BadRequestError'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '500':
          $ref: '#/components/responses/InternalServerError'
  /profile/{profile_id}:
    parameters:
    - name: profile_id
      in: path
      required: true
      schema:
        type: string
        format: uuid
    get:
      summary: Get profile details
      operationId: get-profile-details
      description: Retrieves full details of a specific player profile
      tags:
      - Profiles
      security:
      - PandaAuth: []
      responses:
        '200':
          description: Profile details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProfileDetails'
        '404':
          $ref: '#/components/responses/NotFoundError'
    put:
      summary: Update profile
      operationId: update-profile
      description: Updates a player profile, propagating to linked videos
      tags:
      - Profiles
      security:
      - PandaAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateProfileRequest'
      responses:
        '200':
          description: Updated profile
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProfileDetails'
        '404':
          $ref: '#/components/responses/NotFoundError'
    delete:
      summary: Delete profile
      operationId: delete-profile
      description: Deletes a profile with strategy for linked videos
      tags:
      - Profiles
      security:
      - PandaAuth: []
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteProfileRequest'
      responses:
        '200':
          description: Profile deleted
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Success
        '400':
          $ref: '#/components/responses/BadRequestError'
        '404':
          $ref: '#/components/responses/NotFoundError'
  /profile/{profile_id}?type=duplicate:
    post:
      summary: Duplicate profile
      operationId: duplicate-profile
      description: Creates a copy of a profile
      tags:
      - Profiles
      security:
      - PandaAuth: []
      parameters:
      - name: profile_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '201':
          description: Duplicated profile
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                  name:
                    type: string
        '404':
          $ref: '#/components/responses/NotFoundError'
  /profile/{profile_id}?type=restore:
    post:
      summary: Restore profile defaults
      operationId: restore-profile
      description: Resets a profile to system defaults
      tags:
      - Profiles
      security:
      - PandaAuth: []
      parameters:
      - name: profile_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: Restored profile
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProfileDetails'
        '404':
          $ref: '#/components/responses/NotFoundError'
  /profile/{profile_id}?type=set-default:
    put:
      summary: Set as default profile
      operationId: set-default-profile
      description: Makes a profile the account default
      tags:
      - Profiles
      security:
      - PandaAuth: []
      parameters:
      - name: profile_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SetDefaultRequest'
      responses:
        '200':
          description: Default updated
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Default profile updated
                  id:
                    type: string
                    format: uuid
                  videoMigrationQueued:
                    type: boolean
        '404':
          $ref: '#/components/responses/NotFoundError'
  /profile?type=set-videos:
    post:
      summary: Set profile to videos
      operationId: set-profile-to-videos
      description: Applies a profile to videos or a folder
      tags:
      - Profiles
      security:
      - PandaAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SetProfileToVideosRequest'
      responses:
        '200':
          description: Applied (sync if <= 5 videos, async otherwise)
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                    - ok
                    - pending
        '400':
          $ref: '#/components/responses/BadRequestError'
components:
  responses:
    BadRequestError:
      description: Bad request
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: Validation failed
    NotFoundError:
      description: Not found
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: Profile not found
    InternalServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: Error to retrieve profiles
    UnauthorizedError:
      description: Unauthorized
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: Authentication required
  schemas:
    ProfileCreated:
      type: object
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
    DeleteProfileRequest:
      type: object
      properties:
        strategy:
          type: string
          enum:
          - migrate
          - keep
          description: 'What happens to linked videos: migrate them to another profile, or keep each video''s current settings.'
        target_profile_id:
          type: string
          format: uuid
          description: Required when strategy is migrate. The profile to move linked videos to.
    CreateProfileRequest:
      type: object
      required:
      - name
      properties:
        name:
          type: string
          minLength: 3
          maxLength: 255
          description: Profile name (3-255 characters)
        exclusive:
          type: boolean
        is_default:
          type: boolean
        source_video_id:
          type: string
          format: uuid
          description: Seed config from this video instead of system defaults
        hideControlsOnStart:
          type: boolean
        colors:
          $ref: '#/components/schemas/ProfileColors'
        vsl:
          $ref: '#/components/schemas/VSLConfig'
        saveProgress:
          $ref: '#/components/schemas/SaveProgressConfig'
        general:
          type: object
          additionalProperties: true
        controls:
          type: array
          items:
            type: string
            enum:
            - play-large
            - rewind
            - play
            - fast-forward
            - progress
            - current-time
            - volume
            - captions
            - settings
            - fullscreen
            - pause
            - quality
        availableQualities:
          type:
          - array
          - 'null'
          items:
            type: string
            pattern: ^\d+p$
    ProfileDetails:
      type: object
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        pullzone_name:
          type: string
        is_default:
          type: boolean
        isDefault:
          type: boolean
          description: Same as is_default (camelCase alias)
        availableQualities:
          type:
          - array
          - 'null'
          items:
            type: string
            pattern: ^\d+p$
        feature_tags:
          type: array
          items:
            type: string
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        hideControlsOnStart:
          type:
          - boolean
          - 'null'
        controls:
          type: array
          items:
            type: string
            enum:
            - play-large
            - rewind
            - play
            - fast-forward
            - progress
            - current-time
            - volume
            - captions
            - settings
            - fullscreen
            - pause
            - quality
        colors:
          $ref: '#/components/schemas/ProfileColors'
        vsl:
          $ref: '#/components/schemas/VSLConfig'
        saveProgress:
          $ref: '#/components/schemas/SaveProgressConfig'
        general:
          type: object
          additionalProperties: true
    SaveProgressConfig:
      type: object
      description: Configuration for save progress functionality
      properties:
        saveProgress:
          type: boolean
          description: Enable save-progress feature
          example: true
        initQuality:
          type: integer
          description: Initial video quality (must be one of availableQualities if set)
          minimum: 240
          maximum: 2160
          example: 720
        saveProgressScreen:
          type: boolean
          description: Show save-progress screen
          example: true
        saveProgressTitle:
          type: string
          description: Dialog title
          minLength: 3
          maxLength: 100
          example: Continue learning?
        saveProgressBackgroundOpacity:
          type: number
          description: Background opacity (0-1)
          minimum: 0
          maximum: 1
          example: 0.8
        saveProgressButton1Title:
          type: string
          description: Continue button label
          minLength: 3
          maxLength: 30
          example: Continue
        saveProgressButton2Title:
          type: string
          description: Start-over button label
          minLength: 3
          maxLength: 30
          example: Start over
    SetDefaultRequest:
      type: object
      properties:
        unlinkedVideosStrategy:
          type: string
          enum:
          - apply-new
          - keep-current
          description: 'What to do with unlinked videos from the previous default. apply-new: follow the new default. keep-current: re-link to the previous default explicitly.'
    ProfileColors:
      type: object
      description: Color configuration for the video player
      properties:
        primaryColor:
          type: string
          description: Primary theme color
          pattern: ^#[0-9A-Fa-f]{6}$
          example: '#8000FA'
        controlsColor:
          type: string
          description: Player controls color
          pattern: ^#[0-9A-Fa-f]{6}$
          example: '#FFFFFF'
        captionsColor:
          type: string
          description: Caption text color
          pattern: ^#[0-9A-Fa-f]{6}$
          example: '#FFFFFF'
        captionsBackgroundColor:
          type: string
          description: Caption background color
          pattern: ^#[0-9A-Fa-f]{6}$
          example: '#000000'
        background:
          type: string
          description: Player background color
          pattern: ^#[0-9A-Fa-f]{6}$
          example: '#000000'
    ProfileSummary:
      type: object
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
          example: VSL
        pullzone_name:
          type: string
        is_default:
          type: boolean
          description: Whether this is the account default profile
        updated_at:
          type: string
          format: date-time
        videos_count:
          type: integer
          description: Number of videos using this profile
        feature_tags:
          type: array
          items:
            type: string
          description: Which config sections differ from defaults
        colors:
          $ref: '#/components/schemas/ProfileColors'
        availableQualities:
          type:
          - array
          - 'null'
          items:
            type: string
            pattern: ^\d+p$
          description: Allowed resolutions, e.g. ["480p","720p"]. null means no restriction.
    VSLConfig:
      type: object
      description: Video Sales Letter and advanced player configuration
      properties:
        autoplay:
          type: boolean
          description: Enable autoplay
          example: true
        smartAutoplay:
          type: boolean
          description: Smart autoplay based on user behavior
          example: false
        alternativeProgress:
          type: boolean
          description: Use alternative progress bar
          example: false
        alternativeProgressHeight:
          type: number
          description: Alternative progress bar height
          example: 10
        alternativeProgressVelocity:
          type: number
          description: Progress bar velocity multiplier
          example: 2
        alternativeProgressDefaultVelocity:
          type: boolean
          description: Use default velocity
          example: false
        alternativeProgress2xLimit:
          type: number
          description: Limit for 2x speed in alternative progress
          example: 50
        mutedIndicatorIcon:
          type: boolean
          description: Show muted indicator icon
          example: true
        mutedIndicatorFontSize:
          type: number
          description: Muted indicator font size
          example: 22
        mutedIndicatorTextTop:
          type: string
          description: Muted indicator top text
          maxLength: 30
          example: Click here
        mutedIndicatorTextBottom:
          type: string
          description: Muted indicator bottom text
          maxLength: 30
          example: to activate the sound
        mutedIndicatorBackgroundColor:
          type: string
          description: Muted indicator background
          example: rgba(128, 0, 250, 1.00)
        mutedIndicatorTextColor:
          type: string
          description: Muted indicator text color
          example: rgba(255, 255, 255, 1.00)
        mutedIndicatorAnimation:
          type: string
          description: Animation type
          enum:
          - impact
          - fade
          - slide
          - bounce
          example: impact
        mutedIndicatorSize:
          type: string
          description: Indicator size
          enum:
          - small
          - medium
          - large
          example: small
        mutedIndicatorBorderSize:
          type: number
          description: Muted indicator border size
          example: 2
        mutedIndicatorLoop:
          type: boolean
          description: Loop muted indicator animation
          example: false
        mutedIndicatorLoopDuration:
          type: number
          description: Loop duration in seconds
          example: 15
        customMutedIndicatorId:
          type:
          - string
          - 'null'
          description: Custom muted indicator ID
          example: null
        smallMutedIcon:
          type: boolean
          description: Use small muted icon
          example: false
        restartAfterEnd:
          type: boolean
          description: Restart video after it ends
          example: false
        disablePause:
          type: boolean
          description: Disable pause
          example: false
        disableForward:
          type: boolean
          description: Disable forward seeking
          example: false
        fbPixel:
          type: string
          description: Facebook Pixel ID
          maxLength: 50
          example: ''
        gtagIds:
          type: array
          items:
            type:
            - string
            - 'null'
          description: Google Analytics tracking IDs
          example:
          - null
        pandaBranding:
          type: boolean
          description: Deprecated. Read from account global player settings since September 2026. Values sent here are ignored.
          example: true
          deprecated: true
        refCode:
          type: string
          description: Deprecated. Read from account global player settings since September 2026. Values sent here are ignored.
          maxLength: 30
          example: ''
          deprecated: true
    SetProfileToVideosRequest:
      type: object
      required:
      - profile
      properties:
        profile:
          type: string
          format: uuid
          description: Profile ID to apply
        videos:
          type: array
          items:
            type: string
          description: Video IDs. Mutually exclusive with folder_id.
        folder_id:
          type: string
          format: uuid
          description: Apply to all videos in this folder. Mutually exclusive with videos.
    UpdateProfileRequest:
      type: object
      properties:
        name:
          type: string
          minLength: 3
          maxLength: 255
        exclusive:
          type: boolean
        hideControlsOnStart:
          type:
          - boolean
          - 'null'
        colors:
          $ref: '#/components/schemas/ProfileColors'
        vsl:
          $ref: '#/components/schemas/VSLConfig'
        saveProgress:
          $ref: '#/components/schemas/SaveProgressConfig'
        general:
          type: object
          additionalProperties: true
        controls:
          type: array
          items:
            type: string
            enum:
            - play-large
            - rewind
            - play
            - fast-forward
            - progress
            - current-time
            - volume
            - captions
            - settings
            - fullscreen
            - pause
            - quality
        availableQualities:
          type:
          - array
          - 'null'
          items:
            type: string
            pattern: ^\d+p$
          description: Allowed resolutions with the p suffix, e.g. ["480p","720p"]. null or empty array means no restriction.
  securitySchemes:
    PandaAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Panda API key (without Bearer prefix)
x-provenance:
  method: searched
  source: https://docs.pandavideo.com/reference
  harvested: '2026-11-20'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://docs.pandavideo.com/reference/create-new-profile-1.md
  - https://docs.pandavideo.com/reference/delete-profile.md
  - https://docs.pandavideo.com/reference/duplicate-profile.md
  - https://docs.pandavideo.com/reference/get-profile-details.md
  - https://docs.pandavideo.com/reference/list-user-profiles-1.md
  - https://docs.pandavideo.com/reference/restore-profile.md
  - https://docs.pandavideo.com/reference/set-default-profile.md
  - https://docs.pandavideo.com/reference/set-profile-to-videos.md
  - https://docs.pandavideo.com/reference/update-profile.md
  merge:
    pages: 9
    deduped: 31
    conflicts_kept_first: 0