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
}
]
}
}
Folders
List Folder Ancestors
Get breadcrumb ancestors for a folder
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
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 parameter422 invalid_path-folderIdis not a valid UUID422 invalid_folder_media_type- folder media type is not supported by Partner folder APIs404 not_found- folder not visible in key scope500 folder_ancestors_list_failed- unexpected lookup failure
