Panda Video Public - Comments API

Public operations for comment management. **Authentication:** `link_id` in path and session `token` via query parameter The `token` identifies the user session. To edit or delete a comment, use the same `token` used during creation. Allows external reviewers to create, view, update and delete comments on videos through review links.

GitHub OpenAPI

Operations 4

POST /public-video-review/{link_id}/comments Create comment #
GET /public-video-review/{link_id}/comments List comments #
DELETE /public-video-review/{link_id}/comments/{comment_id} Delete comment #
PUT /public-video-review/{link_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-public-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-public-comments-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Panda Video Review Public - 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: Public - Comments
  description: 'Public operations for comment management.


    **Authentication:** `link_id` in path and session `token` via query parameter


    The `token` identifies the user session. To edit or delete a comment, use the same `token` used during creation.


    Allows external reviewers to create, view, update and delete comments on videos through review links.'
paths:
  /public-video-review/{link_id}/comments:
    post:
      operationId: createPublicComment
      summary: Create comment
      description: 'Creates a new comment on a video through the public review link.


        ## Authentication


        | Parameter | Type | Description |

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

        | `link_id` | path | Review link identifier |

        | `token` | query | User session token |


        The `token` will be associated with the created comment. To edit or delete this comment later, use the same `token`. The token can be the same value as `link_id` or a unique identifier generated by the application.


        **Example:** `550e8400-e29b-41d4-a716-446655440000`


        ## Behavior


        To create a main comment:

        - Provide `text`, `user_name` and `time` (video timestamp in seconds)

        - The `time` must be less than or equal to the video duration


        To create a reply to an existing comment:

        - Provide `text`, `user_name` and `reply_to` (UUID of the parent comment)

        - The `time` is automatically inherited from the parent comment


        ## Limits


        - Maximum of 30 main comments per video

        - Maximum of 30 replies per comment

        - Text with maximum 500 characters


        ## Requirements


        - The link must have `allow_comment: true`

        - The link must be active and not expired'
      tags:
      - Public - Comments
      parameters:
      - name: link_id
        in: path
        required: true
        description: Review link UUID
        schema:
          type: string
          format: uuid
        example: 550e8400-e29b-41d4-a716-446655440000
      - name: token
        in: query
        required: true
        description: User session token. This token will be associated with the created comment.
        schema:
          type: string
          format: uuid
        example: 550e8400-e29b-41d4-a716-446655440000
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateCommentPublicRequest'
            examples:
              new_comment:
                summary: New comment at specific timestamp
                description: Creates a comment at minute 5:30 of the video
                value:
                  text: The audio is low in this section, it would be good to increase the volume.
                  user_name: John Smith
                  time: 330
              comment_reply:
                summary: Reply to an existing comment
                description: Creates a reply linked to another comment
                value:
                  text: I agree, I will adjust it in the next version.
                  user_name: Mary Johnson
                  reply_to: 550e8400-e29b-41d4-a716-446655440001
      responses:
        '201':
          description: Comment created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommentResponse'
              example:
                id: b2c3d4e5-f6a7-8901-bcde-f23456789012
                video_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                user_name: John Smith
                text: The audio is low in this section, it would be good to increase the volume.
                status: open
                time: 330
                reply_to: null
                created_at: '2025-01-15T10:30:00.000Z'
                updated_at: '2025-01-15T10:30:00.000Z'
        '400':
          description: Invalid input data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                validation:
                  summary: Validation error
                  value:
                    errCode: BadRequest
                    errMsg: Invalid body
                comment_limit:
                  summary: Comment limit reached
                  value:
                    errCode: BadRequest
                    errMsg: Comment limit reached (max 30)
                invalid_time:
                  summary: Timestamp exceeds video duration
                  value:
                    errCode: BadRequest
                    errMsg: Time exceeds video length
        '401':
          description: Invalid or missing token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Link inactive, expired or comments disabled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                errCode: Forbidden
                errMsg: Comments are not allowed on this link
    get:
      operationId: listPublicComments
      summary: List comments
      description: 'Returns the list of video comments with pagination.


        ## Authentication


        | Parameter | Type | Description |

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

        | `link_id` | path | Review link identifier |

        | `token` | query | User session token |


        The `token` is required to access comments. This same token can be used to edit or delete comments that were created with it. The token can be the same value as `link_id` or a unique identifier generated by the application.


        **Example:** `550e8400-e29b-41d4-a716-446655440000`


        ## Behavior


        - Returns main comments with their nested replies

        - Supports pagination via `page` and `limit`

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

        - If the link has `show_resolved: false`, only open comments are returned


        ## Response Structure


        Comments are returned in hierarchical format, where each main comment contains a `replies` array with its responses.'
      tags:
      - Public - Comments
      parameters:
      - name: link_id
        in: path
        required: true
        description: Review link UUID
        schema:
          type: string
          format: uuid
        example: 550e8400-e29b-41d4-a716-446655440000
      - name: token
        in: query
        required: true
        description: User session token. Use the same token to edit or delete comments you created.
        schema:
          type: string
          format: uuid
        example: 550e8400-e29b-41d4-a716-446655440000
      - 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: Comment list returned successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedCommentsResponse'
              example:
                data:
                - id: b2c3d4e5-f6a7-8901-bcde-f23456789012
                  video_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                  user_name: John Smith
                  text: The audio is low in this section.
                  status: open
                  time: 330
                  reply_to: null
                  created_at: '2025-01-15T10:30:00.000Z'
                  updated_at: '2025-01-15T10:30:00.000Z'
                  replies:
                  - id: c3d4e5f6-a7b8-9012-cdef-345678901234
                    video_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                    user_name: Mary Johnson
                    text: I will adjust it in the next version.
                    status: open
                    time: 330
                    reply_to: b2c3d4e5-f6a7-8901-bcde-f23456789012
                    created_at: '2025-01-15T11:00:00.000Z'
                    updated_at: '2025-01-15T11:00:00.000Z'
                hasNextPage: false
                totalPages: 1
                page: 1
                limit: 10
                totalItens: 1
        '401':
          description: Invalid or missing token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Review link expired or inactive
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /public-video-review/{link_id}/comments/{comment_id}:
    delete:
      operationId: deletePublicComment
      summary: Delete comment
      description: 'Deletes a comment and all its replies.


        ## Authentication


        | Parameter | Type | Description |

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

        | `link_id` | path | Review link identifier |

        | `comment_id` | path | Comment identifier |

        | `token` | query | User session token |


        To delete a comment, use the same `token` used when creating the comment. The token can be the same value as `link_id` or a unique identifier generated by the application.


        **Example:** `550e8400-e29b-41d4-a716-446655440000`


        ## Behavior


        - Deleting a parent comment also deletes all linked replies

        - This action is irreversible

        - The link must be active and not expired'
      tags:
      - Public - Comments
      parameters:
      - name: link_id
        in: path
        required: true
        description: Review link UUID
        schema:
          type: string
          format: uuid
        example: 550e8400-e29b-41d4-a716-446655440000
      - name: comment_id
        in: path
        required: true
        description: Comment UUID
        schema:
          type: string
          format: uuid
        example: b2c3d4e5-f6a7-8901-bcde-f23456789012
      - name: token
        in: query
        required: true
        description: User session token. Use the same token used when creating the comment.
        schema:
          type: string
          format: uuid
        example: 550e8400-e29b-41d4-a716-446655440000
      responses:
        '200':
          description: Comment deleted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteResponse'
              example:
                msg: success removed!
        '401':
          description: Invalid or missing token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Review link expired or inactive
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Comment not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
    put:
      operationId: updatePublicComment
      summary: Update comment
      description: 'Updates an existing comment. Allows changing the text and/or status of the comment.


        ## Authentication


        | Parameter | Type | Description |

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

        | `link_id` | path | Review link identifier |

        | `comment_id` | path | Comment identifier |

        | `token` | query | User session token |


        To edit the comment text, use the same `token` used during creation. Any user can change the status to `resolved`. The token can be the same value as `link_id` or a unique identifier generated by the application.


        **Example:** `550e8400-e29b-41d4-a716-446655440000`


        ## Behavior


        - Only partial updates are allowed (send only the fields you want to change)

        - To change the status, the link must have `allow_status_edit: true`

        - The link must be active and not expired


        ## Updatable Fields


        | Field | Description |

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

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

        | `status` | Comment status: `open` or `resolved` |'
      tags:
      - Public - Comments
      parameters:
      - name: link_id
        in: path
        required: true
        description: Review link UUID
        schema:
          type: string
          format: uuid
        example: 550e8400-e29b-41d4-a716-446655440000
      - name: comment_id
        in: path
        required: true
        description: Comment UUID
        schema:
          type: string
          format: uuid
        example: b2c3d4e5-f6a7-8901-bcde-f23456789012
      - name: token
        in: query
        required: true
        description: User session token. To edit the text, use the same token used when creating the comment.
        schema:
          type: string
          format: uuid
        example: 550e8400-e29b-41d4-a716-446655440000
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateCommentRequest'
            examples:
              update_text:
                summary: Update text
                value:
                  text: Updated comment text
              resolve_comment:
                summary: Mark as resolved
                value:
                  status: resolved
              reopen_comment:
                summary: Reopen comment
                value:
                  status: open
      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'
        '403':
          description: Link inactive or status editing not allowed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                errCode: Forbidden
                errMsg: Status editing is not allowed on this link
        '404':
          description: Comment not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
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
    CreateCommentPublicRequest:
      type: object
      required:
      - text
      - user_name
      properties:
        text:
          type: string
          description: Comment text. Does not allow HTML tags or special characters like `< > { } [ ]`.
          minLength: 1
          maxLength: 500
          pattern: ^[^<>{}\[\]]*$
          example: The audio is low in this section, it would be good to increase the volume.
        user_name:
          type: string
          description: Name of the user commenting. Allows letters, numbers, spaces and the characters `- _ . @`.
          minLength: 1
          maxLength: 100
          pattern: ^[a-zA-Z0-9\s\-_\.@]+$
          example: John Smith
        time:
          type: integer
          description: 'Video timestamp in seconds where the comment refers to.

            Required for main comments, optional for replies (inherits from parent).


            Examples:

            - 90 = 1:30 (1 minute and 30 seconds)

            - 330 = 5:30 (5 minutes and 30 seconds)

            - 3600 = 1:00:00 (1 hour)

            '
          minimum: 0
          example: 330
        reply_to:
          type: string
          format: uuid
          description: Parent comment UUID. When provided, creates a reply linked to the specified comment.
          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