Pull a whole drop
Grab an entire folder as one ordered, role-classified bundle to sell in a single message.
Who this is for: chatters selling a whole shoot at once.
A drop
reads one folder and classifies its items by role — video, photoset, bts, other — then
hands back a single ordered bundle_media_ids array ready for a one-tap PPV send.
curl "https://app.tease.link/api/admin/vault/drop/f_2291" \
-H "Authorization: Bearer $TEASE_API_KEY"Response shape
{
"folder_id": "f_2291",
"name": "Red lingerie set",
"cover_media_id": "m_88120",
"roles": {
"video": { "count": 1, "media_ids": ["m_88130"] },
"photoset": { "count": 8, "media_ids": ["m_88120", "m_88121"] },
"bts": { "count": 2, "media_ids": ["m_88140", "m_88141"] },
"other": { "count": 0, "media_ids": [] }
},
"bundle_media_ids": ["m_88130", "m_88120", "m_88121", "m_88140", "m_88141"],
"counts": { "total": 11, "video": 1, "photoset": 8, "bts": 2, "other": 0 },
"is_drop": true
}| Field | Description |
|---|---|
cover_media_id | The item with a captured cover, or the folder's first item if none has one. |
roles | Items split by role, each with a count and its own media_ids. |
bundle_media_ids | The whole folder in one send order — video, then photoset, then bts, then other. Feed this straight into a PPV/message composer. |
is_drop | true only when the folder has at least one video and at least one photoset or BTS item — a single loose video, or a photoset with no video, is not a "drop". |
How role is classified
A BTS keyword match (English and Russian variants — "bts", "backstage", "закулис", "за
кадром") wins over media type first; otherwise video-type files (video, gif, video_hls)
are video, photo-type files (photo, image, photoset) are photoset, and anything else
is other.
What's next
Not every folder is a drop — check Organize the vault locally to favorite or note the ones worth building into one, or see Manage OnlyFans vault folders to reshape one before pulling it.