Ctrl K
Developers
bash
Bulk series API
Preview, create and cancel a series of posts from a list of media.
Endpoints
| Endpoint | Purpose |
|---|---|
| POST /api/posts/series/preview | Dry run. Writes nothing. |
| POST /api/posts/series | Creates the series. The body must contain "confirm": true. |
| POST /api/posts/series/{series_id}/cancel | Cancels scheduled posts, deletes drafts and lists untouched ones as skipped. |
Example
curl -s -X POST "https://plotpostapi.kriva.studio/api/posts/series/preview" \
-H "Authorization: Bearer $KEY" -H "Content-Type: application/json" -d '{
"application_id": "WORKSPACE_ID",
"account_ids": ["INSTAGRAM_ACCOUNT", "X_ACCOUNT"],
"media_ids": ["m1", "m2", "..."],
"items_per_post": 5,
"start_date": "2026-11-01",
"times": ["09:00"],
"caption_template": "Part {n}/{total}",
"mode": "schedule",
"overflow_strategy": "split_into_more_posts"
}'Fields
items_per_post, orposts_per_daywithdays.start_date(IST,YYYY-MM-DD) andtimes(HH:MMIST), oruse_account_slots.- Captions:
captions[],caption_template, orslide_captions[]. mode:schedule,draftorsend_for_approval.overflow_strategy:split_into_more_posts,skip_platformorfail.- Limits: 500 media, 100 posts, 9 tags per post.
Create returns 201 { series_id, created_count, posts[] }. A failure part-way returns 207 with the posts that were created and the ones that were not.