PUT /folders/{folder_id}

Updates an existing folder. Use it to rename (change name), move (change parent_folder_id), or toggle status (active/inactive). All body fields are optional — only the fields you send are updated.

📘

Authorization

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

HTTP Method & Path

PUT /folders/{folder_id}

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

Authentication Requirements

Parameters

Path Parameters

Request Body

Content-Type: application/json

All fields are optional — send only what you want to change.

Body Parameters

{
  "name": "Renamed folder",
  "parent_folder_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
}

Response

Success Response (200)

Returns the updated folder object (same shape as Get folder details).

Error Responses

• 400 Bad Request — Invalid body (e.g., name outside 1–255 chars).
• 401 Unauthorized — Missing or invalid API token.
• 404 Not Found — Folder (or target parent_folder_id) not found.
• 500 Internal Server Error — Server-side error.

Example Usage

cURL — rename

curl -X PUT \
  'https://api-v2.pandavideo.com.br/folders/<folder_id>' \
  -H 'Authorization: your_api_token_here' \
  -H 'Content-Type: application/json' \
  -d '{ "name": "Renamed folder" }'

cURL — move to another folder (or root)

curl -X PUT \
  'https://api-v2.pandavideo.com.br/folders/<folder_id>' \
  -H 'Authorization: your_api_token_here' \
  -H 'Content-Type: application/json' \
  -d '{ "parent_folder_id": null }'

cURL — soft delete (toggle inactive)

curl -X PUT \
  'https://api-v2.pandavideo.com.br/folders/<folder_id>' \
  -H 'Authorization: your_api_token_here' \
  -H 'Content-Type: application/json' \
  -d '{ "status": false }'

Recipes