Skip to main content
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

​
folderId
string
required
Folder UUID.

​
Body Parameters

​
item_ids
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 body
  • 422 invalid_path - folderId is not a valid UUID
  • 422 invalid_payload - missing or invalid item_ids
  • 404 not_found - folder not visible in key scope
  • 404 item_not_found - one or more item IDs are not visible in key scope
  • 401 - authentication failed (missing/invalid/revoked token)
  • 402 subscription_required - active Creator/Professional/Business plan required
  • 403 tier_not_allowed - Scheduler tier cannot use Partner API
  • 500 folder_items_add_failed - unexpected failure