POST /library/{library_id}

A single path that supports two distinct operations discriminated by the required ?action= query parameter.

Operations Available

🚧

?action= 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

POST /library/{library_id}

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

Path Parameters

Mode 1 — ?action=refer: Add referrers

Request Body

Content-Type: application/json

Accepts a single object or an array of objects.

[
  { "hostname": "app.example.com", "type": "ALLOW" },
  { "hostname": "*.partner.com",  "type": "ALLOW" }
]

Side effects (?action=refer)

• Each referrer is created with initial status:
  • pending (will sync with Bunny CDN) when block_none_refer = true or LibrarySettings does not exist yet
  • inactive when block_none_refer = false (no sync until policy turns on)
• A message is pushed to SQS — the refer worker reconciles with Bunny CDN.
• An audit log entry (add domain) is queued under the security category.

Success Response (200) — ?action=refer

Array of created Refer rows.

[
  {
    "id": "abc12345-e89b-12d3-a456-426614174000",
    "library_id": "123e4567-e89b-12d3-a456-426614174000",
    "type": "ALLOW",
    "url": "app.example.com",
    "status": "pending"
  }
]

Errors (?action=refer)

Mode 2 — ?action=referValidation: Toggle refer policy

Request Body

{ "block_none_refer": true }

Behavior (?action=referValidation)

• Setting true: cascades existing referrers from inactive → pending (worker will re-sync them at the CDN).
• Setting false: cascades existing referrers from active → turning_inactive (worker will deactivate them at the CDN).
• The Bunny CDN policy is updated before the DB is changed; if Bunny fails, the DB change is rolled back.

Success Response (200) — ?action=referValidation

{ "message": "Refer policy updated successfully" }

Errors (?action=referValidation)

Example Usage

cURL — add referrers

curl -X POST \
  -H "Authorization: $PANDA_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '[{"hostname":"app.example.com","type":"ALLOW"}]' \
  "https://api-v2.pandavideo.com.br/library/123e4567-e89b-12d3-a456-426614174000?action=refer"

cURL — toggle refer policy

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

Related

• List referrers: GET /library/{library_id}?action=refer
• Remove referrers: DELETE /library/{library_id}?action=refer
• Update quality settings: PUT /library/{library_id} — see the page Video Qualities