Panda Video Private - Review Links API

Private operations for review link management. **Authentication:** API Key in the `Authorization` header **Base URL:** `/video-review/{video_id}` with `?action=link` Allows video owners to create and manage review links for sharing.

GitHub OpenAPI

Operations 4

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-review-links-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-review-links-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Panda Video Review Private - Review Links 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 - Review Links
  description: 'Private operations for review link management.


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


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


    Allows video owners to create and manage review links for sharing.'
paths:
  /video-review/{video_id}:
    post:
      operationId: createReviewLink
      summary: Create review link
      description: 'Creates a new review link to share a video with external reviewers.


        ## Authentication


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


        ```

        Authorization:

        ```


        **Important:** The API Key must be sent directly, without the "Bearer" prefix.


        ## Action Parameter


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


        ```

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

        ```


        ## Required Fields


        | Field | Type | Description |

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

        | `link_name` | string | Link identifier name (max 255 characters) |

        | `expires_at` | number | Unix timestamp in milliseconds of the expiration date |


        ## Optional Fields


        | Field | Type | Default | Description |

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

        | `allow_comment` | boolean | true | Allows adding comments |

        | `allow_status_edit` | boolean | true | Allows changing comment status |

        | `show_resolved` | boolean | true | Displays resolved comments |


        ## Expiration Limit


        The `expires_at` field must be a date at most 30 days in the future. Links with expiration beyond this limit will be rejected.


        ## Response


        Returns the created link with the public URL for sharing in the format:

        ```

        https://review.pandavideo.com.br/{link_id}

        ```'
      tags:
      - Private - Review Links
      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 "link" for this operation)
        schema:
          type: string
          enum:
          - link
        example: link
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateReviewLinkRequest'
            examples:
              full_permissions:
                summary: Link with all permissions
                description: Creates a link that allows comments, status editing and displays resolved
                value:
                  link_name: Client Review v1
                  expires_at: 1737849599000
                  allow_comment: true
                  allow_status_edit: true
                  show_resolved: true
              read_only:
                summary: Read-only link
                description: Creates a link for viewing only, without comment permission
                value:
                  link_name: Final Viewing
                  expires_at: 1737849599000
                  allow_comment: false
                  allow_status_edit: false
                  show_resolved: false
              simple_review:
                summary: Link with comments but no status editing
                description: Allows comments but reviewer cannot mark as resolved
                value:
                  link_name: Marketing Team Review
                  expires_at: 1737849599000
                  allow_comment: true
                  allow_status_edit: false
                  show_resolved: true
      responses:
        '201':
          description: Review link created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReviewLinkWithUrlResponse'
              example:
                id: 550e8400-e29b-41d4-a716-446655440000
                video_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                name: Client Review v1
                status: active
                expires_at: '2025-01-25T23:59:59.000Z'
                allow_comment: true
                allow_status_edit: true
                show_resolved: true
                url: https://review.pandavideo.com.br/550e8400-e29b-41d4-a716-446655440000
                created_at: '2025-01-15T10:00:00.000Z'
                updated_at: '2025-01-15T10:00: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
                invalid_expiration:
                  summary: Expiration beyond 30 days
                  value:
                    errCode: BadRequest
                    errMsg: Expiration date must be within 30 days
        '404':
          description: Video not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - PandaAuth: []
    get:
      operationId: listReviewLinks
      summary: List review links
      description: 'Returns all review links created for a specific video.


        ## Authentication


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


        ```

        Authorization:

        ```


        **Important:** The API Key must be sent directly, without the "Bearer" prefix.


        ## Action Parameter


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


        ```

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

        ```


        ## Behavior


        - Returns a paginated list of review links

        - Each link includes the public URL for sharing

        - Allows filtering by status (active/expired)'
      tags:
      - Private - Review Links
      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 "link" for this operation)
        schema:
          type: string
          enum:
          - link
        example: link
      - 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 link status
        schema:
          type: string
          enum:
          - active
          - expired
        example: active
      responses:
        '200':
          description: Review links returned successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReviewLinksListResponse'
              example:
              - id: 550e8400-e29b-41d4-a716-446655440000
                video_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                name: Client Review v1
                status: active
                expires_at: '2025-01-25T23:59:59.000Z'
                allow_comment: true
                allow_status_edit: true
                show_resolved: true
                url: https://review.pandavideo.com.br/550e8400-e29b-41d4-a716-446655440000
                created_at: '2025-01-15T10:00:00.000Z'
                updated_at: '2025-01-15T10:00:00.000Z'
        '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}/{link_id}:
    delete:
      operationId: deleteReviewLink
      summary: Delete review link
      description: 'Permanently deletes a review link.


        ## Authentication


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


        ```

        Authorization:

        ```


        ## Action Parameter


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


        ```

        DELETE /video-review/{video_id}/{link_id}?action=link

        ```


        ## Behavior


        - This action is irreversible

        - The public link URL will stop working immediately

        - Video comments are NOT deleted with the link'
      tags:
      - Private - Review Links
      parameters:
      - name: video_id
        in: path
        required: true
        description: Video UUID
        schema:
          type: string
          format: uuid
        example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
      - name: link_id
        in: path
        required: true
        description: Review link UUID
        schema:
          type: string
          format: uuid
        example: 550e8400-e29b-41d4-a716-446655440000
      - name: action
        in: query
        required: true
        description: Action type (must be "link" for this operation)
        schema:
          type: string
          enum:
          - link
        example: link
      responses:
        '200':
          description: Review link deleted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteResponse'
              example:
                msg: success removed!
        '404':
          description: Video or link not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - PandaAuth: []
    put:
      operationId: updateReviewLink
      summary: Update review link
      description: 'Updates the settings of an existing review link.


        ## Authentication


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


        ```

        Authorization:

        ```


        ## Action Parameter


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


        ```

        PUT /video-review/{video_id}/{link_id}?action=link

        ```


        ## Behavior


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

        - Expired links cannot be updated

        - Extending `expires_at` can reactivate an expired link


        ## Updatable Fields


        | Field | Type | Description |

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

        | `link_name` | string | Link identifier name |

        | `expires_at` | number | New expiration date (Unix timestamp in ms) |

        | `allow_comment` | boolean | Enable/disable comments |

        | `allow_status_edit` | boolean | Enable/disable status editing |

        | `show_resolved` | boolean | Show/hide resolved comments |'
      tags:
      - Private - Review Links
      parameters:
      - name: video_id
        in: path
        required: true
        description: Video UUID
        schema:
          type: string
          format: uuid
        example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
      - name: link_id
        in: path
        required: true
        description: Review link UUID
        schema:
          type: string
          format: uuid
        example: 550e8400-e29b-41d4-a716-446655440000
      - name: action
        in: query
        required: true
        description: Action type (must be "link" for this operation)
        schema:
          type: string
          enum:
          - link
        example: link
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateReviewLinkRequest'
            examples:
              update_name:
                summary: Update link name
                value:
                  link_name: Client Review v2
              extend_expiration:
                summary: Extend expiration date
                value:
                  expires_at: 1738454399000
              disable_comments:
                summary: Disable comments
                value:
                  allow_comment: false
      responses:
        '200':
          description: Review link updated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReviewLinkResponse'
        '400':
          description: Invalid data or expired link
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                errCode: BadRequest
                errMsg: Cannot update expired link
        '404':
          description: Video or link not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - PandaAuth: []
