curl -X POST "https://example.com/api/v1/scheduled-posts/55555555-5555-4555-8555-555555555555/replace?platform=threads" \  -H "Content-Type: application/json" \  -d '{    "accountIds": [      "11111111-1111-4111-8111-111111111111"    ],    "posts": [      "Updated launch announcement"    ],    "scheduledAt": "2026-10-02T09:00:00+09:00",    "timezone": "Asia/Seoul"  }'

{  "results": [    {      "accountId": "11111111-1111-4111-8111-111111111111",      "provider": "threads",      "username": "your_brand",      "success": true,      "scheduledPostIds": [        "77777777-7777-4777-8777-777777777777"      ],      "scheduledAt": "2026-10-02T09:00:00+09:00"    }  ],  "summary": {    "succeeded": 1,    "failed": 0  },  "replaced": {    "scheduledPostId": "55555555-5555-4555-8555-555555555555",    "platform": "threads",    "canceled": 1  }}

Replace a scheduled post with a new one in one request. Posteady creates the new schedule first and cancels the original only after the new one is accepted, so a failed request does not leave the time slot empty. The request body is the same as for scheduling a post, and accountIds must be exactly the original post's account. The new post gets new scheduledPostIds. If the new schedule fails, the original stays as it is and replaced is null. If the original starts publishing before it can be canceled, Posteady cancels the new schedule and returns POST_NOT_CANCELLABLE (409). Only a scheduled post that hasn't started publishing can be replaced. Instagram and Facebook posts created through the API keep their content, media, and target after they are accepted, so replace them to change those. If the request times out, list scheduled posts before you send it again.

Authorization

apiKey

AuthorizationBearer <token>

In: header

Path parameters

id*string

Formatuuid

Query parameters

platform*string

Value in

"threads"
"x"
"linkedin"
"tiktok"
"instagram"
"youtube"
"facebook"

Request body

application/json

TypeScript definitions

Use the request body type in TypeScript.

Publish text to Threads, X, or LinkedIn; include video for one public TikTok video; include instagram for one Instagram media post; include youtube for one YouTube video; or include facebook for one Facebook Page post. TikTok uses posts and video together. Instagram, YouTube, and Facebook are self-contained modes and cannot be combined with other write modes. A Threads text request can add mediaIds to attach library images to the first post.

accountIds?array<>

One to five text targets, or exactly one TikTok, Instagram, YouTube, or Facebook account for media publishing.

Items1 <= items <= 5

posts*array<>

Text chain, or exactly one non-empty caption when video is present. TikTok captions allow up to 2,200 UTF-16 code units. LinkedIn also requires one post. For X, links are automatically removed from posts[0] before publishing or saving a schedule: http://, https://, www., and bare domains such as foo.com or foo.io/path, including paths, query strings, and fragments. Links in replies (posts[1] onward) and all text for other platforms are preserved. X character limits are checked after removal. If the first X post becomes empty or whitespace-only, the entire request fails with VALIDATION_ERROR (HTTP 422) before any publishing or scheduling occurs.

Items1 <= items <= 25

mediaIds?array<>

Threads only. Confirmed image mediaIds from the media library (GET /api/v1/media with mediaType=IMAGE) attached to posts[0]. One image publishes an image post, and 2–20 images publish a carousel. Replies in posts[1] onward stay text. Every account in accountIds must be a Threads account. Cannot be combined with video, instagram, youtube, or facebook.

Items1 <= items <= 20

video?

Publish one video from the same workspace's active media library to one account connected through TikTok for Business Developers. Confirm a new upload before using its mediaId. Photo publishing and arbitrary video URLs are not supported. The request must contain exactly one accountId and one caption in posts.

instagram?||

Publish to one Instagram professional account. Choose exactly one content type contract below and do not combine this object with posts or video.

youtube?

Publish one video from the same workspace's active media library to one connected YouTube channel. Confirm a new upload before using its mediaId. Videos may be up to 500 MiB and 12 hours long. The request must contain exactly one accountId and must not include posts, video, or instagram. A first comment is not supported.

facebook?|||

Publish asynchronously to one Facebook Page. Choose exactly one explicit content type and do not combine this object with posts, video, instagram, or youtube. requestId is unique within the workspace; reuse it only for the same unchanged request.

scheduledAt*string

Future ISO 8601 timestamp with an offset, within 360 days. Replace the example timestamp with your own future publishing time.

Formatdate-time

timezone?string

IANA timezone (e.g. Asia/Seoul). Uses the workspace default, or UTC if unavailable, when omitted.

Replace a scheduled post

Authorization

Path parameters

Query parameters

Request body

Response body

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

Replace a scheduled post

Authorization

Path parameters

Query parameters

Request body

Response body

200application/json

202application/json

404application/json

409application/json

422application/json

502application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`