v1

latestOpenAPI 3.1.02026-07-2416666272.6 KB
Public - Comments

Update comment

Updates an existing comment. Allows changing the text and/or status of the comment.

Authentication

ParameterTypeDescription
link_idpathReview link identifier
comment_idpathComment identifier
tokenqueryUser 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

FieldDescription
textComment text (max 500 characters)
statusComment status: open or resolved
put/public-video-review/{link_id}/comments/{comment_id}

Path parameters

link_idstring uuid required

Review link UUID

comment_idstring uuid required

Comment UUID

Query parameters

tokenstring uuid required

User session token. To edit the text, use the same token used when creating the comment.

Request body

textstring

New comment text.

status'open' | 'resolved'

Comment status:

  • open: Comment open, pending resolution
  • resolved: Comment resolved/addressed
timeinteger

New video timestamp in seconds.

Example request

{
  "text": "Updated comment text",
  "status": "resolved",
  "time": 360
}

Response

Comment updated successfully

idstring uuid

Comment unique UUID.

video_idstring uuid

UUID of the video the comment belongs to.

user_idstring uuid nullable

UUID of the user who created the comment (available only in private API).

user_namestring

Name of the user who created the comment.

textstring

Comment text.

status'open' | 'resolved'

Current comment status.

timeinteger

Video timestamp in seconds.

reply_tostring uuid nullable

Parent comment UUID (null for main comments).

avatarstring uri nullable

User avatar URL (available only in private API when user has an avatar).

created_atstring date-time

Comment creation date and time.

updated_atstring date-time

Last update date and time.

Example response

{
  "id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
  "video_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "user_id": "1b4f677f-4f6e-459d-84e0-7c304d3dbf48",
  "user_name": "John Smith",
  "text": "The audio is low in this section.",
  "status": "open",
  "time": 330,
  "avatar": "https://cdn.pandavideo.com.br/avatars/user123.jpg",
  "created_at": "2025-01-15T10:30:00.000Z",
  "updated_at": "2025-01-15T10:30:00.000Z"
}