Posts

Replace post media

Swaps the video or image behind a draft, ready, scheduled, or failed post for another finished upload in the same workspace. The post keeps its schedule, captions, first comments and platform options; only the file changes.

With apply_to_batch: true, every other post in the same batch (same media, same status and, for scheduled posts, the same scheduled_for) is swapped too. The new file is not re-checked against each platform's limits.

post/posts/{post_id}/replace-media

Request

  • Base URL: https://api.shortsync.app/v1
  • URL: https://api.shortsync.app/v1/posts/{post_id}/replace-media
  • Auth: HTTP bearer

Request body

upload_idstring required

Id of a finished upload (from POST /uploads) in this workspace. Text posts and carousels can't be swapped in.

apply_to_batchboolean

Also swap the other posts in this post's batch (same media, same status, same scheduled time).

Response

Media replaced. Returns every post that now uses the new media.

Changes

No recorded changes to this operation across all 1 revision of this API.