Panda Video Thumbnails API

Operations for managing video thumbnails

GitHub OpenAPI

Operations 3

POST /thumbs/{video_id} Upload video thumbnail #
GET /thumbs/{video_id} Get video thumbnails #
DELETE /thumbs/{video_id} Delete video thumbnail #

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-thumbnails-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-thumbnails-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Panda MS Thumbs Thumbnails API
  description: 'API for managing video thumbnails in the Panda platform.


    This API allows you to:

    - Upload, retrieve, and delete video thumbnails

    - Manage pause screen thumbnails

    - Configure live stream thumbnails

    - Handle end screen thumbnails

    - Work with custom and auto-generated thumbnails'
  version: 1.0.0
  contact:
    name: Panda Team
    email: support@panda.video
servers:
- url: https://api-v2.pandavideo.com.br
  description: Production server
- url: https://api-v2-staging.pandavideo.com
  description: Staging server
- url: http://localhost:10000
  description: Local development server
tags:
- name: Thumbnails
  description: Operations for managing video thumbnails
paths:
  /thumbs/{video_id}:
    post:
      summary: Upload video thumbnail
      description: Uploads a custom thumbnail (multipart/form-data) for a video. Use query ?type=pause|live|end to target a specific kind; omit type for the default start/cover thumbnail.
      tags:
      - Thumbnails
      security:
      - PandaAuth: []
      parameters:
      - name: video_id
        in: path
        required: true
        description: Unique identifier of the video
        schema:
          type: string
          format: uuid
      - name: type
        in: query
        required: false
        description: Type of thumbnail to upload
        schema:
          type: string
          enum:
          - pause
          - live
          - end
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                file:
                  type: string
                  format: binary
                  description: Image file for the thumbnail (JPEG, PNG, or GIF)
      responses:
        '200':
          description: Thumbnail uploaded successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  response:
                    $ref: '#/components/schemas/UploadThumbnailResponse'
        '400':
          $ref: '#/components/responses/BadRequestError'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '404':
          $ref: '#/components/responses/NotFoundError'
        '500':
          $ref: '#/components/responses/InternalServerError'
      operationId: postThumbsByVideoId
      x-operation-id-source: derived
    get:
      summary: Get video thumbnails
      description: Returns all thumbnails for a video — start/cover (custom + auto-generated candidates), pause, and end. Filenames are relative to the CDN; prefix accordingly to render.
      tags:
      - Thumbnails
      security:
      - PandaAuth: []
      parameters:
      - name: video_id
        in: path
        required: true
        description: Unique identifier of the video
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: Video thumbnails retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  response:
                    $ref: '#/components/schemas/ThumbnailResponse'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '404':
          $ref: '#/components/responses/NotFoundError'
        '500':
          $ref: '#/components/responses/InternalServerError'
      operationId: getThumbsByVideoId
      x-operation-id-source: derived
    delete:
      summary: Delete video thumbnail
      description: Deletes a custom thumbnail (start/pause/live/end). For pause, thumbName query is required to target the specific entry. After deletion the video falls back to auto-generated thumbnails.
      tags:
      - Thumbnails
      security:
      - PandaAuth: []
      parameters:
      - name: video_id
        in: path
        required: true
        description: Unique identifier of the video
        schema:
          type: string
          format: uuid
      - name: type
        in: query
        required: false
        description: Type of thumbnail to delete
        schema:
          type: string
          enum:
          - pause
          - live
          - end
      - name: thumbName
        in: query
        required: false
        description: Specific thumbnail name to delete (for pause type)
        schema:
          type: string
      responses:
        '200':
          description: Thumbnail deleted successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  response:
                    type: object
                    properties:
                      message:
                        type: string
                        example: Thumbnail deleted
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '404':
          $ref: '#/components/responses/NotFoundError'
        '500':
          $ref: '#/components/responses/InternalServerError'
      operationId: deleteThumbsByVideoId
      x-operation-id-source: derived
components:
  responses:
    BadRequestError:
      description: Bad request - Invalid input parameters
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: Invalid file format
    NotFoundError:
      description: Not found - Video or resource does not exist
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: Video not found
    InternalServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: Error uploading thumbnail
    UnauthorizedError:
      description: Unauthorized - Invalid or missing authentication
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: Authentication required
  schemas:
    UploadThumbnailResponse:
      type: object
      description: Response after successful thumbnail upload
      properties:
        thumb:
          type: string
          description: Filename of the uploaded thumbnail
          example: a1b2c3d4-5678-90ab-cdef-123456789abc.jpg
        pauseThumbnail:
          type: array
          items:
            type: string
          description: Array of pause thumbnail filenames (for pause type)
          example:
          - a1b2c3d4-5678-90ab-cdef-pause.jpg
        endThumbnail:
          type: string
          description: Filename of the end thumbnail (for end type)
          example: a1b2c3d4-5678-90ab-cdef-end.jpg
        thumbnail:
          type: string
          description: Filename of the live thumbnail (for live type)
          example: a1b2c3d4-5678-90ab-cdef-live.jpg
    ThumbnailResponse:
      type: object
      description: Response containing video thumbnail information
      properties:
        active:
          type: string
          description: Currently active custom thumbnail filename
          example: a1b2c3d4-5678-90ab-cdef-123456789abc.jpg
        default:
          type: array
          items:
            type: string
          description: List of auto-generated thumbnail URLs
          example:
          - https://cdn.pandavideo.com/thumbs/video123_001.jpg
          - https://cdn.pandavideo.com/thumbs/video123_002.jpg
          - https://cdn.pandavideo.com/thumbs/video123_003.jpg
  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/delete_thumbs-video-id.md
  - https://docs.pandavideo.com/reference/get_thumbs-video-id.md
  - https://docs.pandavideo.com/reference/post_thumbs-video-id.md
  merge:
    pages: 3
    deduped: 8
    conflicts_kept_first: 0