Lists the domains a folder inherits from its parent folders.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
GET /library/{library_id}?action=folder_refer_inherited
{library_id}?action=folder_refer_inheritedLists the domains a folder inherits from its parent folders, walking up the hierarchy. Use it to answer "why is this subfolder protected when I never configured it?".
action=folder_refer_inheritedis requiredBoth
actionandfolder_idare required query parameters.
AuthorizationRequires a valid API token in the
Authorizationheader (withoutBearerprefix). Thelibrary_idmust belong to the authenticated user.
HTTP Method & Path
GET /library/{library_id}?action=folder_refer_inherited&folder_id={folder_id}
Base URL: https://api-v2.pandavideo.com.br
Authentication Requirements
| Header | Value |
|---|---|
Authorization | Your Panda API token (no Bearer prefix) |
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
library_id | string (uuid) | yes | Library ID owned by the authenticated user |
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
action | string | yes | Fixed value: folder_refer_inherited |
folder_id | string (uuid) | yes | Subfolder whose inherited domains you want to list |
Response
Success Response (200)
Same shape as List folder referrers. Each item's origin.id tells which folder the domain comes from.
{
"refers": [
{
"id": "789e4567-e89b-12d3-a456-426614174999",
"url": "course.mysite.com",
"type": "ALLOW",
"status": "active",
"origin": { "type": "folder", "id": "parent-folder-uuid" }
}
]
}
Reading the result
origin.iddifferent from the folder you queried means the domain was inherited from that parent folder. Subfolders inherit from their parent folder — not from the library-level list.
Error Responses
| Status | When |
|---|---|
400 | Missing or unknown action |
404 | Folder not found |
500 | Internal error |
Example Usage
cURL
curl -X GET \
"https://api-v2.pandavideo.com.br/library/{library_id}?action=folder_refer_inherited&folder_id={subfolder_id}" \
-H "Authorization: $PANDA_API_TOKEN"Related
- Domains set directly on the folder:
GET /library/{library_id}?action=folder_refer
