DELETE /library/{library_id}?action=refer

Removes one or more allowed referrers from the library. The operation is asynchronous: referrers transition to status = deleting and a worker removes them from Bunny CDN before the database row is destroyed.

🚧

?action=refer is required. Without it, the gateway returns 405 Unsupported method.

📘

Authorization

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

HTTP Method & Path

DELETE /library/{library_id}

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

Path Parameters

Query Parameters

Request Body

Content-Type: application/json

Accepts a single object or an array of objects. Validation is strict (additionalProperties: false in Ajv).

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

Side effects

• Each referrer transitions to status = deleting in the database.
• A message is pushed to SQS — the refer worker removes the entry from Bunny CDN.
• Once the CDN sync completes, the row is destroyed permanently.
• An audit log entry (remove domain) is queued under the security category.

Response

Success Response (200)

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

📘

Asynchronous removal

The response confirms acceptance, not completion. To verify removal, poll GET /library/{library_id}?action=refer until the entry disappears.

Error Responses

Example Usage

cURL — remove a single referrer

curl -X DELETE \
  -H "Authorization: $PANDA_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"refer_id":"789e4567-e89b-12d3-a456-426614174999"}' \
  "https://api-v2.pandavideo.com.br/library/123e4567-e89b-12d3-a456-426614174000?action=refer"

cURL — bulk remove

curl -X DELETE \
  -H "Authorization: $PANDA_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '[
    {"refer_id":"789e4567-e89b-12d3-a456-426614174999"},
    {"refer_id":"abc12345-e89b-12d3-a456-426614174000"}
  ]' \
  "https://api-v2.pandavideo.com.br/library/123e4567-e89b-12d3-a456-426614174000?action=refer"

Related

• List referrers: GET /library/{library_id}?action=refer
• Add referrers: POST /library/{library_id}?action=refer
• Toggle refer policy: POST /library/{library_id}?action=referValidation