keep posts
Keep posts from pull_posts in the library, by the ids it returned, within two days of the pull (a TikTok video within about six hours, when its address lapses). Each lands like any import: Eversince’s copy of every picture and video in it, a carousel slide by slide, with everything the platform said (handle, dates, engagement, permalink) on each item, searchable, filed in folder when one is named (created if new). A YouTube post keeps its thumbnail and link, since no video file is served; pull_posts transcript_of reads its words. Media the platform has since expired is reported; pull again. Up to 20 files a call. A post kept before comes back as its ref; delete_items removes one. Free; a kept file’s search vectors use cloud processing.
Authorizations
An API key (es_live_…) from Settings, under API keys, or an OAuth access token.
Headers
Retry a paid dispatch safely: the same key returns the job already dispatched instead of charging again.
The workspace this one call acts in, when it is not the default: for a key or a connected agent, one of the workspaces the user allowed it.
Body
Post ids, as pull_posts returned them.
1 - 20 elementsFolder path or id to file them in, made if it does not exist. Without one they go where any import goes.
Optional: one sentence shown to the user beside this action.
600
