GET /library/{library_id}?action=refer_all

Consolidated view of every domain of the library — library-level and folder-level — grouped by hostname. Useful to audit the whole configuration in a single call.

🚧

action=refer_all is required

Without the action query parameter this path returns the library details instead.

📘

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=refer_all

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

Authentication Requirements

Path Parameters

Query Parameters

Response

Success Response (200)

{
  "refers": [
    {
      "hostname": "mysite.com",
      "type": "ALLOW",
      "status": "active",
      "scope": "library",
      "library_refer_id": "91478577-f4f1-484f-8dab-69a1afb39095",
      "folders": [],
      "type_inconsistency": false,
      "created_at": "2026-08-05T02:46:36.000Z"
    },
    {
      "hostname": "course.mysite.com",
      "type": "ALLOW",
      "status": "mixed",
      "scope": "folder",
      "library_refer_id": null,
      "folders": [
        {
          "folder_id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "Module 1",
          "refer_id": "789e4567-e89b-12d3-a456-426614174999",
          "status": "pending"
        }
      ],
      "type_inconsistency": false,
      "created_at": "2026-08-05T02:31:36.000Z"
    }
  ]
}

Response Schema

⚠️

Important

• Results are grouped by hostname, so one entry may cover several rows across folders. Use folders[].refer_id to act on a specific row.
• status: "mixed" is not a persisted state — it means the underlying rows disagree.
• This view calls the scope scope, while the folder endpoints call the same information origin.

Error Responses

Example Usage

cURL

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

Related

• Library-level list: GET /library/{library_id}?action=refer
• Folder-level list: GET /library/{library_id}?action=folder_refer