Panda Video Private - Comments API

Private operations for comment management. **Authentication:** API Key in the `Authorization` header **Base URL:** `/video-review/{video_id}` with `?action=comment` Allows video owners to view and manage all comments on their videos.

GitHub OpenAPI

Operations 4

POST /video-review/{video_id}/comments Create comment #
GET /video-review/{video_id}/comments List comments #
DELETE /video-review/{video_id}/comments/{comment_id} Delete comment #
PUT /video-review/{video_id}/comments/{comment_id} Update comment #

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-private-comments-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-private-comments-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Panda Video Review Private - Comments API
  description: 'API for managing video review links and comments. Allows video owners to create review links to share with external reviewers, who can add comments at specific video timestamps.


    ## Overview


    This API is divided into two parts:


    ### Public API

    Used by external reviewers to access videos through review links and add comments. Authentication is done via `link_id` in the URL path and `token` as a query parameter.


    The `token` functions as a user session identifier. To edit or delete a comment, you must use the same `token` used during creation.


    ### Private API

    Used by video owners to manage review links and comments. Authentication is done via API Key in the `Authorization` header.


    ## Limits and Restrictions


    - **Link expiration**: Maximum of 30 days from the creation date

    - **Comments per video**: Maximum of 30 main comments per video

    - **Replies per comment**: Maximum of 30 replies per comment

    - **Text size**: Maximum of 500 characters per comment'
  version: 1.0.0
  contact:
    name: Panda Video Team
    email: support@pandavideo.com.br
servers:
- url: https://api-v2.pandavideo.com.br
  description: Production Server
tags:
- name: Private - Comments
  description: 'Private operations for comment management.


    **Authentication:** API Key in the `Authorization` header


    **Base URL:** `/video-review/{video_id}` with `?action=comment`


    Allows video owners to view and manage all comments on their videos.'
