Skip to main content
Developers

Bulk series API

Preview, create and cancel a series of posts from a list of media.

Endpoints

EndpointPurpose
POST /api/posts/series/previewDry run. Writes nothing.
POST /api/posts/seriesCreates the series. The body must contain "confirm": true.
POST /api/posts/series/{series_id}/cancelCancels scheduled posts, deletes drafts and lists untouched ones as skipped.

Example

bash
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, or posts_per_day with days.
  • start_date (IST, YYYY-MM-DD) and times (HH:MM IST), or use_account_slots.
  • Captions: captions[], caption_template, or slide_captions[].
  • mode: schedule, draft or send_for_approval.
  • overflow_strategy: split_into_more_posts, skip_platform or fail.
  • 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.

v0.1.2

Bulk series API | Documentation | Sociquza