components:
  schemas:
    UpdateReviewLinkRequest:
      type: object
      properties:
        link_name:
          type: string
          description: New link name.
          minLength: 1
          maxLength: 255
          pattern: ^[a-zA-Z0-9\s\-_\.]+$
          example: Client Review v2
        expires_at:
          type: number
          description: New expiration date in Unix timestamp (milliseconds).
          minimum: 1640995200000
          maximum: 4102444800000
          example: 1738454399000
        allow_comment:
          type: boolean
          description: Enable/disable comments.
          example: false
        allow_status_edit:
          type: boolean
          description: Enable/disable status editing.
          example: false
        show_resolved:
          type: boolean
          description: Show/hide resolved comments.
          example: false
    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
    DeleteResponse:
      type: object
      properties:
        msg:
          type: string
          description: Deletion confirmation message.
          example: success removed!
    ReviewLinkWithUrlResponse:
      allOf:
      - $ref: '#/components/schemas/ReviewLinkResponse'
      - type: object
        properties:
          url:
            type: string
            format: uri
            description: 'Public URL for sharing the review link.


              Format: `https://review.pandavideo.com.br/{link_id}`


              In staging environment: `https://review-staging.pandavideo.com.br/{link_id}`

              '
            example: https://review.pandavideo.com.br/550e8400-e29b-41d4-a716-446655440000
    ReviewLinksListResponse:
      type: array
      description: List of review links with public URLs.
      items:
        $ref: '#/components/schemas/ReviewLinkWithUrlResponse'
    CreateReviewLinkRequest:
      type: object
      required:
      - link_name
      - expires_at
      properties:
        link_name:
          type: string
          description: Link identifier name. Allows letters, numbers, spaces and the characters `- _ .`.
          minLength: 1
          maxLength: 255
          pattern: ^[a-zA-Z0-9\s\-_\.]+$
          example: Client Review v1
        expires_at:
          type: number
          description: 'Link expiration date in Unix timestamp (milliseconds).


            **Limit**: Maximum of 30 days from the current date.


            Example: To expire on 01/25/2025 at 23:59:59, use `1737849599000`.

            '
          minimum: 1640995200000
          maximum: 4102444800000
          example: 1737849599000
        allow_comment:
          type: boolean
          description: Allows reviewers to add comments to the video.
          default: true
          example: true
        allow_status_edit:
          type: boolean
          description: Allows reviewers to change comment status (open/resolved).
          default: true
          example: true
        show_resolved:
          type: boolean
          description: Displays comments marked as resolved.
          default: true
          example: true
    ReviewLinkResponse:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Review link UUID.
          example: 550e8400-e29b-41d4-a716-446655440000
        video_id:
          type: string
          format: uuid
          description: Associated video UUID.
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        name:
          type: string
          description: Link identifier name.
          example: Client Review v1
        expires_at:
          type: string
          format: date-time
          description: Link expiration date and time.
          example: '2025-01-25T23:59:59.000Z'
        status:
          type: string
          description: 'Current link status:

            - `active`: Link is active and accessible

            - `expired`: Link has expired, can no longer be accessed

            '
          enum:
          - active
          - expired
          example: active
        allow_comment:
          type: boolean
          description: Indicates if comments are enabled.
          example: true
        allow_status_edit:
          type: boolean
          description: Indicates if status editing is enabled.
          example: true
        show_resolved:
          type: boolean
          description: Indicates if resolved comments are displayed.
          example: true
        created_at:
          type: string
          format: date-time
          description: Link creation date and time.
          example: '2025-01-15T10:00:00.000Z'
        updated_at:
          type: string
          format: date-time
          description: Last update date and time.
          example: '2025-01-15T10:00:00.000Z'
  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