Change a scheduled post
reschedule_postEdit a queued scheduled post: move its time, rewrite the caption, swap media, or change channels and destinations by passing only the fields that need to change.
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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "reschedule_post"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | the new time: local wall clock (2026-10-30T10:00, read in `timezone` or the brand’s zone on that date), UTC (…Z) or epoch ms. Future, at most 365 days out. | |
| id | Yes | the scheduled post id from list_scheduled | |
| link | No | destination URL for a Pinterest Pin, Facebook text post or Google Business post | |
| 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. | |
| brand | No | WHICH PROFILE this post is in — id or exact name from list_brands; needed when it is not the profile this connection is pinned to. A name that matches no profile, or two, is REFUSED. | |
| 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}. | |
| place | No | FACEBOOK — replaces the tagged place (the numeric id of its Facebook Page); an empty string removes it. | |
| story | No | INSTAGRAM — true makes it a 24-hour Story, false an ordinary feed post. One image or one video, no carousel. | |
| 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. | |
| ideaId | No | short id of the content-plan idea this post came from | |
| pageId | No | FACEBOOK / INSTAGRAM / THREADS — publish from a different connected Page (list_meta_pages) | |
| recipe | No | the post's FORMAT id, e.g. "slideshow" or "imessage_chat" — post_performance groups by it, so reuse one id per format | |
| silent | No | TELEGRAM / DISCORD — no notification. | |
| thread | No | X — replaces the WHOLE thread; an explicit [] drops back to a single post using the caption. | |
| wpSlug | No | WORDPRESS — the post slug | |
| wpTags | No | WORDPRESS — tags (names or ids) | |
| 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. | |
| audioId | No | INSTAGRAM REEL — put one of Instagram’s OWN licensed music tracks under the Reel: the `id` search_instagram_audio returns. Instagram mixes it in when the Reel is published; nothing is downloaded or re-rendered. REELS ONLY; an empty string removes it, and only on an Instagram account connected through Meta (a Facebook Page with a linked Instagram), which is Instagram’s own rule — the Instagram connector cannot take it and is refused by name. | |
| boardId | No | PINTEREST — move the Pin to a different board (list_pinterest_boards) | |
| buttons | No | TELEGRAM ONLY — replace the URL buttons ([] removes them). | |
| excerpt | No | BLOG — the excerpt under the title | |
| message | No | replace the caption used for every channel that has no override | |
| audience | No | FACEBOOK — replaces who can see the Page post {countries, regions, cities, minAge}; {} removes the limit. | |
| blogSlug | No | blog post slug | |
| blogTags | No | Shopify blog / Wix tags | |
| 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 | |
| coverUrl | No | INSTAGRAM REEL — replaces the cover image url; an empty string removes it. | |
| imageUrl | No | swap the image; "" removes it | |
| linkName | No | FACEBOOK — replaces the link preview headline; an empty string removes the override. | |
| seoTitle | No | blog search title | |
| timezone | No | IANA zone for a wall-clock `at` | |
| topicTag | No | THREADS ONLY — one topic tag, without the leading #. | |
| userTags | No | INSTAGRAM USER TAGS — tag people (public accounts) on the post; each is notified. Usernames, or { username, x, y } with x/y from 0 to 1 = where the tag sits on the IMAGE (a tag without a position sits at the centre). A Reel tag takes no position; a story position is optional. Not on a carousel (refused by name). | |
| videoUrl | No | swap the video; "" removes it | |
| whopPoll | No | WHOP: poll options, 2 to 10 | |
| xArticle | No | X: replaces the X Article (title, headings); {} makes it an ordinary X post again. | |
| audioName | No | INSTAGRAM REEL — replaces the audio track name; an empty string removes it. | |
| coverAtMs | No | THE VIDEO COVER on every channel, as one frame in milliseconds (see schedule_post). | |
| 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. | |
| parseMode | No | TELEGRAM ONLY — 'HTML' for Telegram's HTML tags. | |
| placeName | No | the name the user saw for that place; a different business is refused | |
| 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. | |
| categoryId | No | YOUTUBE: NUMERIC category id; "" goes back to the default (22). | |
| locationId | No | GOOGLE BUSINESS — a different listing (list_business_locations) | |
| madeWithAi | No | X — the AI-media label; false turns it off. | |
| threadName | No | DISCORD: forum thread title | |
| threadsGif | No | THREADS ONLY — a GIPHY GIF id (the id in a giphy.com/gifs/… link) attached to a TEXT Threads post. GIPHY is the only provider Threads takes. | |
| visibility | No | NOTE: changing this without also naming visibilityByChannel clears any per-channel overrides, so "make it all draft" is not a no-op | |
| whopPinned | No | WHOP: pin the forum post | |
| aiGenerated | No | AI-CONTENT DISCLOSURE (Instagram / Facebook Reel is_ai_generated, TikTok is_aigc, YouTube containsSyntheticMedia, Pinterest ai_disclosures, Threads is_made_with_ai). OMIT IT and the value already on the post stays; a post that never had one is decided from provenance at publish: a Hermoso render is declared AI-generated, media that came through upload_file or from an external URL (the user’s own photos or footage) is NOT. Pass true or false only to override. | |
| audioVolume | No | INSTAGRAM REEL — how loud that track plays, 0–100 (Instagram’s default 100). Needs audioId. | |
| 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 and the caption is used. | |
| disableDuet | No | TIKTOK VIDEO ONLY — block Duets. | |
| linkPicture | No | FACEBOOK — replaces the link preview image url; an empty string removes the override. | |
| madeForKids | No | YOUTUBE: made-for-kids declaration. | |
| quotePostId | No | THREADS ONLY — the id of the Threads post this one quotes. | |
| shareToFeed | No | INSTAGRAM REEL — whether the Reel also shows in the Feed grid. | |
| shopifyBlog | No | which Shopify blog | |
| thumbOffset | No | INSTAGRAM REEL — replaces the cover frame, in milliseconds; 0 removes it. Never together with coverUrl. | |
| videoVolume | No | INSTAGRAM REEL — how loud the video’s own sound plays under the track, 0–100 (Instagram’s default 100; 0 = the track alone). Needs audioId. | |
| whopMention | No | WHOP: notify every member | |
| brandPartner | No | YOUTUBE: sponsoring brand channel (UC… or @handle); "" removes it | |
| callToAction | No | FACEBOOK — replaces the button on the Page post; "" removes it. | |
| captionTrack | No | YOUTUBE: replace the queued caption track (url OR text, plus language). | |
| countryCodes | No | THREADS ONLY — two-letter country codes limiting who can see the post. | |
| firstComment | No | FIRST COMMENT — posted on each new post as the same account right after it publishes, on Facebook, Instagram and LinkedIn company Pages (LinkedIn needs its comments authorization, provider linkedin_community). Other channels publish without it and their result row says so. Up to 2,000 characters, refused rather than cut; never on a story. A failed comment never undoes the post. | |
| optimizeCopy | No | fit the shared caption to each channel’s own rules when you schedule it (the fitted caption is stored on the scheduled post, so what you scheduled is what publishes) wherever no per-channel caption was written; a channel with its own caption is left exactly as written. Send false to switch it off on this item. | |
| 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. | |
| slackChannel | No | SLACK app: channel id or #name (default: the brand's) | |
| thumbnailUrl | No | YOUTUBE: replace the custom thumbnail; "" goes back to a frame of the video, "auto" to YouTube’s pick. | |
| wpCategories | No | WORDPRESS — categories (names or ids) | |
| 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. | |
| coverImageUrl | No | THE VIDEO COVER on every channel, as a Hermoso-hosted picture (see schedule_post). | |
| disableStitch | No | TIKTOK VIDEO ONLY — block Stitches. | |
| discordExtras | No | DISCORD: {embeds, poll, tts, crosspost} | |
| discordServer | No | DISCORD bot: which server | |
| instagramPoll | No | INSTAGRAM — attach a POLL: 2 to 4 answers of 1–25 characters each, and the caption IS the question (so a caption is required). Feed photos, carousels and Reels only (never a story), one caption add-on per post (not with instagramCommentPrompt), and only on an account connected through Meta (a Facebook Page with a linked Instagram). WRITE-ONCE: Instagram cannot add, change or remove it after publishing, so show the user the answers first. | |
| platformCover | No | VIDEO COVER. Omit it (the default) and Hermoso sets the video’s best frame — the same frame as its Library thumbnail — as the cover on every channel that allows one — and on X, Threads and Bluesky, which have none, a blank first frame is replaced on a copy sent there only. true = send no cover and let the platform pick (usually the first frame). A cover you pass yourself always wins. | |
| replySettings | No | X — who may reply; "" goes back to everyone. | |
| slackThreadTs | No | SLACK app: reply in this thread (parent ts) | |
| webflowFields | No | WEBFLOW: required collection fields by slug, e.g. {author:"<item id>"} | |
| brandedContent | No | TIKTOK — the paid-partnership disclosure; false turns it off. | |
| channelOptions | No | rare per-channel extras: threadsChain[] / blueskyThread[] follow-ups threaded under it; linkedinPoll {question, options[], duration ONE_DAY|THREE_DAYS|SEVEN_DAYS|FOURTEEN_DAYS} a poll as the post; linkedinReshareOf repost this (link or urn); ytPlaylistId add to playlist; protectContent Telegram no forwarding/saving; telegramDocument file URL sent as the post; slackUsername / slackIconUrl / slackIconEmoji (:rocket:) the Slack app posts as that name and picture | |
| disableComment | No | TIKTOK — comments off on this post. | |
| disablePreview | No | TELEGRAM ONLY — no link preview. | |
| discordChannel | No | DISCORD bot: channel id or #name (default: the brand's) | |
| discordReplyTo | No | DISCORD bot: reply to this message id | |
| 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. | |
| seoDescription | No | blog search description | |
| slackWorkspace | No | SLACK app: which workspace | |
| targetAudience | No | LINKEDIN COMPANY PAGE — replaces who sees the post; {} removes the limit. The matching audience must be over 300 followers. | |
| whopVisibility | No | WHOP: who can see the forum post | |
| discordMentions | No | DISCORD: let mentions ping | |
| linkDescription | No | FACEBOOK — replaces the link preview description; an empty string removes the override. | |
| paidPartnership | No | INSTAGRAM AND X — the paid-partnership label; false turns it off. | |
| threadsLongText | No | THREADS ONLY — LONG-FORM text, up to 10,000 characters, attached under a TEXT-only Threads post (Threads' text attachment). The way to publish more than Threads' 500-character post: keep a short lead in the message and put the full text here. Not with an image, video or carousel. | |
| callToActionLink | No | FACEBOOK — replaces where the button goes; an empty string falls back to the post link. | |
| 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. | |
| threadsGhostPost | No | THREADS ONLY — a GHOST post: text only, Threads archives it automatically after 24 hours (a flash offer, a 24h-only note). No other Threads option can ride it. | |
| whopExperienceId | No | WHOP — move it to a different forum or chat (exp_…, from list_whop_destinations). | |
| whopPaywallCents | No | WHOP: forum-post paywall in cents (needs a title) | |
| 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. | |
| notifySubscribers | No | YOUTUBE: notify subscribers when it goes live. | |
| discordStartThread | No | DISCORD bot: open a thread under the post, this title | |
| instagramLocationId | No | INSTAGRAM — replaces the tagged place (the numeric id of its Facebook Page); an empty string removes it. Not locationId, which is the Google Business listing. | |
| visibilityByChannel | No | per-channel visibility override, e.g. {tiktok: draft}; values public, unlisted, private or draft | |
| whopPaywallCurrency | No | WHOP: paywall currency | |
| crossreshareDarkMode | No | THREADS ONLY — dark-mode that Instagram Story. Needs crossreshareToIg. | |
| paidProductPlacement | No | YOUTUBE: paid product placement (shows the disclosure) — false removes it | |
| instagramPollExtended | No | INSTAGRAM — give that poll Instagram’s extended voting duration instead of its default 3 days (Instagram’s changelog says it then stays open indefinitely). Only with instagramPoll. | |
| instagramCommentPrompt | No | INSTAGRAM — make the caption a COMMENT PROMPT that people answer in the comments. Same limits as instagramPoll, and never together with it. | |
| linkedinOrganizationId | No | LINKEDIN — target a different company Page, or "" to post as the connected person instead | |
| brandedContentSponsorIds | No | INSTAGRAM — replaces the sponsor user ids behind the paid-partnership label (at most 2); [] removes them. |