Panda Video Referrer Management API

# Referrer Management Manages the **whitelist of domains** allowed to embed and play videos from this library. Combined with `block_none_refer`, this is the primary mechanism to control where the player is allowed to load. > 🚧 **All operations in this section require the `?action=` query parameter.** Without it, POST/DELETE requests return `405 Unsupported method`, and GET falls back to "library details" instead of returning referrers. ## Endpoints and actions | Method | `?action=` | Operation | |---|---|---| | GET | `refer` | List allowed referrers | | POST | `refer` | Add 1+ referrers | | POST | `referValidation` | Toggle the `block_none_refer` policy | | DELETE | `refer` | Remove 1+ referrers (asynchronous) | ## Referrer lifecycle ``` pending → active (worker confirmed the domain at the CDN) active → turning_inactive (when block_none_refer is set to false) active → deleting → row destroyed (worker removed from CDN) inactive ↔ pending (re-activated when block_none_refer turns true) ``` Intermediate states (`pending`, `turning_inactive`, `deleting`) typically resolve in seconds to a couple of minutes. Operations against a referrer in an intermediate state are rejected with `400 You have domains loading, please wait until they are loaded`. ## Side effects - Every mutation pushes a message to SQS — the refer worker reconciles the whitelist with Bunny CDN's `videolibrary` allowed-referers list. - Required system domains are always injected by the worker (dashboard, gstatic, `player-*` hostnames) — you do **not** need to add them manually. - Audit log entries are queued for `add` and `remove` actions under the `security` category. ## Business rules - `hostname` is validated by a strict regex (no scheme, no commas; wildcard `*.example.com` accepted). - Duplicate hostnames per library return `400 Refer already exists` (case-insensitive match). - Only `type: ALLOW` is processed today; the field is required but its value is effectively fixed.

GitHub OpenAPI

Operations 5

GET /library/{library_id} Get library details or referrers #
POST /library/{library_id} Add library or folder referrers #
DELETE /library/{library_id} Delete library or folder referrers #
PATCH /library/{library_id} Toggle a single referrer status (activate / deactivate) #
PUT /library/{library_id}/refer Update allowed domains (bulk) #

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-referrer-management-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-referrer-management-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Panda MS Library Referrer Management API
  description: 'API for managing video libraries in the Panda platform.


    This API allows you to:

    - Get and update video library settings

    - Configure encoding and playback qualities

    - Manage domain restrictions (referrer management)

    - Configure download blocking settings

    - Manage library-level security and configuration'
  version: 1.0.0
  contact:
    name: Panda Team
    email: support@panda.video
servers:
- url: https://api-v2.pandavideo.com
  description: Production server
- url: https://api-v2-staging.pandavideo.com
  description: Staging server
- url: http://localhost:10000
  description: Local development server
tags:
- name: Referrer Management
  description: '# Referrer Management


    Manages the **whitelist of domains** allowed to embed and play videos from this library. Combined with `block_none_refer`, this is the primary mechanism to control where the player is allowed to load.


    > 🚧 **All operations in this section require the `?action=` query parameter.** Without it, POST/DELETE requests return `405 Unsupported method`, and GET falls back to "library details" instead of returning referrers.


    ## Endpoints and actions


    | Method | `?action=` | Operation |

    |---|---|---|

    | GET | `refer` | List allowed referrers |

    | POST | `refer` | Add 1+ referrers |

    | POST | `referValidation` | Toggle the `block_none_refer` policy |

    | DELETE | `refer` | Remove 1+ referrers (asynchronous) |


    ## Referrer lifecycle


    ```

    pending → active (worker confirmed the domain at the CDN)

    active → turning_inactive (when block_none_refer is set to false)

    active → deleting → row destroyed (worker removed from CDN)

    inactive ↔ pending (re-activated when block_none_refer turns true)

    ```


    Intermediate states (`pending`, `turning_inactive`, `deleting`) typically resolve in seconds to a couple of minutes. Operations against a referrer in an intermediate state are rejected with `400 You have domains loading, please wait until they are loaded`.


    ## Side effects


    - Every mutation pushes a message to SQS — the refer worker reconciles the whitelist with Bunny CDN''s `videolibrary` allowed-referers list.

    - Required system domains are always injected by the worker (dashboard, gstatic, `player-*` hostnames) — you do **not** need to add them manually.

    - Audit log entries are queued for `add` and `remove` actions under the `security` category.


    ## Business rules


    - `hostname` is validated by a strict regex (no scheme, no commas; wildcard `*.example.com` accepted).

    - Duplicate hostnames per library return `400 Refer already exists` (case-insensitive match).

    - Only `type: ALLOW` is processed today; the field is required but its value is effectively fixed.'
