Skip to main content
GET
/
api
/
partner
/
v1
/
folders
/
{folderId}
/
ancestors
curl --request GET \
  --url https://www.genviral.io/api/partner/v1/folders/{{folder_id}}/ancestors \
  --header 'Authorization: Bearer <token>'
{
  "ok": true,
  "code": 200,
  "message": "Folder ancestors retrieved",
  "data": {
    "folder_id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
    "ancestors": [
      {
        "id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
        "name": "All Uploads",
        "parent_folder_id": null,
        "depth": 0
      },
      {
        "id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
        "name": "Campaigns",
        "parent_folder_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
        "depth": 1
      }
    ]
  }
}
Returns the folder lineage from root to immediate parent.

Path Parameters

folderId
string
required
Folder ID.
curl --request GET \
  --url https://www.genviral.io/api/partner/v1/folders/{{folder_id}}/ancestors \
  --header 'Authorization: Bearer <token>'
{
  "ok": true,
  "code": 200,
  "message": "Folder ancestors retrieved",
  "data": {
    "folder_id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
    "ancestors": [
      {
        "id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
        "name": "All Uploads",
        "parent_folder_id": null,
        "depth": 0
      },
      {
        "id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
        "name": "Campaigns",
        "parent_folder_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
        "depth": 1
      }
    ]
  }
}

Error Responses

  • 400 missing_folder_id - missing route parameter
  • 422 invalid_path - folderId is not a valid UUID
  • 422 invalid_folder_media_type - folder media type is not supported by Partner folder APIs
  • 404 not_found - folder not visible in key scope
  • 500 folder_ancestors_list_failed - unexpected lookup failure