Update Post
update_postUpdate a DRAFT, SCHEDULED or FAILED post in place. A post that failed on every platform becomes a DRAFT again with its platforms back to pending; publish or schedule it afterwards with publish_draft. Any other status, including a post that published on some platforms and failed on others, fails with "Cannot edit post in current state", so published posts cannot be changed. Updates are partial: text, contentType, scheduledAt, timezone, thumbnail fields, firstComments, platformThumbnails and platformMedia you omit keep their values; sending firstComments, platformThumbnails or platformMedia replaces every stored entry, and platformMedia [] clears every media override. The exception is platforms: sending it rebuilds the post's target set from this request alone, so include every connection-id array and platform config you want to keep (TikTok with privacyLevel, Pinterest with its boardId or boardName); omitting platforms leaves accounts, configs, and media untouched. mediaUrls only take effect together with platforms, while platformMedia takes effect without it; use publicUrl values from upload_media. On SCHEDULED posts new media is verified in storage. A post with a YouTube video already waiting on YouTube (youtubeScheduledVideoId set and not yet published) fails with 409 SCHEDULED_ON_YOUTUBE; delete it and schedule it again to change it. Returns the updated post record. Use publish_draft to change a draft's status, unschedule_post to take a scheduled post off the calendar, delete_post to cancel, and create_post for a new post.
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": "update_post"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Post ID to update (DRAFT, SCHEDULED, or FAILED on every platform) | |
| text | No | Updated text; omit to keep the current text. On LinkedIn, mention a company page with @[Page Name](urn:li:organization:<id>), using the page name exactly as LinkedIn shows it | |
| pageIds | No | Facebook page account ids from list_accounts (the account id; its pageId value is also accepted). Facebook has no connection-id array | |
| timezone | No | IANA timezone stored for display; does not shift scheduledAt | |
| mediaUrls | No | Replacement media URLs, applied only when platforms is also sent. Use publicUrl values from upload_media or get_upload_urls | |
| platforms | No | New target platforms. Sending this replaces every target, so also resend the connection-id arrays and platform configs to keep; omit to leave targets unchanged | |
| contentType | No | New content type; must match the media on the post. CAROUSEL takes 2 or more items in mediaUrls, up to 4 on BLUESKY and MASTODON, 5 on PINTEREST, 10 on INSTAGRAM, FACEBOOK, THREADS and TELEGRAM, 20 on TWITTER, LINKEDIN and WORDPRESS, 30 on TUMBLR and 35 on TIKTOK (JPEG or WebP photos only). INSTAGRAM and THREADS accept images and videos in the same carousel; every other platform takes images only, and YOUTUBE has no carousel. Give a platform with a lower limit its own items through platformMedia. GOOGLE_BUSINESS takes TEXT or IMAGE with one JPEG or PNG image up to 5 MB, and text up to 1500 characters. DOCUMENT publishes one PDF, PPT, PPTX, DOC or DOCX file (max 100 MB, 300 pages) as a LinkedIn document post and is LinkedIn only: put exactly that one file in mediaUrls, target only LINKEDIN, and set the title with linkedinConfigs | |
| scheduledAt | No | New schedule time as an absolute ISO 8601 instant; omit to keep. On a DRAFT it sets the planned date and the post stays a draft; null takes the planned date off a DRAFT (or a FAILED post, which becomes a draft) and moves it off the calendar. On a SCHEDULED post null fails with 400 (use unschedule_post), and moving it more than a minute into the past fails with 400; use publish_draft to publish now | |
| workspaceId | No | Workspace to act in: an id from list_workspaces. Omit to act in the workspace list_workspaces marks current. Use the same workspaceId for every call about the same workspace, since ids from one workspace (accounts, posts, uploads) do not exist in another | |
| thumbnailUrl | No | Video thumbnail as an https URL or an image data URI, used on every platform that takes one unless platformThumbnails overrides it | |
| firstComments | No | A comment posted from the same account shortly after the post goes out on a platform, one entry per platform. Available on LINKEDIN (1250 characters), TWITTER (280, as a reply), THREADS (500, as a reply), BLUESKY (300, as a reply), MASTODON (500, as a reply), YOUTUBE (10000), FACEBOOK (8000) and INSTAGRAM (2200). A platform the post does not go to, an empty or too long comment, a second entry for one platform, a platform that also has threadReplies, a private or made for kids YouTube video and Facebook or Instagram stories are refused with 400. The comment goes out within about a minute of the platform publishing (about two minutes on YouTube), or within about a minute of delayMinutes after it when the entry sets one, and is retried up to 3 times; on X it is not retried, and a lifetime-deal account pays for it like any X post. A Facebook Page or Instagram account connected before first comments came to them must be reconnected once; until then its comment fails and firstCommentError says to reconnect. A comment that fails never fails the post: read firstCommentStatus and firstCommentError on the platform in get_post. On an update, sending the array replaces every first comment and omitting it keeps the stored ones | |
| mediaAltTexts | No | Alt text per image, in the same order as mediaUrls (use "" to skip an image). Sent to X, Bluesky, Mastodon, Tumblr, WordPress, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube, Google Business Profile and videos ignore it. Applied only when platforms is also sent | |
| platformMedia | No | Different media for one platform, for when the post media does not fit it (a video too long for TikTok, a carousel with more images than X takes), one entry per platform. A platform without an entry uses the post mediaUrls. The entry must match the post contentType: one video for VIDEO, one image for IMAGE, one document for DOCUMENT, two or more items for CAROUSEL; TEXT posts take none. Each entry is checked against its own platform's limits only, and the post mediaUrls is no longer checked against that platform. An entry for a platform the post does not go to, an empty mediaUrls, a data URI, a second entry for one platform and media of another type are refused with 400. An overridden platform does not use the post-level thumbnailUrl or thumbnailTimestampMs; give it its own through platformThumbnails. On an update, sending the array replaces every override, [] clears them all and omitting it keeps the stored ones; it takes effect even without platforms. get_post shows an override as mediaOverrideUrls and mediaOverrideAltTexts on that platform | |
| platformTexts | No | Per-platform caption overrides; applied to the targets sent in platforms | |
| threadReplies | No | Turns the post into a thread: the post opens it and each text is published as a reply to the one before, from the same account, one entry per platform. A reply can carry up to 4 images (JPEG, PNG, GIF or WEBP) through mediaUrls, adapted to the platform like the post's own images; a reply with images may leave its text empty. Available on TWITTER (280 characters per reply, or the account's own limit on X Premium), THREADS (500), BLUESKY (300) and MASTODON (500, or the instance's limit), up to 25 replies. A platform the post does not go to, a reply with neither text nor images, a too long reply, more than 25 replies, more than 4 images or a video on a reply, a second entry for one platform and a platform that also has a first comment are refused with 400. An entry with an empty texts array removes the thread. Replies start about 10 seconds after the platform publishes, 2 seconds apart. A failed run is retried up to 3 times and resumes after the last reply that went out; on X it is not retried, and a lifetime-deal account pays for each reply like any X post. A thread that fails never fails the post: read threadStatus, threadReplyIds and threadError on the platform in get_post. On an update, sending the array replaces every thread and omitting it keeps the stored ones | |
| tiktokConfigs | No | TikTok per-connection config. Each entry needs connectionId + privacyLevel at minimum | |
| tumblrConfigs | No | Tumblr per-blog config: tags, a title and a source link. connectionId must match an entry in tumblrConnectionIds | |
| twitterConfigs | No | X per-connection config: quoteOf quotes one of the account's own posts with the text as commentary. connectionId must match an entry in twitterConnectionIds | |
| youtubeConfigs | No | YouTube per-connection config with video title, tags, privacy, etc. | |
| facebookConfigs | No | Facebook per-page config: post type, shareToStory, video title, text background, a grid or link carousel for several images, and the AI info label. pageId must match an entry in pageIds | |
| linkedinConfigs | No | LinkedIn per-connection config: documentTitle names a DOCUMENT post, reshareOf reshares another LinkedIn post with the text as commentary. connectionId must match an entry in linkedinConnectionIds | |
| instagramConfigs | No | Instagram per-connection config: post type (FEED, REEL, STORY), shareToStory, collaborators, user tags, the AI info label, Reel audio, and trial reels | |
| pinterestConfigs | No | Pinterest per-connection config: the board to pin to, a pin title and a destination link. Get boardId from list_pinterest_boards for that connectionId, or pass the board name as boardName instead (not both); a board belongs to one Pinterest account. A boardName that matches no board or several fails with 400. Without either the pin goes to a board named AdaptlyPost | |
| twitterKeepLinks | No | Keep links in the X text clickable. X charges over 10 times more for a post with a link, so by default every link in X text is broken (example.com becomes example. com). Only AppSumo lifetime deals can turn this on, and a kept link costs 20 credits instead of 2. true on any other plan is refused with 400; it is ignored when the X text has no link | |
| wordpressConfigs | No | WordPress per-site config: title, excerpt, categories, tags and status (publish, leave a draft or submit for review). connectionId must match an entry in wordpressConnectionIds | |
| platformThumbnails | No | A different thumbnail for one platform of a VIDEO post, one entry per platform. A platform without an entry uses the post-level thumbnailUrl and thumbnailTimestampMs. YOUTUBE, FACEBOOK, INSTAGRAM, LINKEDIN, PINTEREST and TELEGRAM take an image (thumbnailUrl) or a frame (thumbnailTimestampMs), the image winning when both are sent; TIKTOK takes only a frame. Posts that are not videos, Facebook and Instagram stories, a second entry for one platform and an entry the platform cannot use are refused with 400. On an update, sending the array replaces every override and omitting it keeps the stored ones | |
| tiktokConnectionIds | No | TikTok account connection IDs to post from | |
| tumblrConnectionIds | No | Tumblr blogs to post to, by the account id from list_accounts. TUMBLR takes text up to 32768 characters, up to 30 JPEG, PNG or GIF images (10 MB each) or one MP4 video (500 MB, up to 10 minutes), and alt text; it has no first comments, threads, per-platform thumbnails, image shapes or analytics | |
| blueskyConnectionIds | No | Bluesky account connection IDs to post from | |
| platformAspectRatios | No | Reframe every image of an IMAGE or CAROUSEL post to one shape on a platform, one entry per platform. INSTAGRAM takes SQUARE, PORTRAIT or LANDSCAPE (Instagram refuses 9:16 feed and carousel images); TIKTOK takes all four. Video posts, Instagram stories and a second entry for the same platform are refused with 400. Omit a platform to keep its images as uploaded. On an update it applies to the mediaUrls sent in the same request | |
| threadsConnectionIds | No | Threads account connection IDs to post from | |
| thumbnailTimestampMs | No | Video frame timestamp (ms) to use as the thumbnail on every platform that takes one: YOUTUBE, FACEBOOK, INSTAGRAM, LINKEDIN, PINTEREST, TELEGRAM and TIKTOK. A thumbnailUrl sent with it wins everywhere except TIKTOK, which takes only a frame, and platformThumbnails overrides both | |
| twitterConnectionIds | No | X (Twitter) account connection IDs to post from | |
| youtubeConnectionIds | No | YouTube channel connection IDs to post from | |
| googleBusinessConfigs | No | Google Business Profile per-location config: update, event or offer, plus a button. connectionId must match an entry in googleBusinessConnectionIds. GOOGLE_BUSINESS takes TEXT or IMAGE with one JPEG or PNG image up to 5 MB, and text up to 1500 characters | |
| linkedinConnectionIds | No | LinkedIn account connection IDs to post from | |
| mastodonConnectionIds | No | Mastodon account connection IDs to post from | |
| telegramConnectionIds | No | Telegram channels and groups to post to, by the account id from list_accounts. TELEGRAM takes text up to 4096 characters, up to 10 images (JPEG, PNG or WebP, 10 MB each) or one MP4 or MOV video (50 MB); a caption over 1024 characters goes out as its own message after the media | |
| instagramConnectionIds | No | Instagram account connection IDs to post from | |
| pinterestConnectionIds | No | Pinterest account connection IDs to post from | |
| wordpressConnectionIds | No | WordPress sites to post to, by the account id from list_accounts. WORDPRESS publishes the text as the body of a blog post, up to 100,000 characters: blank lines start new paragraphs and bare links become clickable. It takes up to 20 JPEG, PNG, WebP or GIF images (20 MB each) or one MP4 or MOV video (500 MB); the first image is the featured image and the other images or the video follow the text. A site without an entry in wordpressConfigs uses the first line of the text as the title. WordPress has no first comments, threads, thumbnails, image shapes or analytics | |
| googleBusinessConnectionIds | No | Google Business Profile locations to post to, by the account id from list_accounts. A location without an entry in googleBusinessConfigs gets a STANDARD update |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | The updated post record: id, status (DRAFT or SCHEDULED; a FAILED post comes back as DRAFT), text, contentType, scheduledAt, timezone, and platforms with per-target details. |