paths:
  /video-review/{video_id}/comments:
    post:
      operationId: createPrivateComment
      summary: Create comment
      description: 'Creates a new comment on a video as the authenticated user.


        ## Authentication


        This endpoint requires authentication via API Key in the `Authorization` header.


        ```

        Authorization:

        ```


        ## Action Parameter


        This endpoint uses the query parameter `action=comment` to identify the operation.


        ```

        POST /video-review/{video_id}?action=comment

        ```


        ## Fields


        | Field | Required | Type | Description |

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

        | `text` | Yes | string | Comment text (max 500 characters) |

        | `time` | No* | integer | Video timestamp in seconds |

        | `user_name` | No | string | User name (uses authenticated name if not provided) |

        | `reply_to` | No | string | Parent comment UUID for replies |


        *The `time` field is required for main comments, but optional for replies (inherits from parent).


        ## Limits


        - Maximum of 30 main comments per video

        - Maximum of 30 replies per comment

        - Text with maximum 500 characters'
      tags:
      - Private - Comments
      parameters:
      - name: video_id
        in: path
        required: true
        description: Video UUID
        schema:
          type: string
          format: uuid
        example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
      - name: action
        in: query
        required: true
        description: Action type (must be "comment" for this operation)
        schema:
          type: string
          enum:
          - comment
        example: comment
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateCommentPrivateRequest'
            examples:
              new_comment:
                summary: New comment
                description: Creates a comment at minute 5:30 of the video
                value:
                  text: Adjust the lighting in this section.
                  time: 330
              reply:
                summary: Reply to a comment
                value:
                  text: Already adjusted, check the new version.
                  reply_to: b2c3d4e5-f6a7-8901-bcde-f23456789012
      responses:
        '201':
          description: Comment created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommentResponse'
        '400':
          description: Invalid input data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Video not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - PandaAuth: []
    get:
      operationId: listPrivateComments
      summary: List comments
      description: 'Returns all comments for a video with pagination and filter support.


        ## Authentication


        This endpoint requires authentication via API Key in the `Authorization` header.


        ```

        Authorization:

        ```


        ## Action Parameter


        This endpoint uses the query parameter `action=comment` to identify the operation.


        ```

        GET /video-review/{video_id}?action=comment

        ```


        ## Behavior


        - Returns main comments with their nested replies in the `replies` field

        - Supports pagination via `page` and `limit`

        - Allows filtering by `status` (open/resolved)

        - Includes user information (avatar, user_id) when available'
      tags:
      - Private - Comments
      parameters:
      - name: video_id
        in: path
        required: true
        description: Video UUID
        schema:
          type: string
          format: uuid
        example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
      - name: action
        in: query
        required: true
        description: Action type (must be "comment" for this operation)
        schema:
          type: string
          enum:
          - comment
        example: comment
      - name: page
        in: query
        required: false
        description: Page number (default 1)
        schema:
          type: string
          pattern: ^(0|[1-9][0-9]{0,5}|1000000)$
        example: '1'
      - name: limit
        in: query
        required: false
        description: Items per page (1-100, default 10)
        schema:
          type: string
          pattern: ^([1-9]|[1-9][0-9]|100)$
        example: '10'
      - name: status
        in: query
        required: false
        description: Filter by comment status
        schema:
          type: string
          enum:
          - open
          - resolved
        example: open
      responses:
        '200':
          description: Comments returned successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedCommentsResponse'
        '400':
          description: Invalid query parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Video not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - PandaAuth: []
  /video-review/{video_id}/comments/{comment_id}:
    delete:
      operationId: deletePrivateComment
      summary: Delete comment
      description: 'Deletes a comment and all its replies.


        ## Authentication


        This endpoint requires authentication via API Key in the `Authorization` header.


        ```

        Authorization:

        ```


        ## Action Parameter


        This endpoint uses the query parameter `action=comment` to identify the operation.


        ```

        DELETE /video-review/{video_id}/{comment_id}?action=comment

        ```


        ## Behavior


        - Deleting a parent comment also deletes all linked replies

        - This action is irreversible'
      tags:
      - Private - Comments
      parameters:
      - name: video_id
        in: path
        required: true
        description: Video UUID
        schema:
          type: string
          format: uuid
        example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
      - name: comment_id
        in: path
        required: true
        description: Comment UUID
        schema:
          type: string
          format: uuid
        example: b2c3d4e5-f6a7-8901-bcde-f23456789012
      - name: action
        in: query
        required: true
        description: Action type (must be "comment" for this operation)
        schema:
          type: string
          enum:
          - comment
        example: comment
      responses:
        '200':
          description: Comment deleted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteResponse'
              example:
                msg: success removed!
        '404':
          description: Video or comment not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - PandaAuth: []
    put:
      operationId: updatePrivateComment
      summary: Update comment
      description: 'Updates an existing comment. Allows changing text, status or timestamp.


        ## Authentication


        This endpoint requires authentication via API Key in the `Authorization` header.


        ```

        Authorization:

        ```


        ## Action Parameter


        This endpoint uses the query parameter `action=comment` to identify the operation.


        ```

        PUT /video-review/{video_id}/{comment_id}?action=comment

        ```


        ## Updatable Fields


        | Field | Type | Description |

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

        | `text` | string | Comment text (max 500 characters) |

        | `status` | string | Status: `open` or `resolved` |

        | `time` | integer | Video timestamp in seconds |'
      tags:
      - Private - Comments
      parameters:
      - name: video_id
        in: path
        required: true
        description: Video UUID
        schema:
          type: string
          format: uuid
        example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
      - name: comment_id
        in: path
        required: true
        description: Comment UUID
        schema:
          type: string
          format: uuid
        example: b2c3d4e5-f6a7-8901-bcde-f23456789012
      - name: action
        in: query
        required: true
        description: Action type (must be "comment" for this operation)
        schema:
          type: string
          enum:
          - comment
        example: comment
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateCommentRequest'
            examples:
              update_text:
                summary: Update text
                value:
                  text: Updated comment text
              resolve:
                summary: Mark as resolved
                value:
                  status: resolved
              update_timestamp:
                summary: Change timestamp
                value:
                  time: 360
      responses:
        '200':
          description: Comment updated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommentResponse'
        '400':
          description: Invalid input data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Video or comment not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - PandaAuth: []
