DELETE /library/{library_id}?action=folder_refer

Removes one or more domains from a folder. Removal is asynchronous — the referrer moves to deleting and a worker completes the removal at the CDN.

🚧

action=folder_refer is required

Without the action query parameter the request does not reach this operation.

📘

Authorization

Requires a valid API token in the Authorization header (without Bearer prefix). The library_id and the referrer must belong to the authenticated user.

HTTP Method & Path

DELETE /library/{library_id}?action=folder_refer

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

Authentication Requirements

Path Parameters

Query Parameters

Request Body

Content-Type: application/json

Body Parameters

{ "refer_id": "789e4567-e89b-12d3-a456-426614174999" }

Response

Success Response (200)

{ "message": "Refers are being removed" }

⚠️

Important

• Passing a library-level referrer ID here returns 400 Cannot delete a library-level refer through folder endpoint. Use the library-level delete instead.
• Removing every domain of a folder makes the folder fall back to the library-level list.
• A referrer in an intermediate state (pending, deleting, turning_inactive) cannot be removed yet.

Error Responses

Example Usage

cURL

curl -X DELETE \
  "https://api-v2.pandavideo.com.br/library/{library_id}?action=folder_refer" \
  -H "Authorization: $PANDA_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "refer_id": "{refer_id}" }'

Related

• Remove a library domain: Delete library or folder referrers
• Toggle without deleting: Toggle a single referrer status