curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/folders/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa/items?since=2026-08-01T00%3A00%3A00.000Z&until=2026-08-31T23%3A59%3A59.999Z&limit=20&offset=0' \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Folder items retrieved",
"data": {
"media_type": "upload",
"item_type": "file",
"items": [
{
"id": "11111111-1111-1111-1111-111111111111",
"url": "https://cdn.vireel.io/...",
"content_type": "image/jpeg",
"filename": "slide-1.jpg",
"size": 524288,
"created_at": "2026-03-01T09:00:00.000Z",
"added_at": "2026-03-01T09:05:00.000Z"
}
],
"total": 1,
"limit": 20,
"offset": 0
}
}
Folders
List Folder Items
List files or slideshows contained in a folder
GET
/
api
/
partner
/
v1
/
folders
/
{folderId}
/
items
curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/folders/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa/items?since=2026-08-01T00%3A00%3A00.000Z&until=2026-08-31T23%3A59%3A59.999Z&limit=20&offset=0' \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Folder items retrieved",
"data": {
"media_type": "upload",
"item_type": "file",
"items": [
{
"id": "11111111-1111-1111-1111-111111111111",
"url": "https://cdn.vireel.io/...",
"content_type": "image/jpeg",
"filename": "slide-1.jpg",
"size": 524288,
"created_at": "2026-03-01T09:00:00.000Z",
"added_at": "2026-03-01T09:05:00.000Z"
}
],
"total": 1,
"limit": 20,
"offset": 0
}
}
Folder item behavior depends on folder media type:
slideshowfolder → item IDs are slideshow IDsai_image,ai_video, anduploadfolders → item IDs are file IDs
added_at remains available as folder-membership history.
Path Parameters
string
required
Folder UUID.
Query Parameters
string
Inclusive ISO-8601 lower bound on the media item’s
created_at timestamp.string
Inclusive ISO-8601 upper bound on the media item’s
created_at timestamp.number
default:"50"
Number of items to return (
1-100).number
default:"0"
Number of items to skip.
curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/folders/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa/items?since=2026-08-01T00%3A00%3A00.000Z&until=2026-08-31T23%3A59%3A59.999Z&limit=20&offset=0' \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Folder items retrieved",
"data": {
"media_type": "upload",
"item_type": "file",
"items": [
{
"id": "11111111-1111-1111-1111-111111111111",
"url": "https://cdn.vireel.io/...",
"content_type": "image/jpeg",
"filename": "slide-1.jpg",
"size": 524288,
"created_at": "2026-03-01T09:00:00.000Z",
"added_at": "2026-03-01T09:05:00.000Z"
}
],
"total": 1,
"limit": 20,
"offset": 0
}
}
Error Responses
400 invalid_query_parameter- invalidlimitoroffset422 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 scope401- authentication failed (missing/invalid/revoked token)402 subscription_required- active Creator/Professional/Business plan required403 tier_not_allowed- Scheduler tier cannot use Partner API500 folder_items_list_failed- unexpected failure