components:
  schemas:
    UpdateCommentRequest:
      type: object
      properties:
        text:
          type: string
          description: New comment text.
          minLength: 1
          maxLength: 500
          pattern: ^[^<>{}\[\]]*$
          example: Updated comment text
        status:
          type: string
          description: 'Comment status:

            - `open`: Comment open, pending resolution

            - `resolved`: Comment resolved/addressed

            '
          enum:
          - open
          - resolved
          example: resolved
        time:
          type: integer
          description: New video timestamp in seconds.
          minimum: 0
          example: 360
    CreateCommentPrivateRequest:
      type: object
      required:
      - text
      properties:
        text:
          type: string
          description: Comment text. Does not allow HTML tags or special characters like `< > { } [ ]`.
          minLength: 1
          maxLength: 500
          pattern: ^[^<>{}\[\]]*$
          example: Adjust the lighting in this section.
        user_name:
          type: string
          description: User name. If not provided, uses the authenticated user's name.
          minLength: 1
          maxLength: 100
          pattern: ^[a-zA-Z0-9\s\-_\.@]+$
          example: John Smith
        time:
          type: integer
          description: 'Video timestamp in seconds. Required for main comments, optional for replies.

            '
          minimum: 0
          example: 330
        reply_to:
          type: string
          format: uuid
          description: Parent comment UUID to create a reply.
          example: 550e8400-e29b-41d4-a716-446655440001
    PaginatedCommentsResponse:
      type: object
      properties:
        data:
          type: array
          description: List of main comments with their nested replies.
          items:
            $ref: '#/components/schemas/CommentWithRepliesResponse'
        hasNextPage:
          type: boolean
          description: Indicates if there is a next page of results.
          example: false
        totalPages:
          type: integer
          description: Total number of available pages.
          example: 1
        page:
          type: integer
          description: Current page number.
          example: 1
        limit:
          type: integer
          description: Number of items per page.
          example: 10
        totalItens:
          type: integer
          description: Total number of main comments (does not include replies in count).
          example: 5
    ErrorResponse:
      type: object
      properties:
        errCode:
          type: string
          description: 'Standardized error code:

            - `BadRequest`: Invalid input data or business rule violated

            - `Unauthorized`: Invalid token or API Key

            - `Forbidden`: Access denied (expired link, insufficient permission)

            - `NotFound`: Resource not found

            - `MethodNotAllowed`: HTTP method not supported

            - `InternalServerError`: Internal server error

            '
          enum:
          - BadRequest
          - Unauthorized
          - Forbidden
          - NotFound
          - MethodNotAllowed
          - InternalServerError
          example: NotFound
        errMsg:
          type: string
          description: Descriptive error message in English.
          example: Resource not found
    CommentResponse:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Comment unique UUID.
          example: b2c3d4e5-f6a7-8901-bcde-f23456789012
        video_id:
          type: string
          format: uuid
          description: UUID of the video the comment belongs to.
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        user_id:
          type: string
          format: uuid
          description: UUID of the user who created the comment (available only in private API).
          nullable: true
          example: 1b4f677f-4f6e-459d-84e0-7c304d3dbf48
        user_name:
          type: string
          description: Name of the user who created the comment.
          example: John Smith
        text:
          type: string
          description: Comment text.
          example: The audio is low in this section.
        status:
          type: string
          description: Current comment status.
          enum:
          - open
          - resolved
          example: open
        time:
          type: integer
          description: Video timestamp in seconds.
          example: 330
        reply_to:
          type: string
          format: uuid
          description: Parent comment UUID (null for main comments).
          nullable: true
          example: null
        avatar:
          type: string
          format: uri
          description: User avatar URL (available only in private API when user has an avatar).
          nullable: true
          example: https://cdn.pandavideo.com.br/avatars/user123.jpg
        created_at:
          type: string
          format: date-time
          description: Comment creation date and time.
          example: '2025-01-15T10:30:00.000Z'
        updated_at:
          type: string
          format: date-time
          description: Last update date and time.
          example: '2025-01-15T10:30:00.000Z'
    CommentWithRepliesResponse:
      allOf:
      - $ref: '#/components/schemas/CommentResponse'
      - type: object
        properties:
          replies:
            type: array
            description: List of replies linked to this comment.
            items:
              $ref: '#/components/schemas/CommentResponse'
    DeleteResponse:
      type: object
      properties:
        msg:
          type: string
          description: Deletion confirmation message.
          example: success removed!
  securitySchemes:
    PandaAuth:
      type: apiKey
      in: header
      name: Authorization
      description: 'API Key for private API authentication.


        **Format:** Send the API Key directly in the header, without the "Bearer" prefix.


        ```

        Authorization: <your-api-key>

        ```


        To obtain your API Key, access the Panda Video dashboard in Settings > API.

        '
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/createprivatecomment.md
  - https://docs.pandavideo.com/reference/createpubliccomment.md
  - https://docs.pandavideo.com/reference/createreviewlink.md
  - https://docs.pandavideo.com/reference/deleteprivatecomment.md
  - https://docs.pandavideo.com/reference/deletepubliccomment.md
  - https://docs.pandavideo.com/reference/deletereviewlink.md
  - https://docs.pandavideo.com/reference/getpublicreviewlink.md
  - https://docs.pandavideo.com/reference/listprivatecomments.md
  - https://docs.pandavideo.com/reference/listpubliccomments.md
  - https://docs.pandavideo.com/reference/listreviewlinks.md
  - https://docs.pandavideo.com/reference/updateprivatecomment.md
  - https://docs.pandavideo.com/reference/updatepubliccomment.md
  - https://docs.pandavideo.com/reference/updatereviewlink.md
  merge:
    pages: 13
    deduped: 33
    conflicts_kept_first: 0