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_nameandtime(video timestamp in seconds) - The
timemust be less than or equal to the video duration
To create a reply to an existing comment:
- Provide
text,user_nameandreply_to(UUID of the parent comment) - The
timeis 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
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
POST /public-video-review/{link_id}/comments
{link_id}/commentsCreates a comment on the video from the reviewer side. Use either to post a top‑level comment at a specific timestamp or to reply to another comment.
Authentication: session tokenPass the reviewer's
tokenUUID as a query parameter. This token is associated with the new comment — keep it to later edit or delete it.
timerule
- For a top‑level comment,
timeis required and must be≤the video duration.- For a reply (
reply_toset),timeis inherited from the parent comment and you may omit it.
HTTP Method & Path
POST /public-video-review/{link_id}/comments?token=<uuid>
Base URL: https://api-v2.pandavideo.com.br
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
link_id | string (uuid) | yes | Review link UUID. |
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
token | string (uuid) | yes | Reviewer session token. |
Request Body
Content-Type: application/json
Body Parameters
| Field | Type | Required | Description |
|---|---|---|---|
text | string (1–500, no < > { } [ ]) | yes | Comment text. |
user_name | string (1–100, [a-zA-Z0-9 \-_.@]+) | yes | Reviewer display name. |
time | integer (≥ 0) | conditional | Video timestamp in seconds. Required for top‑level, optional for replies. |
reply_to | string (uuid) | no | Parent comment UUID. When present, creates a nested reply. |
{
"text": "The audio is low in this section.",
"user_name": "John Smith",
"time": 330
}{
"text": "I agree, I will adjust it in the next version.",
"user_name": "Mary Johnson",
"reply_to": "550e8400-e29b-41d4-a716-446655440001"
}Response
Success Response (200)
{
"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"
}Error Responses
- 400 — invalid body,
timemissing on a top‑level comment,timegreater than video duration,reply_tonot a valid sibling, or comment/reply limit reached (30 each). - 401 — missing/invalid
token. - 403 — link expired/inactive or
allow_comment: false. - 404 — link not found.
- 500 — internal error.
Example Usage
cURL
curl --request POST \
--url 'https://api-v2.pandavideo.com.br/public-video-review/550e8400-e29b-41d4-a716-446655440000/comments?token=550e8400-e29b-41d4-a716-446655440000' \
--header 'Content-Type: application/json' \
--data '{
"text": "The audio is low in this section.",
"user_name": "John Smith",
"time": 330
}'