GET /library/{library_id}?action=folder_refer

Lists the domains registered directly on a folder. Domains inherited from parent folders are not included here — use List inherited folder referrers for those.

🚧

action=folder_refer is required

Both action and folder_id are required query parameters. Without action, this path returns the library details instead of a referrer list.

📘

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

GET /library/{library_id}?action=folder_refer&folder_id={folder_id}

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

Authentication Requirements

Path Parameters

Query Parameters

Response

Success Response (200)

{
  "refers": [
    {
      "id": "789e4567-e89b-12d3-a456-426614174999",
      "url": "course.mysite.com",
      "type": "ALLOW",
      "status": "active",
      "origin": { "type": "folder", "id": "123e4567-e89b-12d3-a456-426614174000" }
    }
  ]
}

Response Schema

⚠️

Important

• Folder domains replace the library list for videos in that folder — they do not add to it.
• The field is called origin here, but the consolidated view (?action=refer_all) calls the same information scope. This inconsistency is real in the API.

Error Responses

Example Usage

cURL

curl -X GET \
  "https://api-v2.pandavideo.com.br/library/{library_id}?action=folder_refer&folder_id={folder_id}" \
  -H "Authorization: $PANDA_API_TOKEN"

Related

• Inherited domains: GET /library/{library_id}?action=folder_refer_inherited
• Add a folder domain: POST /library/{library_id}?action=folder_refer
• Consolidated view: GET /library/{library_id}?action=refer_all