update_post
Edit a draft, pending, or approval-waiting scheduled post's content, media, tags, or platform settings before publishing. Cannot edit once posting or done; use reschedule to change time.
Instructions
Edit a draft, a post waiting for approval, or a still-pending post: its text, media, tags, options and so on. Not possible once it is posting or done. To change the time, use reschedule_post.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The post id, from list_scheduled_posts | |
| tags | No | Up to 5 short labels for filtering analytics by campaign | |
| boardId | No | Pinterest only: the board to pin to. Get it from list_pinterest_boards | |
| content | No | New text | |
| options | No | Platform-specific settings for the account you post to: tiktok {aiGenerated}; youtube {title, privacy public|unlisted|private, madeForKids, tags[], aiGenerated}; instagram {placement feed|reel|story, trialReel, trialGraduation manual|auto}; facebook {placement feed|story}; linkedin {documentUrl (https PDF), documentTitle}; threads, bluesky, mastodon and x {chain: [follow-up texts]} for a thread. Send only the key that belongs to the account's platform. | |
| mediaUrl | No | A publicly accessible image or video URL to attach | |
| mediaUrls | No | Extra images after mediaUrl for a multi-image post. Call get_platform_rules for how many the platform takes | |
| firstComment | No | A first comment posted right after publishing (Facebook and Instagram only) | |
| mediaAltText | No | Accessibility description of the main image (Mastodon and Bluesky use it) | |
| coverImageUrl | No | A still cover image for a video (Pinterest video pins need one) | |
| selfReplyText | No | A follow-up comment added once the post reaches selfReplyAtLikes likes (Facebook and Instagram only) | |
| destinationLink | No | Pinterest only: where a click on the pin goes | |
| selfReplyAtLikes | No | The like count that triggers selfReplyText | |
| tiktokDisableDuet | No | TikTok only: turn duets off (default true) | |
| tiktokBrandContent | No | TikTok only: the video is a paid partnership | |
| tiktokBrandOrganic | No | TikTok only: the video promotes the creator's own brand | |
| tiktokPrivacyLevel | No | TikTok only, REQUIRED for TikTok: call get_tiktok_creator_info to see which levels the account allows | |
| tiktokDisableStitch | No | TikTok only: turn stitches off (default true) | |
| tiktokDisableComment | No | TikTok only: turn comments off (default true, comments off) | |
| firstCommentDelayMinutes | No | Wait this many minutes after the post goes live before posting firstComment (0 to 1440, Facebook and Instagram only). 0 or left out posts it right away. Needs firstComment |