curl --request POST \
--url https://www.genviral.io/api/partner/v1/folders/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa/items \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"item_ids": [
"11111111-1111-1111-1111-111111111111",
"22222222-2222-2222-2222-222222222222"
]
}'
{
"ok": true,
"code": 200,
"message": "Folder items added",
"data": {
"folder_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
"item_type": "file",
"added_count": 2
}
}
Folders
Add Folder Items
Add files or slideshows to a folder
POST
/
api
/
partner
/
v1
/
folders
/
{folderId}
/
items
curl --request POST \
--url https://www.genviral.io/api/partner/v1/folders/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa/items \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"item_ids": [
"11111111-1111-1111-1111-111111111111",
"22222222-2222-2222-2222-222222222222"
]
}'
{
"ok": true,
"code": 200,
"message": "Folder items added",
"data": {
"folder_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
"item_type": "file",
"added_count": 2
}
}
Adds one or more in-scope file or slideshow IDs to a folder. Duplicate IDs in the request are deduped server-side.
Path Parameters
string
required
Folder UUID.
Body Parameters
string[]
required
UUIDs of files or slideshows to add (
1-200 items).curl --request POST \
--url https://www.genviral.io/api/partner/v1/folders/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa/items \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"item_ids": [
"11111111-1111-1111-1111-111111111111",
"22222222-2222-2222-2222-222222222222"
]
}'
{
"ok": true,
"code": 200,
"message": "Folder items added",
"data": {
"folder_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
"item_type": "file",
"added_count": 2
}
}
Error Responses
400 invalid_json- malformed JSON body422 invalid_path-folderIdis not a valid UUID422 invalid_payload- missing or invaliditem_ids404 not_found- folder not visible in key scope404 item_not_found- one or more item IDs are 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_add_failed- unexpected failure