Update review link

Updates the settings of an existing review link.

Authentication

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

Authorization: <your-api-key>

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

FieldTypeDescription
link_namestringLink identifier name
expires_atnumberNew expiration date (Unix timestamp in ms)
allow_commentbooleanEnable/disable comments
allow_status_editbooleanEnable/disable status editing
show_resolvedbooleanShow/hide resolved comments
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

PUT /video-review/{video_id}/{link_id}

Updates an existing review link.

📘

Authorization

Requires a valid API Key in the Authorization header. Send the key directly — no Bearer prefix.

🚧

?action=link is required

Without ?action=link the request returns 404 Route not found.

HTTP Method & Path

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

Base URL: https://api-v2.pandavideo.com.br

Path Parameters

NameTypeRequiredDescription
video_idstring (uuid)yesVideo UUID.
link_idstring (uuid)yesReview link UUID.

Query Parameters

NameTypeRequiredDescription
actionstringyesMust be link.

Request Body

Content-Type: application/json

Partial update — send only the fields you want to change. All fields are optional.

FieldTypeDescription
link_namestring (1–255)New display name. Same [a-zA-Z0-9 \-_.]+ pattern as create.
expires_atnumber (ms since epoch)New expiration (still bound to 30‑day limit from "now"). Extending an expired‑in‑Redis link does not automatically revive it — see Errors.
allow_commentbooleanEnable/disable new comments.
allow_status_editbooleanEnable/disable reviewer‑side status changes.
show_resolvedbooleanShow/hide resolved comments.
{
  "link_name": "Client Review v2",
  "expires_at": 1738454399000,
  "allow_comment": false
}

Response

Success Response (200)

Returns the updated link object (same shape as Create).

Error Responses

  • 400 — invalid body / link_name pattern / expires_at more than 30 days; also returned when the stored link status is already expired ("Link is expired!").
  • 401 — missing/invalid API Key.
  • 404 — user, video or review link not found.
  • 500 — internal error.

Example Usage

cURL

curl --request PUT \
  --url 'https://api-v2.pandavideo.com.br/video-review/a1b2c3d4-e5f6-7890-abcd-ef1234567890/550e8400-e29b-41d4-a716-446655440000?action=link' \
  --header 'Authorization: <your-api-key>' \
  --header 'Content-Type: application/json' \
  --data '{ "allow_comment": false }'

Recipes

Path Params
Query Params
Body Params
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json