PUT /block_download

Enables or disables the library-wide anti-download flag.

📘

Authorization

Requires a valid API token in the Authorization header (without Bearer prefix). The library is resolved automatically by the token's user_id.

⚠️

Always send a boolean

Non-boolean values (number, string, null, missing field) are accepted by the route but the change is silently dropped — the response echoes the value you sent but LibrarySettings.block_download is not updated. This is a real production behavior; always send true or false.

HTTP Method & Path

PUT /block_download

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

Authentication Requirements

Request Body

Content-Type: application/json

{ "status": true }

Side effects

• Persists LibrarySettings.block_download = status (only when status is a boolean).
• Invalidates the getLibraryById_{library_id} memcache key.
• Queues an audit log entry under the security category — enable when status: true, disable when status: false.

Response

Success Response (200)

{ "status": true }

The response echoes whatever value was sent — including non-boolean values that were not actually persisted.

Error Responses

Example Usage

cURL — enable

curl -X PUT \
  -H "Authorization: $PANDA_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status": true}' \
  https://api-v2.pandavideo.com.br/block_download

cURL — disable

curl -X PUT \
  -H "Authorization: $PANDA_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status": false}' \
  https://api-v2.pandavideo.com.br/block_download

Related

• Read the flag: GET /block_download
• Per-video offline / anti-download configuration: configure-video-offline