Change a scheduled post
reschedule_postIdempotent
Adjust a queued post's schedule, caption, media, or target channels before it publishes.
Instructions
Change a post that is still QUEUED — move it to a different time, rewrite the caption, swap the media, add or drop a channel, or change which board / Page / company Page / listing it goes to. PASS ONLY WHAT CHANGES: an omitted field is left exactly as it was, and an explicit empty string CLEARS one (linkedinOrganizationId:"" moves a company-Page post back to the person’s own profile). The edited item is re-checked against the identical rules its create passed — visibility the channel can honour, per-channel length, media the channel can carry — so an edit can never slip past a refusal that a create would have caught. Get the id from list_scheduled. Something that already went out cannot be changed: a published post is edited or removed with manage_meta_post / manage_linkedin_post / delete_x_post, not rescheduled.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | the new time — ISO timestamp (2026-08-05T09:00:00Z) or epoch milliseconds. Must be in the future, at most 365 days out. | |
| id | Yes | the scheduled post id from list_scheduled | |
| link | No | ||
| poll | No | X — replaces the poll; an empty options list removes it. | |
| tags | No | YOUTUBE — replaces the WHOLE tag list; an empty array [] clears the tags. | |
| event | No | GOOGLE BUSINESS — replaces the whole event record {title, startDate, startTime, endDate, endTime}. | |
| offer | No | GOOGLE BUSINESS — replaces the whole offer record {couponCode, redeemOnlineUrl, termsConditions}. | |
| title | No | PINTEREST / YOUTUBE — replace the headline; "" clears it and goes back to deriving one from the caption | |
| chatId | No | TELEGRAM — send it to a different chat, group or channel (@username or numeric id). It can be changed but never cleared: telegram cannot publish without one. | |
| pageId | No | FACEBOOK / INSTAGRAM / THREADS — publish from a different connected Page (list_meta_pages) | |
| thread | No | X — replaces the WHOLE thread; an explicit [] drops back to a single post using the caption. | |
| altText | No | ACCESSIBILITY — replace the screen-reader description(s). A STRING describes every slide; an ARRAY describes them one at a time in slide order and REPLACES the whole list. "" clears it. | |
| boardId | No | PINTEREST — move the Pin to a different board (list_pinterest_boards) | |
| message | No | replace the caption used for every channel that has no override | |
| captions | No | replaces the WHOLE per-channel caption map — send every override you want to keep, not just the new one | |
| channels | No | replaces the channel list | |
| imageUrl | No | swap the image; "" removes it | |
| topicTag | No | THREADS ONLY — one topic tag, without the leading #. | |
| videoUrl | No | swap the video; "" removes it | |
| imageUrls | No | replace the CAROUSEL slides, in order; an empty array [] drops the carousel and goes back to a single image. Omit to leave the slides exactly as they are. The edited item is re-checked against the same carousel rules the create passed, so adding a channel that cannot swipe is refused now rather than posting slide 1 later. | |
| slideText | No | PINTEREST CAROUSEL ONLY — per-slide title / description / link, aligned to slide order. | |
| topicType | No | GOOGLE BUSINESS — the kind of Post; EVENT and OFFER both require `event`. | |
| trialReel | No | INSTAGRAM — replaces the trial-reel setting on a queued Reel (MANUAL or SS_PERFORMANCE); an explicit "" turns the trial off and it goes out as an ordinary Reel. Only takes effect while the post is still queued — a Reel already published cannot be converted into a trial. | |
| yourBrand | No | TIKTOK — the own-brand disclosure; false turns it off. | |
| actionType | No | GOOGLE BUSINESS — the call-to-action button; "" clears it. | |
| locationId | No | GOOGLE BUSINESS — a different listing (list_business_locations) | |
| madeWithAi | No | X — the AI-media label; false turns it off. | |
| visibility | No | NOTE: changing this without also naming visibilityByChannel clears any per-channel overrides, so "make it all draft" is not a no-op | |
| communityId | No | X — the community to publish into; an empty string goes back to the main timeline. | |
| description | No | YOUTUBE — replace the video description; "" clears it. Remember the caption is the TITLE, not the description. | |
| disableDuet | No | TIKTOK VIDEO ONLY — block Duets. | |
| quotePostId | No | THREADS ONLY — the id of the Threads post this one quotes. | |
| countryCodes | No | THREADS ONLY — two-letter country codes limiting who can see the post. | |
| privacyLevel | No | TIKTOK — WHICH PRIVACY LEVEL the post goes out at, in TikTok’s own vocabulary. TikTok requires the USER to choose this from the levels their own account allows: call tiktok_creator_info, show them the real options, and pass back the one they picked — never a default and never a guess, which TikTok refuses at init. Omit it and the post falls back to the coarse `visibility` (private → SELF_ONLY, otherwise PUBLIC_TO_EVERYONE), which cannot express MUTUAL_FOLLOW_FRIENDS or FOLLOWER_OF_CREATOR at all. It must agree with the TikTok visibility (SELF_ONLY is the private one) and it is refused on a TikTok DRAFT, which carries no post info. | |
| replyControl | No | THREADS ONLY — who may reply. | |
| xQuotePostId | No | X — the post this one QUOTES; an empty string removes the quote. Named apart from the Threads `quotePostId` on this same schedule. | |
| collaborators | No | INSTAGRAM — replaces the WHOLE collab list (up to 3 usernames); an explicit [] removes the co-authors and the post goes out as an ordinary single-author post. Only takes effect if the post has not fired yet — an invite already sent cannot be withdrawn from here. | |
| disableStitch | No | TIKTOK VIDEO ONLY — block Stitches. | |
| replySettings | No | X — who may reply; "" goes back to everyone. | |
| brandedContent | No | TIKTOK — the paid-partnership disclosure; false turns it off. | |
| disableComment | No | TIKTOK — comments off on this post. | |
| linkAttachment | No | THREADS ONLY — a full http(s) URL rendered as a link card on a TEXT-ONLY post. The only way a Threads post carries a destination. | |
| paidPartnership | No | X — the paid-partnership label; false turns it off. | |
| coverTimestampMs | No | TIKTOK VIDEO ONLY — cover frame in milliseconds. | |
| crossreshareToIg | No | THREADS ONLY — also share to Instagram as a Story when it fires; false turns it off. Refused on a carousel. | |
| commercialContent | No | TIKTOK — the COMMERCIAL CONTENT DISCLOSURE toggle: true when this post promotes a brand, product or service at all. TikTok requires at least one of yourBrand / brandedContent once it is on, and refuses a post that declares itself commercial without naming which kind. Either disclosure already implies it. | |
| visibilityByChannel | No | ||
| crossreshareDarkMode | No | THREADS ONLY — dark-mode that Instagram Story. Needs crossreshareToIg. | |
| linkedinOrganizationId | No | LINKEDIN — target a different company Page, or "" to post as the connected person instead |