Add Folder Items

​

Path Parameters

​

Body Parameters

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