Review

Share videos with external reviewers and collect time‑coded comments. The Review API is split into two surfaces — a Private API used by video owners (authenticated with their API Key) and a Public API used by the reviewers themselves (authenticated by a per‑link token).

📘
Two parallel APIs

Private (/video-review/{video_id}) — managed by the video owner. Used by the dashboard to create/update/delete review links and to read all comments on a video.

Public (/public-video-review/{link_id}) — opened by anyone holding the public link URL. Used by reviewers to read the link details and to create/update/delete their own comments.

Concepts

Concept	Description
Review link	A shareable URL bound to a single `video_id` with an expiration date and a set of permissions (`allow_comment`, `allow_status_edit`, `show_resolved`).
Comment	A piece of feedback pinned at a specific timestamp of the video (`time`, in seconds). Comments can be nested as replies via `reply_to`.
Status	Comments have status `open` or `resolved`. Links have status `active` or `expired`.
Public URL	`https://review.pandavideo.com/{link_id}` (production).

Limits

Link expiration: maximum 30 days from creation.
Comments per video: maximum 30 main comments.
Replies per comment: maximum 30.
Text length: maximum 500 characters.
Allowed characters in text: any except < > { } [ ] (HTML tags are rejected).
user_name pattern: letters, digits, spaces and - _ . @.
link_name pattern: letters, digits, spaces and - _ ..

Authentication summary

Surface	Mechanism	How
Private	API Key (`Authorization` header)	Send your key directly — no `Bearer` prefix.
Public	Session token (`?token=` UUID)	Pass the same `token` you used on creation to later edit/delete the same comment.

Action parameter (Private API)

All Private endpoints share the same path family /video-review/{video_id}[/{id}] and are dispatched by the required query parameter action:

`?action=`	Resource	Endpoints
`link`	Review links	List / Create / Update / Delete
`comment`	Comments	List / Create / Update / Delete

Missing or wrong action returns 404 "Route not found".

Next steps

Create a link with Create review link and share url.
Read a link from the reviewer side with Get review link details.
Manage feedback with the comment endpoints under both surfaces.