paths:
  /library/{library_id}:
    get:
      summary: Get library details or referrers
      operationId: get-allowed-referer
      description: A single path that behaves in two distinct ways depending on whether the ?action=refer query parameter is present.
      tags:
      - Referrer Management
      security:
      - PandaAuth: []
      parameters:
      - name: library_id
        in: path
        required: true
        description: Unique identifier of the library
        schema:
          type: string
          format: uuid
      - name: action
        in: query
        required: false
        description: Omit to get library details, or set to read referrers
        schema:
          type: string
          enum:
          - refer
          - folder_refer
          - folder_refer_inherited
          - refer_all
      - name: folder_id
        in: query
        required: false
        description: Folder UUID — required when `action` is `folder_refer` or `folder_refer_inherited`
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: Library details or referrers retrieved successfully
          content:
            application/json:
              schema:
                oneOf:
                - type: object
                  properties:
                    data:
                      $ref: '#/components/schemas/LibraryDetails'
                    message:
                      type: string
                      example: Success
                - type: object
                  description: Referrers for `action=refer`, `folder_refer` or `folder_refer_inherited`
                  properties:
                    refers:
                      type: array
                      items:
                        $ref: '#/components/schemas/Referrer'
                - type: object
                  description: Consolidated referrers for `action=refer_all` (one entry per hostname)
                  properties:
                    refers:
                      type: array
                      items:
                        $ref: '#/components/schemas/ConsolidatedReferrer'
        '400':
          $ref: '#/components/responses/BadRequestError'
        '404':
          $ref: '#/components/responses/NotFoundError'
    post:
      summary: Add library or folder referrers
      description: A single path that supports two distinct operations discriminated by the required ?action= query parameter.
      tags:
      - Referrer Management
      security:
      - PandaAuth: []
      parameters:
      - name: library_id
        in: path
        required: true
        description: Unique identifier of the library
        schema:
          type: string
          format: uuid
      - name: action
        in: query
        required: true
        description: Action type
        schema:
          type: string
          enum:
          - refer
          - folder_refer
          - referValidation
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
              - $ref: '#/components/schemas/CreateReferrerRequest'
              - type: array
                items:
                  $ref: '#/components/schemas/CreateReferrerRequest'
              - $ref: '#/components/schemas/CreateFolderReferrerRequest'
              - $ref: '#/components/schemas/UpdateReferrerValidationRequest'
      responses:
        '200':
          description: Referrers created successfully
          content:
            application/json:
              schema:
                oneOf:
                - type: array
                  description: Created library-level referrers (`action=refer`)
                  items:
                    $ref: '#/components/schemas/Referrer'
                - type: object
                  description: Created folder-level referrer (`action=folder_refer`)
                  properties:
                    refer:
                      $ref: '#/components/schemas/Referrer'
                - type: object
                  description: Result of `action=referValidation`
                  properties:
                    message:
                      type: string
                      example: Refer policy updated successfully
        '400':
          $ref: '#/components/responses/BadRequestError'
        '404':
          $ref: '#/components/responses/NotFoundError'
      operationId: postLibraryByLibraryId
      x-operation-id-source: derived
    delete:
      summary: Delete library or folder referrers
      operationId: remove-referer
      description: 'Removes one or more allowed referrers from the library. The operation is asynchronous: referrers transition to status = deleting and a worker removes them from Bunny CDN before the database row is ...'
      tags:
      - Referrer Management
      security:
      - PandaAuth: []
      parameters:
      - name: library_id
        in: path
        required: true
        description: Unique identifier of the library
        schema:
          type: string
          format: uuid
      - name: action
        in: query
        required: true
        description: Action type
        schema:
          type: string
          enum:
          - refer
          - folder_refer
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
              - $ref: '#/components/schemas/DeleteReferrerRequest'
              - type: array
                description: Batch delete — an array of referrer IDs (supported for both `action=refer` and `action=folder_refer`)
                items:
                  $ref: '#/components/schemas/DeleteReferrerRequest'
      responses:
        '200':
          description: Referrers removed successfully (soft delete — status set to `deleting`)
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: '`Refers is being removed` for `action=refer`; `Refers are being removed` for `action=folder_refer`'
                    example: Refers is being removed
        '400':
          $ref: '#/components/responses/BadRequestError'
        '404':
          $ref: '#/components/responses/NotFoundError'
    patch:
      summary: Toggle a single referrer status (activate / deactivate)
      description: Activates or deactivates a single referrer by refer_id, selected by ?action=refer_status. This toggles one referrer without changing the global block_none_refer policy.
      tags:
      - Referrer Management
      security:
      - PandaAuth: []
      parameters:
      - name: library_id
        in: path
        required: true
        description: Unique identifier of the library
        schema:
          type: string
          format: uuid
      - name: action
        in: query
        required: true
        description: Must be `refer_status`
        schema:
          type: string
          enum:
          - refer_status
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ToggleReferrerStatusRequest'
      responses:
        '200':
          description: Referrer status toggled successfully (or already in the requested state)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToggleReferrerStatusResponse'
        '400':
          description: Operation already in progress (referrer in an intermediate state)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                errCode: BadRequest
                errMsg: Operation in progress, please wait until the current operation is completed
        '403':
          description: The referrer does not belong to this library
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                errCode: Forbidden
                errMsg: Refer does not belong to this library
        '404':
          description: Library or referrer not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                errCode: NotFound
                errMsg: Refer not found
      operationId: patchLibraryByLibraryId
      x-operation-id-source: derived
  /library/{library_id}/refer:
    put:
      summary: Update allowed domains (bulk)
      operationId: edit-allowed-domains
      description: 'Edits one or more existing domain referrers (refer_ids) in a single transactional call (mass edit). In one request it can:

        - rename the domain (hostname) in place on the kept rows,

        - change the sco...'
      tags:
      - Referrer Management
      security:
      - PandaAuth: []
      parameters:
      - name: library_id
        in: path
        required: true
        description: Unique identifier of the library
        schema:
          type: string
          format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateFolderReferrerRequest'
            examples:
              renameToLibraryScope:
                summary: Rename a domain and move it to library scope
                value:
                  refer_ids:
                  - 789e4567-e89b-12d3-a456-426614174999
                  hostname: '*.novo-cliente.com'
                  type: ALLOW
                  scope: library
              editFolderSet:
                summary: Set the folders a domain applies to (add/remove diff)
                value:
                  refer_ids:
                  - 789e4567-e89b-12d3-a456-426614174999
                  - 999e4567-e89b-12d3-a456-426614174000
                  hostname: '*.cliente.com'
                  type: BLOCK
                  scope: folder
                  folder_ids:
                  - 22222222-2222-4222-8222-222222222222
                  - 33333333-3333-4333-8333-333333333333
      responses:
        '200':
          description: Domain referrers edited successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateFolderReferrerResponse'
        '400':
          $ref: '#/components/responses/BadRequestError'
        '404':
          $ref: '#/components/responses/NotFoundError'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    ToggleReferrerStatusResponse:
      type: object
      description: The referrer after the toggle operation
      properties:
        id:
          type: string
          format: uuid
          example: 789e4567-e89b-12d3-a456-426614174999
        url:
          type: string
          example: example.com
        type:
          type: string
          enum:
          - ALLOW
          - BLOCK
          example: ALLOW
        status:
          type: string
          enum:
          - active
          - inactive
          - pending
          - deleting
          - turning_inactive
          example: pending
        library_id:
          type: string
          format: uuid
          example: 123e4567-e89b-12d3-a456-426614174000
    ToggleReferrerStatusRequest:
      type: object
      required:
      - refer_id
      - active
      additionalProperties: false
      properties:
        refer_id:
          type: string
          format: uuid
          description: ID of the referrer to activate or deactivate
          example: 789e4567-e89b-12d3-a456-426614174999
        active:
          type: boolean
          description: '`true` to activate (→ pending), `false` to deactivate (→ turning_inactive)'
          example: true
    CreateReferrerRequest:
      type: object
      required:
      - hostname
      - type
      properties:
        hostname:
          type: string
          description: Domain hostname to add as allowed referrer
          example: example.com
        type:
          type: string
          enum:
          - ALLOW
          - BLOCK
          example: ALLOW
    UpdateFolderReferrerRequest:
      description: 'Payload for `PUT /library/{library_id}/refer`. Edits one or more referrers (`refer_ids`) in a single call (mass edit). The target scope is set by `scope`:

        - `scope: library` — the domain applies to the whole library (omit `folder_ids`).

        - `scope: folder` — the domain applies to the listed folders (`folder_ids` required, non-empty, unique).

        '
      oneOf:
      - title: Library scope
        type: object
        required:
        - refer_ids
        - hostname
        - type
        - scope
        properties:
          refer_ids:
            type: array
            description: IDs of the referrer rows to edit
            minItems: 1
            maxItems: 50
            uniqueItems: true
            items:
              type: string
              format: uuid
            example:
            - 789e4567-e89b-12d3-a456-426614174999
          hostname:
            type: string
            description: Target domain hostname (renamed in place when different from the current value)
            example: '*.novo-cliente.com'
          type:
            type: string
            enum:
            - ALLOW
            - BLOCK
            example: ALLOW
          scope:
            type: string
            enum:
            - library
            example: library
      - title: Folder scope
        type: object
        required:
        - refer_ids
        - hostname
        - type
        - scope
        - folder_ids
        properties:
          refer_ids:
            type: array
            description: IDs of the referrer rows to edit
            minItems: 1
            maxItems: 50
            uniqueItems: true
            items:
              type: string
              format: uuid
            example:
            - 789e4567-e89b-12d3-a456-426614174999
          hostname:
            type: string
            description: Target domain hostname (renamed in place when different from the current value)
            example: '*.novo-cliente.com'
          type:
            type: string
            enum:
            - ALLOW
            - BLOCK
            example: ALLOW
          scope:
            type: string
            enum:
            - folder
            example: folder
          folder_ids:
            type: array
            description: Target folder UUIDs the domain should apply to; the backend computes the add/remove diff against the current state
            minItems: 1
            maxItems: 50
            uniqueItems: true
            items:
              type: string
              format: uuid
            example:
            - 22222222-2222-4222-8222-222222222222
            - 33333333-3333-4333-8333-333333333333
    ErrorResponse:
      type: object
      description: Standard error envelope returned by the service for any non-2xx response.
      properties:
        errCode:
          type: string
          description: Error category
          enum:
          - BadRequest
          - NotFound
          - Forbidden
          - MethodNotAllowed
          - InternalServerError
          example: BadRequest
        errMsg:
          type: string
          description: Human-readable error message
          example: Refer already exists
    UpdateReferrerValidationRequest:
      type: object
      required:
      - block_none_refer
      properties:
        block_none_refer:
          type: boolean
          description: Whether to block requests without referrer
          example: true
    CreateFolderReferrerRequest:
      type: object
      required:
      - folder_id
      - hostname
      - type
      properties:
        folder_id:
          type: string
          format: uuid
          description: Folder UUID where this referrer applies
          example: 22222222-2222-4222-8222-222222222222
        hostname:
          type: string
          description: Domain hostname to add as allowed referrer for the folder
          example: '*.cliente.com'
        type:
          type: string
          enum:
          - ALLOW
          - BLOCK
          example: ALLOW
    LibraryDetails:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique library identifier
          example: 123e4567-e89b-12d3-a456-426614174000
        user_id:
          type: string
          format: uuid
          description: Owner user ID
          example: 2481ef9b-5642-4fcd-b9aa-094e98b5cf0a
        name:
          type: string
          description: Library name
          example: My Video Library
        video_library_id:
          type: integer
          description: Bunny video library ID
          example: 12345
        pullzone_name:
          type: string
          description: CDN pullzone name
          example: my-pullzone
        pullzone_id:
          type: integer
          description: CDN pullzone ID
          example: 67890
        api_key:
          type: string
          description: API key for video library
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        video_library_pullzone_id:
          type: integer
          description: Video library pullzone ID
          example: 54321
        parallel_upload_limit:
          type: integer
          description: Maximum number of parallel uploads allowed
          minimum: 1
          maximum: 10
          example: 5
        playback:
          type: array
          description: Available playback quality resolutions
          items:
            type: string
            enum:
            - 240p
            - 360p
            - 480p
            - 720p
            - 1080p
            - 1440p
            - 2160p
          example:
          - 360p
          - 480p
          - 720p
          - 1080p
        encoding:
          type: array
          description: Encoding quality resolutions for video conversion
          items:
            type: string
            enum:
            - 240p
            - 360p
            - 480p
            - 720p
            - 1080p
            - 1440p
            - 2160p
          example:
          - 360p
          - 480p
          - 720p
          - 1080p
        keep_original_files:
          type: boolean
          description: Whether to keep original uploaded video files
          example: true
        block_none_refer:
          type: boolean
          description: Whether to block requests without referrer
          example: true
        drm:
          type:
          - object
          - 'null'
          description: DRM configuration (optional)
          additionalProperties: true
          example: null
        created:
          type: string
          format: date-time
          description: Library creation timestamp
          example: '2024-01-15T10:30:00.000Z'
    UpdateFolderReferrerResponse:
      type: object
      description: Result of a `PUT /library/{library_id}/refer` edit
      properties:
        message:
          type: string
          example: Domain updated successfully
        hostname:
          type: string
          example: '*.novo-cliente.com'
        type:
          type: string
          enum:
          - ALLOW
          - BLOCK
          example: ALLOW
        scope:
          type: string
          enum:
          - library
          - folder
          example: folder
        renamed:
          type: boolean
          description: Whether the hostname was changed
          example: true
        folders_added:
          type: array
          description: Folder UUIDs that received the domain in this call
          items:
            type: string
            format: uuid
          example:
          - 33333333-3333-4333-8333-333333333333
        folders_removed:
          type: array
          description: Folder UUIDs the domain was removed from in this call
          items:
            type: string
            format: uuid
          example:
          - 22222222-2222-4222-8222-222222222222
        refers:
          type: array
          description: The referrer rows modified in this call, with their new status
          items:
            $ref: '#/components/schemas/Referrer'
          example:
          - id: 789e4567-e89b-12d3-a456-426614174999
            url: '*.novo-cliente.com'
            type: ALLOW
            status: active
            origin:
              type: folder
              id: 22222222-2222-4222-8222-222222222222
          - id: 999e4567-e89b-12d3-a456-426614174000
            url: '*.novo-cliente.com'
            type: ALLOW
            status: pending
            origin:
              type: folder
              id: 33333333-3333-4333-8333-333333333333
    DeleteReferrerRequest:
      type: object
      required:
      - refer_id
      properties:
        refer_id:
          type: string
          format: uuid
          description: ID of the referrer to delete
          example: 789e4567-e89b-12d3-a456-426614174999
    ConsolidatedReferrer:
      type: object
      description: 'A single hostname consolidated across the library and folder scopes,

        returned by `GET /library/{library_id}?action=refer_all`.

        '
      properties:
        hostname:
          type: string
          description: The domain hostname (lowercased, trimmed)
          example: '*.cliente.com'
        type:
          type: string
          enum:
          - ALLOW
          - BLOCK
          example: ALLOW
        status:
          type: string
          description: Aggregated status across all scopes for this hostname; `mixed` when the rows differ.
          enum:
          - active
          - inactive
          - pending
          - deleting
          - turning_inactive
          - mixed
          example: active
        scope:
          type: string
          description: 'Where this hostname applies:

            - `library` — only at library level

            - `folder` — only in folders

            - `mixed` — both library level and folders

            '
          enum:
          - library
          - folder
          - mixed
          example: mixed
        library_refer_id:
          type:
          - string
          - 'null'
          format: uuid
          description: ID of the library-level referrer row (`folder_id=null`), or `null` when the hostname is not set at library level.
          example: 789e4567-e89b-12d3-a456-426614174999
        folders:
          type: array
          description: Folder-level rows for this hostname (empty when the hostname is only at library level).
          items:
            type: object
            properties:
              folder_id:
                type: string
                format: uuid
                example: 22222222-2222-4222-8222-222222222222
              name:
                type:
                - string
                - 'null'
                description: Folder name, or `null` if it could not be resolved.
                example: Cursos
              refer_id:
                type: string
                format: uuid
                example: 999e4567-e89b-12d3-a456-426614174000
              status:
                type: string
                enum:
                - active
                - inactive
                - pending
                - deleting
                - turning_inactive
                example: active
        type_inconsistency:
          type: boolean
          description: True when rows of the same hostname have divergent `type` values (historical inconsistency).
          example: false
        created_at:
          type: string
          format: date-time
          description: Timestamp of the most recent referrer row in the group.
          example: '2024-01-15T10:30:00.000Z'
    Referrer:
      type: object
      description: Domain referrer restriction
      properties:
        id:
          type: string
          format: uuid
          description: Unique referrer identifier
          example: 789e4567-e89b-12d3-a456-426614174999
        type:
          type: string
          description: Referrer type
          enum:
          - ALLOW
          - BLOCK
          example: ALLOW
        url:
          type: string
          description: Domain URL
          example: example.com
        status:
          type: string
          description: Current status of the referrer
          enum:
          - active
          - inactive
          - pending
          - deleting
          - turning_inactive
          example: active
        origin:
          type: object
          description: Scope this referrer applies to. Only present in `folder_refer` and `folder_refer_inherited` responses.
          properties:
            type:
              type: string
              enum:
              - library
              - folder
              example: folder
            id:
              type: string
              format: uuid
              example: 22222222-2222-4222-8222-222222222222
  responses:
    BadRequestError:
      description: Bad request - Invalid input parameters
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            errCode: BadRequest
            errMsg: 'must be equal to one of the allowed values: ALLOW,BLOCK.'
    NotFoundError:
      description: Not found - Resource does not exist
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            errCode: NotFound
            errMsg: Library not found
    InternalServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            errCode: InternalServerError
            errMsg: Error retrieving library information
  securitySchemes:
    PandaAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Panda API token (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/edit-allowed-domains.md
  - https://docs.pandavideo.com/reference/get-allowed-referer-1.md
  - https://docs.pandavideo.com/reference/get-user-library-1.md
  - https://docs.pandavideo.com/reference/get_block-download.md
  - https://docs.pandavideo.com/reference/patch_library-library-id.md
  - https://docs.pandavideo.com/reference/post_library-library-id.md
  - https://docs.pandavideo.com/reference/put_block-download.md
  - https://docs.pandavideo.com/reference/quality-1.md
  - https://docs.pandavideo.com/reference/remove-referer-1.md
  merge:
    pages: 9
    deduped: 36
    conflicts_kept_first: 0