PUT /videos/{video_id}

Updates the attributes of a specific video — title, description, folder placement, and enabled playback qualities. All body fields are optional; only the fields you send will be updated.

📘

Authorization

Requires a valid Panda API token sent in the Authorization header (no Bearer prefix).

HTTP Method & Path

PUT /videos/{video_id}

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

Authentication Requirements

Parameters

Path Parameters

Request Body

Content-Type: application/json

All fields are optional. Only the fields you include will be updated.

Body Parameters

{
  "title": "My updated title",
  "description": "Updated description text",
  "folder_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
  "playback": ["360p", "720p", "1080p"]
}

📘

Bulk move tip

To move multiple videos at once, use PUT /videos (no path id) with body [{ video_id, folder_id }] — see the bulk-move flow used by the dashboard.

Response

Success Response (200)

Returns the updated video object (same shape as Get video properties):

{
  "id": "11111111-2222-3333-4444-555555555555",
  "title": "My updated title",
  "description": "Updated description text",
  "status": "CONVERTED",
  "folder_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
  "playback": ["360p", "720p", "1080p"],
  "video_player": "https://player.pandavideo.com.br/embed/?v=9988aabb-ccdd-eeff-1122-334455667788",
  "video_hls": "https://b-vz-xxx.b-cdn.net/.../playlist.m3u8",
  "updated_at": "2026-05-29T20:15:41.000Z"
}

Error Responses

• 400 Bad Request — Invalid video_id, invalid playback quality value, or malformed body.
• 401 Unauthorized — Missing or invalid API token.
• 404 Not Found — Video not found.
• 500 Internal Server Error — Server-side error.

Example Usage

cURL — update title and description

curl -X PUT \
  'https://api-v2.pandavideo.com.br/videos/<video_id>' \
  -H 'Authorization: your_api_token_here' \
  -H 'Content-Type: application/json' \
  -d '{
  "title": "My updated title",
  "description": "Updated description text"
}'

cURL — move to a folder

curl -X PUT \
  'https://api-v2.pandavideo.com.br/videos/<video_id>' \
  -H 'Authorization: your_api_token_here' \
  -H 'Content-Type: application/json' \
  -d '{
  "folder_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
}'

cURL — restrict playback qualities

curl -X PUT \
  'https://api-v2.pandavideo.com.br/videos/<video_id>' \
  -H 'Authorization: your_api_token_here' \
  -H 'Content-Type: application/json' \
  -d '{
  "playback": ["360p", "720p"]
}'

Recipes

The Recipes section provides a collection of code examples and sample implementations to help you understand and use the API effectively.