Skip to main content
Glama
Hermoso

Hermoso

Official

Change a scheduled post

reschedule_post
DestructiveIdempotent

Edit 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

NameRequiredDescriptionDefault
atNothe 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.
idYesthe scheduled post id from list_scheduled
linkNodestination URL for a Pinterest Pin, Facebook text post or Google Business post
pollNoX — replaces the poll; an empty options list removes it.
tagsNoYOUTUBE — replaces the WHOLE tag list; an empty array [] clears the tags.
brandNoWHICH 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.
eventNoGOOGLE BUSINESS — replaces the whole event record {title, startDate, startTime, endDate, endTime}.
offerNoGOOGLE BUSINESS — replaces the whole offer record {couponCode, redeemOnlineUrl, termsConditions}.
placeNoFACEBOOK — replaces the tagged place (the numeric id of its Facebook Page); an empty string removes it.
storyNoINSTAGRAM — true makes it a 24-hour Story, false an ordinary feed post. One image or one video, no carousel.
titleNoPINTEREST / YOUTUBE — replace the headline; "" clears it and goes back to deriving one from the caption
chatIdNoTELEGRAM — 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.
ideaIdNoshort id of the content-plan idea this post came from
pageIdNoFACEBOOK / INSTAGRAM / THREADS — publish from a different connected Page (list_meta_pages)
recipeNothe post's FORMAT id, e.g. "slideshow" or "imessage_chat" — post_performance groups by it, so reuse one id per format
silentNoTELEGRAM / DISCORD — no notification.
threadNoX — replaces the WHOLE thread; an explicit [] drops back to a single post using the caption.
wpSlugNoWORDPRESS — the post slug
wpTagsNoWORDPRESS — tags (names or ids)
altTextNoACCESSIBILITY — 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.
audioIdNoINSTAGRAM 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.
boardIdNoPINTEREST — move the Pin to a different board (list_pinterest_boards)
buttonsNoTELEGRAM ONLY — replace the URL buttons ([] removes them).
excerptNoBLOG — the excerpt under the title
messageNoreplace the caption used for every channel that has no override
audienceNoFACEBOOK — replaces who can see the Page post {countries, regions, cities, minAge}; {} removes the limit.
blogSlugNoblog post slug
blogTagsNoShopify blog / Wix tags
captionsNoreplaces the WHOLE per-channel caption map — send every override you want to keep, not just the new one
channelsNoreplaces the channel list
coverUrlNoINSTAGRAM REEL — replaces the cover image url; an empty string removes it.
imageUrlNoswap the image; "" removes it
linkNameNoFACEBOOK — replaces the link preview headline; an empty string removes the override.
seoTitleNoblog search title
timezoneNoIANA zone for a wall-clock `at`
topicTagNoTHREADS ONLY — one topic tag, without the leading #.
userTagsNoINSTAGRAM 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).
videoUrlNoswap the video; "" removes it
whopPollNoWHOP: poll options, 2 to 10
xArticleNoX: replaces the X Article (title, headings); {} makes it an ordinary X post again.
audioNameNoINSTAGRAM REEL — replaces the audio track name; an empty string removes it.
coverAtMsNoTHE VIDEO COVER on every channel, as one frame in milliseconds (see schedule_post).
imageUrlsNoreplace 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.
parseModeNoTELEGRAM ONLY — 'HTML' for Telegram's HTML tags.
placeNameNothe name the user saw for that place; a different business is refused
slideTextNoPINTEREST CAROUSEL ONLY — per-slide title / description / link, aligned to slide order.
topicTypeNoGOOGLE BUSINESS — the kind of Post; EVENT and OFFER both require `event`.
trialReelNoINSTAGRAM — 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.
yourBrandNoTIKTOK — the own-brand disclosure; false turns it off.
actionTypeNoGOOGLE BUSINESS — the call-to-action button; "" clears it.
categoryIdNoYOUTUBE: NUMERIC category id; "" goes back to the default (22).
locationIdNoGOOGLE BUSINESS — a different listing (list_business_locations)
madeWithAiNoX — the AI-media label; false turns it off.
threadNameNoDISCORD: forum thread title
threadsGifNoTHREADS 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.
visibilityNoNOTE: changing this without also naming visibilityByChannel clears any per-channel overrides, so "make it all draft" is not a no-op
whopPinnedNoWHOP: pin the forum post
aiGeneratedNoAI-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.
audioVolumeNoINSTAGRAM REEL — how loud that track plays, 0–100 (Instagram’s default 100). Needs audioId.
communityIdNoX — the community to publish into; an empty string goes back to the main timeline.
descriptionNoYOUTUBE — replace the video description; "" clears it and the caption is used.
disableDuetNoTIKTOK VIDEO ONLY — block Duets.
linkPictureNoFACEBOOK — replaces the link preview image url; an empty string removes the override.
madeForKidsNoYOUTUBE: made-for-kids declaration.
quotePostIdNoTHREADS ONLY — the id of the Threads post this one quotes.
shareToFeedNoINSTAGRAM REEL — whether the Reel also shows in the Feed grid.
shopifyBlogNowhich Shopify blog
thumbOffsetNoINSTAGRAM REEL — replaces the cover frame, in milliseconds; 0 removes it. Never together with coverUrl.
videoVolumeNoINSTAGRAM REEL — how loud the video’s own sound plays under the track, 0–100 (Instagram’s default 100; 0 = the track alone). Needs audioId.
whopMentionNoWHOP: notify every member
brandPartnerNoYOUTUBE: sponsoring brand channel (UC… or @handle); "" removes it
callToActionNoFACEBOOK — replaces the button on the Page post; "" removes it.
captionTrackNoYOUTUBE: replace the queued caption track (url OR text, plus language).
countryCodesNoTHREADS ONLY — two-letter country codes limiting who can see the post.
firstCommentNoFIRST 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.
optimizeCopyNofit 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.
privacyLevelNoTIKTOK — 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.
replyControlNoTHREADS ONLY — who may reply.
slackChannelNoSLACK app: channel id or #name (default: the brand's)
thumbnailUrlNoYOUTUBE: replace the custom thumbnail; "" goes back to a frame of the video, "auto" to YouTube’s pick.
wpCategoriesNoWORDPRESS — categories (names or ids)
xQuotePostIdNoX — the post this one QUOTES; an empty string removes the quote. Named apart from the Threads `quotePostId` on this same schedule.
collaboratorsNoINSTAGRAM — 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.
coverImageUrlNoTHE VIDEO COVER on every channel, as a Hermoso-hosted picture (see schedule_post).
disableStitchNoTIKTOK VIDEO ONLY — block Stitches.
discordExtrasNoDISCORD: {embeds, poll, tts, crosspost}
discordServerNoDISCORD bot: which server
instagramPollNoINSTAGRAM — 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.
platformCoverNoVIDEO 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.
replySettingsNoX — who may reply; "" goes back to everyone.
slackThreadTsNoSLACK app: reply in this thread (parent ts)
webflowFieldsNoWEBFLOW: required collection fields by slug, e.g. {author:"<item id>"}
brandedContentNoTIKTOK — the paid-partnership disclosure; false turns it off.
channelOptionsNorare 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
disableCommentNoTIKTOK — comments off on this post.
disablePreviewNoTELEGRAM ONLY — no link preview.
discordChannelNoDISCORD bot: channel id or #name (default: the brand's)
discordReplyToNoDISCORD bot: reply to this message id
linkAttachmentNoTHREADS 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.
seoDescriptionNoblog search description
slackWorkspaceNoSLACK app: which workspace
targetAudienceNoLINKEDIN COMPANY PAGE — replaces who sees the post; {} removes the limit. The matching audience must be over 300 followers.
whopVisibilityNoWHOP: who can see the forum post
discordMentionsNoDISCORD: let mentions ping
linkDescriptionNoFACEBOOK — replaces the link preview description; an empty string removes the override.
paidPartnershipNoINSTAGRAM AND X — the paid-partnership label; false turns it off.
threadsLongTextNoTHREADS 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.
callToActionLinkNoFACEBOOK — replaces where the button goes; an empty string falls back to the post link.
coverTimestampMsNoTIKTOK VIDEO ONLY — cover frame in milliseconds.
crossreshareToIgNoTHREADS ONLY — also share to Instagram as a Story when it fires; false turns it off. Refused on a carousel.
threadsGhostPostNoTHREADS 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.
whopExperienceIdNoWHOP — move it to a different forum or chat (exp_…, from list_whop_destinations).
whopPaywallCentsNoWHOP: forum-post paywall in cents (needs a title)
commercialContentNoTIKTOK — 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.
notifySubscribersNoYOUTUBE: notify subscribers when it goes live.
discordStartThreadNoDISCORD bot: open a thread under the post, this title
instagramLocationIdNoINSTAGRAM — replaces the tagged place (the numeric id of its Facebook Page); an empty string removes it. Not locationId, which is the Google Business listing.
visibilityByChannelNoper-channel visibility override, e.g. {tiktok: draft}; values public, unlisted, private or draft
whopPaywallCurrencyNoWHOP: paywall currency
crossreshareDarkModeNoTHREADS ONLY — dark-mode that Instagram Story. Needs crossreshareToIg.
paidProductPlacementNoYOUTUBE: paid product placement (shows the disclosure) — false removes it
instagramPollExtendedNoINSTAGRAM — 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.
instagramCommentPromptNoINSTAGRAM — make the caption a COMMENT PROMPT that people answer in the comments. Same limits as instagramPoll, and never together with it.
linkedinOrganizationIdNoLINKEDIN — target a different company Page, or "" to post as the connected person instead
brandedContentSponsorIdsNoINSTAGRAM — replaces the sponsor user ids behind the paid-partnership label (at most 2); [] removes them.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed10 schema fields changedv0.1.571
    • addedInput schema / properties / blogSlug
      Added value: +{
      +  "description": "blog post slug",
      +  "type": "string"
      +}
    • addedInput schema / properties / blogTags
      Added value: +{
      +  "description": "Shopify blog / Wix tags",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / channelOptions
      Added value: +{
      +  "additionalProperties": {},
      +  "description": "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",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • changedInput schema / properties / channels / items / enum
      Previous value: -[
      -  "facebook",
      -  "instagram",
      -  "threads",
      -  "tiktok",
      -  "youtube",
      -  "linkedin",
      -  "x",
      -  "pinterest",
      -  "google_business",
      -  "bluesky",
      -  "telegram",
      -  "wordpress",
      -  "discord",
      -  "slack",
      -  "whop"
      -]New value: +[
      +  "facebook",
      +  "instagram",
      +  "threads",
      +  "tiktok",
      +  "youtube",
      +  "linkedin",
      +  "x",
      +  "pinterest",
      +  "google_business",
      +  "bluesky",
      +  "telegram",
      +  "wordpress",
      +  "discord",
      +  "slack",
      +  "whop",
      +  "shopify_blog",
      +  "webflow",
      +  "wix"
      +]
    • addedInput schema / properties / discordExtras
      Added value: +{
      +  "description": "DISCORD: {embeds, poll, tts, crosspost}"
      +}
    • changedInput schema / properties / excerpt / description
      Previous value: -"WORDPRESS — the excerpt under the title"New value: +"BLOG — the excerpt under the title"
    • addedInput schema / properties / seoDescription
      Added value: +{
      +  "description": "blog search description",
      +  "type": "string"
      +}
    • addedInput schema / properties / seoTitle
      Added value: +{
      +  "description": "blog search title",
      +  "type": "string"
      +}
    • addedInput schema / properties / shopifyBlog
      Added value: +{
      +  "description": "which Shopify blog",
      +  "type": "string"
      +}
    • addedInput schema / properties / webflowFields
      Added value: +{
      +  "additionalProperties": {},
      +  "description": "WEBFLOW: required collection fields by slug, e.g. {author:\"<item id>\"}",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
  2. Changed4 schema fields changedv0.1.532
    • addedInput schema / properties / captionTrack
      Added value: +{
      +  "description": "YOUTUBE: replace the queued caption track (url OR text, plus language).",
      +  "properties": {
      +    "language": {
      +      "type": "string"
      +    },
      +    "name": {
      +      "type": "string"
      +    },
      +    "text": {
      +      "type": "string"
      +    },
      +    "url": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "language"
      +  ],
      +  "type": "object"
      +}
    • addedInput schema / properties / categoryId
      Added value: +{
      +  "description": "YOUTUBE: NUMERIC category id; \"\" goes back to the default (22).",
      +  "type": "string"
      +}
    • addedInput schema / properties / madeForKids
      Added value: +{
      +  "description": "YOUTUBE: made-for-kids declaration.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / notifySubscribers
      Added value: +{
      +  "description": "YOUTUBE: notify subscribers when it goes live.",
      +  "type": "boolean"
      +}
  3. Changed22 schema fields changedv0.1.519
    • changedInput schema / properties / channels / items / enum
      Previous value: -[
      -  "facebook",
      -  "instagram",
      -  "threads",
      -  "tiktok",
      -  "youtube",
      -  "linkedin",
      -  "x",
      -  "pinterest",
      -  "google_business",
      -  "bluesky",
      -  "telegram"
      -]New value: +[
      +  "facebook",
      +  "instagram",
      +  "threads",
      +  "tiktok",
      +  "youtube",
      +  "linkedin",
      +  "x",
      +  "pinterest",
      +  "google_business",
      +  "bluesky",
      +  "telegram",
      +  "wordpress",
      +  "discord",
      +  "slack",
      +  "whop"
      +]
    • addedInput schema / properties / discordChannel
      Added value: +{
      +  "description": "DISCORD bot: channel id or #name (default: the brand's)",
      +  "type": "string"
      +}
    • addedInput schema / properties / discordMentions
      Added value: +{
      +  "description": "DISCORD: let mentions ping",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / discordReplyTo
      Added value: +{
      +  "description": "DISCORD bot: reply to this message id",
      +  "type": "string"
      +}
    • addedInput schema / properties / discordServer
      Added value: +{
      +  "description": "DISCORD bot: which server",
      +  "type": "string"
      +}
    • addedInput schema / properties / discordStartThread
      Added value: +{
      +  "description": "DISCORD bot: open a thread under the post, this title",
      +  "type": "string"
      +}
    • addedInput schema / properties / excerpt
      Added value: +{
      +  "description": "WORDPRESS — the excerpt under the title",
      +  "type": "string"
      +}
    • changedInput schema / properties / silent / description
      Previous value: -"TELEGRAM ONLY — no notification sound."New value: +"TELEGRAM / DISCORD — no notification."
    • addedInput schema / properties / slackChannel
      Added value: +{
      +  "description": "SLACK app: channel id or #name (default: the brand's)",
      +  "type": "string"
      +}
    • addedInput schema / properties / slackThreadTs
      Added value: +{
      +  "description": "SLACK app: reply in this thread (parent ts)",
      +  "type": "string"
      +}
    • addedInput schema / properties / slackWorkspace
      Added value: +{
      +  "description": "SLACK app: which workspace",
      +  "type": "string"
      +}
    • addedInput schema / properties / threadName
      Added value: +{
      +  "description": "DISCORD: forum thread title",
      +  "type": "string"
      +}
    • addedInput schema / properties / whopExperienceId
      Added value: +{
      +  "description": "WHOP — move it to a different forum or chat (exp_…, from list_whop_destinations).",
      +  "type": "string"
      +}
    • addedInput schema / properties / whopMention
      Added value: +{
      +  "description": "WHOP: notify every member",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / whopPaywallCents
      Added value: +{
      +  "description": "WHOP: forum-post paywall in cents (needs a title)",
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • addedInput schema / properties / whopPaywallCurrency
      Added value: +{
      +  "description": "WHOP: paywall currency",
      +  "type": "string"
      +}
    • addedInput schema / properties / whopPinned
      Added value: +{
      +  "description": "WHOP: pin the forum post",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / whopPoll
      Added value: +{
      +  "description": "WHOP: poll options, 2 to 10",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / whopVisibility
      Added value: +{
      +  "description": "WHOP: who can see the forum post",
      +  "enum": [
      +    "members_only",
      +    "globally_visible"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / wpCategories
      Added value: +{
      +  "description": "WORDPRESS — categories (names or ids)",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / wpSlug
      Added value: +{
      +  "description": "WORDPRESS — the post slug",
      +  "type": "string"
      +}
    • addedInput schema / properties / wpTags
      Added value: +{
      +  "description": "WORDPRESS — tags (names or ids)",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
  4. Changed4 schema fields changedv0.1.484
    • changedInput schema / properties / aiGenerated / description
      Previous value: -"AI-CONTENT DISCLOSURE (Instagram / Facebook Reel is_ai_generated, TikTok is_aigc, YouTube containsSyntheticMedia, Pinterest ai_disclosures). 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."New value: +"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."
    • addedInput schema / properties / brandPartner
      Added value: +{
      +  "description": "YOUTUBE: sponsoring brand channel (UC… or @handle); \"\" removes it",
      +  "type": "string"
      +}
    • addedInput schema / properties / paidProductPlacement
      Added value: +{
      +  "description": "YOUTUBE: paid product placement (shows the disclosure) — false removes it",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / placeName
      Added value: +{
      +  "description": "the name the user saw for that place; a different business is refused",
      +  "type": "string"
      +}
  5. Changed39 schema fields changedv0.1.465
    • changedInput schema / properties / aiGenerated / description
      Previous value: -"AI-CONTENT DISCLOSURE (Instagram / Facebook Reel is_ai_generated, TikTok is_aigc, YouTube containsSyntheticMedia). 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."New value: +"AI-CONTENT DISCLOSURE (Instagram / Facebook Reel is_ai_generated, TikTok is_aigc, YouTube containsSyntheticMedia, Pinterest ai_disclosures). 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."
    • addedInput schema / properties / audience / properties / cities / description
      Added value: +"Facebook Page post audience: Meta numeric city keys (the ads location search returns them)"
    • addedInput schema / properties / audience / properties / countries / description
      Added value: +"Facebook Page post audience: two-letter country codes, e.g. CA, US"
    • addedInput schema / properties / audience / properties / minAge / description
      Added value: +"Facebook Page post audience: minimum age, one of 13, 15, 18, 21 or 25"
    • addedInput schema / properties / audience / properties / regions / description
      Added value: +"Facebook Page post audience: Meta numeric region keys (the ads location search returns them)"
    • addedInput schema / properties / buttons
      Added value: +{
      +  "description": "TELEGRAM ONLY — replace the URL buttons ([] removes them).",
      +  "items": {
      +    "anyOf": [
      +      {
      +        "properties": {
      +          "style": {
      +            "enum": [
      +              "danger",
      +              "success",
      +              "primary"
      +            ],
      +            "type": "string"
      +          },
      +          "text": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "text",
      +          "url"
      +        ],
      +        "type": "object"
      +      },
      +      {
      +        "items": {
      +          "properties": {
      +            "style": {
      +              "enum": [
      +                "danger",
      +                "success",
      +                "primary"
      +              ],
      +              "type": "string"
      +            },
      +            "text": {
      +              "type": "string"
      +            },
      +            "url": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "text",
      +            "url"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      }
      +    ]
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / disablePreview
      Added value: +{
      +  "description": "TELEGRAM ONLY — no link preview.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / event / properties / endDate / description
      Added value: +"event end date, e.g. 2026-11-01"
    • addedInput schema / properties / event / properties / endTime / description
      Added value: +"event end time, e.g. 20:00"
    • addedInput schema / properties / event / properties / startDate / description
      Added value: +"event start date, e.g. 2026-11-01"
    • addedInput schema / properties / event / properties / startTime / description
      Added value: +"event start time, e.g. 18:00"
    • addedInput schema / properties / event / properties / title / description
      Added value: +"Google Business event title; required for an event or offer post"
    • addedInput schema / properties / firstComment
      Added value: +{
      +  "description": "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.",
      +  "type": "string"
      +}
    • addedInput schema / properties / link / description
      Added value: +"destination URL for a Pinterest Pin, Facebook text post or Google Business post"
    • addedInput schema / properties / offer / properties / couponCode / description
      Added value: +"Google Business offer coupon code"
    • addedInput schema / properties / offer / properties / redeemOnlineUrl / description
      Added value: +"link where the offer is redeemed online"
    • addedInput schema / properties / offer / properties / termsConditions / description
      Added value: +"terms text shown with the offer"
    • addedInput schema / properties / parseMode
      Added value: +{
      +  "description": "TELEGRAM ONLY — 'HTML' for Telegram's HTML tags.",
      +  "enum": [
      +    "HTML"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / poll / properties / durationMinutes / description
      Added value: +"X poll length in minutes, 5 to 10080; default 1440 (one day)"
    • addedInput schema / properties / poll / properties / options / description
      Added value: +"X poll choices: 2 to 4 options, max 25 characters each"
    • addedInput schema / properties / silent
      Added value: +{
      +  "description": "TELEGRAM ONLY — no notification sound.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / slideText / items / properties / description / description
      Added value: +"Pinterest carousel slide: description for this slide"
    • addedInput schema / properties / slideText / items / properties / link / description
      Added value: +"Pinterest carousel slide: destination URL for this slide"
    • addedInput schema / properties / slideText / items / properties / title / description
      Added value: +"Pinterest carousel slide: title for this slide"
    • addedInput schema / properties / targetAudience / properties / degrees / description
      Added value: +"LinkedIn degree facet: numeric id or urn:li:degree value from search_linkedin_ads_targeting"
    • addedInput schema / properties / targetAudience / properties / fieldsOfStudy / description
      Added value: +"LinkedIn field of study facet: numeric id or urn:li:fieldOfStudy value from search_linkedin_ads_targeting"
    • addedInput schema / properties / targetAudience / properties / geoLocations / description
      Added value: +"LinkedIn geo facet: numeric id or urn:li:geo value from search_linkedin_ads_targeting"
    • addedInput schema / properties / targetAudience / properties / industries / description
      Added value: +"LinkedIn industry facet: numeric id or urn:li:industry value from search_linkedin_ads_targeting"
    • addedInput schema / properties / targetAudience / properties / jobFunctions / description
      Added value: +"LinkedIn job function facet: numeric id or urn:li:function value from search_linkedin_ads_targeting"
    • addedInput schema / properties / targetAudience / properties / organizations / description
      Added value: +"LinkedIn school or organization facet: numeric id or urn:li:organization value from search_linkedin_ads_targeting"
    • addedInput schema / properties / targetAudience / properties / seniorities / description
      Added value: +"LinkedIn seniority facet: numeric id or urn:li:seniority value from search_linkedin_ads_targeting"
    • addedInput schema / properties / targetAudience / properties / staffCountRanges / description
      Added value: +"LinkedIn company size bands, e.g. SIZE_11_TO_50"
    • addedInput schema / properties / threadsGhostPost
      Added value: +{
      +  "description": "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.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / threadsGif
      Added value: +{
      +  "description": "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.",
      +  "type": "string"
      +}
    • addedInput schema / properties / threadsLongText
      Added value: +{
      +  "description": "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.",
      +  "type": "string"
      +}
    • addedInput schema / properties / userTags
      Added value: +{
      +  "description": "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).",
      +  "items": {
      +    "anyOf": [
      +      {
      +        "type": "string"
      +      },
      +      {
      +        "properties": {
      +          "username": {
      +            "type": "string"
      +          },
      +          "x": {
      +            "maximum": 1,
      +            "minimum": 0,
      +            "type": "number"
      +          },
      +          "y": {
      +            "maximum": 1,
      +            "minimum": 0,
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "username"
      +        ],
      +        "type": "object"
      +      }
      +    ]
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / visibilityByChannel / description
      Added value: +"per-channel visibility override, e.g. {tiktok: draft}; values public, unlisted, private or draft"
    • addedInput schema / properties / xArticle / properties / headings / description
      Added value: +"blocks (default) keeps real headings; text turns headings into bold lines"
    • addedInput schema / properties / xArticle / properties / title / description
      Added value: +"X Article headline; the post text becomes the article body in markdown"
  6. Changed2 schema fields changedv0.1.454
    • changedInput schema / properties / at / description
      Previous value: -"the new time — ISO timestamp (2026-08-05T09:00:00Z) or epoch milliseconds. Must be in the future, at most 365 days out."New value: +"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."
    • addedInput schema / properties / timezone
      Added value: +{
      +  "description": "IANA zone for a wall-clock `at`",
      +  "type": "string"
      +}
  7. Changed1 schema field changedv0.1.374
    • changedInput schema / properties / brand / description
      Previous value: -"WHICH BRAND this post is in — id or exact name from list_brands; needed when it is not the brand this connection is pinned to. A name that matches no brand, or two, is REFUSED."New value: +"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."
  8. Changed3 schema fields changedv0.1.372
    • addedInput schema / properties / instagramCommentPrompt
      Added value: +{
      +  "description": "INSTAGRAM — make the caption a COMMENT PROMPT that people answer in the comments. Same limits as instagramPoll, and never together with it.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / instagramPoll
      Added value: +{
      +  "description": "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.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / instagramPollExtended
      Added value: +{
      +  "description": "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.",
      +  "type": "boolean"
      +}
  9. Changed1 schema field changedv0.1.371
    • changedInput schema / properties / aiGenerated / description
      Previous value: -"INSTAGRAM / FACEBOOK REEL — Meta’s is_ai_generated self-disclosure. OMIT IT and Hermoso decides from provenance: a Hermoso render is declared, media that came through upload_file or from an external URL (the user’s own photographs or footage) is NOT — a real photo must never carry Instagram’s “AI info” label. Pass true or false only to override: false strips the label from something Hermoso would otherwise declare, true declares a render the user uploaded themselves."New value: +"AI-CONTENT DISCLOSURE (Instagram / Facebook Reel is_ai_generated, TikTok is_aigc, YouTube containsSyntheticMedia). 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."
  10. Changed6 schema fields changedv0.1.320
    • addedInput schema / properties / audioId
      Added value: +{
      +  "description": "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.",
      +  "type": "string"
      +}
    • addedInput schema / properties / audioVolume
      Added value: +{
      +  "description": "INSTAGRAM REEL — how loud that track plays, 0–100 (Instagram’s default 100). Needs audioId.",
      +  "maximum": 100,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • changedInput schema / properties / brand / description
      Previous value: -"WHICH BRAND this post is in — the id or exact name from list_brands. Needed when the post lives in a brand this connection is not pinned to: a post you can CREATE in a brand must be manageable there too, without switching the whole connection. A name that matches no brand, or two, is REFUSED."New value: +"WHICH BRAND this post is in — id or exact name from list_brands; needed when it is not the brand this connection is pinned to. A name that matches no brand, or two, is REFUSED."
    • addedInput schema / properties / coverAtMs
      Added value: +{
      +  "description": "THE VIDEO COVER on every channel, as one frame in milliseconds (see schedule_post).",
      +  "type": "number"
      +}
    • addedInput schema / properties / coverImageUrl
      Added value: +{
      +  "description": "THE VIDEO COVER on every channel, as a Hermoso-hosted picture (see schedule_post).",
      +  "type": "string"
      +}
    • addedInput schema / properties / videoVolume
      Added value: +{
      +  "description": "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.",
      +  "maximum": 100,
      +  "minimum": 0,
      +  "type": "integer"
      +}
  11. Changed2 schema fields changedv0.1.281
    • addedInput schema / properties / ideaId
      Added value: +{
      +  "description": "short id of the content-plan idea this post came from",
      +  "type": "string"
      +}
    • addedInput schema / properties / recipe
      Added value: +{
      +  "description": "the post's FORMAT id, e.g. \"slideshow\" or \"imessage_chat\" — post_performance groups by it, so reuse one id per format",
      +  "type": "string"
      +}
  12. Changed1 schema field changedv0.1.272
    • changedInput schema / properties / privacyLevel / description
      Previous value: -"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."New value: +"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."
  13. Changed1 schema field changedv0.1.256
    • addedInput schema / properties / platformCover
      Added value: +{
      +  "description": "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.",
      +  "type": "boolean"
      +}
  14. Changed17 schema fields changedv0.1.251
    • addedInput schema / properties / audience
      Added value: +{
      +  "description": "FACEBOOK — replaces who can see the Page post {countries, regions, cities, minAge}; {} removes the limit.",
      +  "properties": {
      +    "cities": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "countries": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "minAge": {
      +      "type": "number"
      +    },
      +    "regions": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / audioName
      Added value: +{
      +  "description": "INSTAGRAM REEL — replaces the audio track name; an empty string removes it.",
      +  "type": "string"
      +}
    • addedInput schema / properties / brand
      Added value: +{
      +  "description": "WHICH BRAND this post is in — the id or exact name from list_brands. Needed when the post lives in a brand this connection is not pinned to: a post you can CREATE in a brand must be manageable there too, without switching the whole connection. A name that matches no brand, or two, is REFUSED.",
      +  "type": "string"
      +}
    • addedInput schema / properties / brandedContentSponsorIds
      Added value: +{
      +  "description": "INSTAGRAM — replaces the sponsor user ids behind the paid-partnership label (at most 2); [] removes them.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / callToAction
      Added value: +{
      +  "description": "FACEBOOK — replaces the button on the Page post; \"\" removes it.",
      +  "enum": [
      +    "BOOK_TRAVEL",
      +    "BUY_NOW",
      +    "CALL_NOW",
      +    "DOWNLOAD",
      +    "GET_DIRECTIONS",
      +    "LEARN_MORE",
      +    "LIKE_PAGE",
      +    "MESSAGE_PAGE",
      +    "NO_BUTTON",
      +    "OPEN_LINK",
      +    "SHOP_NOW",
      +    "SIGN_UP",
      +    "WATCH_MORE",
      +    ""
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / callToActionLink
      Added value: +{
      +  "description": "FACEBOOK — replaces where the button goes; an empty string falls back to the post link.",
      +  "type": "string"
      +}
    • addedInput schema / properties / coverUrl
      Added value: +{
      +  "description": "INSTAGRAM REEL — replaces the cover image url; an empty string removes it.",
      +  "type": "string"
      +}
    • addedInput schema / properties / instagramLocationId
      Added value: +{
      +  "description": "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.",
      +  "type": "string"
      +}
    • addedInput schema / properties / linkDescription
      Added value: +{
      +  "description": "FACEBOOK — replaces the link preview description; an empty string removes the override.",
      +  "type": "string"
      +}
    • addedInput schema / properties / linkName
      Added value: +{
      +  "description": "FACEBOOK — replaces the link preview headline; an empty string removes the override.",
      +  "type": "string"
      +}
    • addedInput schema / properties / linkPicture
      Added value: +{
      +  "description": "FACEBOOK — replaces the link preview image url; an empty string removes the override.",
      +  "type": "string"
      +}
    • changedInput schema / properties / paidPartnership / description
      Previous value: -"X — the paid-partnership label; false turns it off."New value: +"INSTAGRAM AND X — the paid-partnership label; false turns it off."
    • addedInput schema / properties / place
      Added value: +{
      +  "description": "FACEBOOK — replaces the tagged place (the numeric id of its Facebook Page); an empty string removes it.",
      +  "type": "string"
      +}
    • addedInput schema / properties / shareToFeed
      Added value: +{
      +  "description": "INSTAGRAM REEL — whether the Reel also shows in the Feed grid.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / story
      Added value: +{
      +  "description": "INSTAGRAM — true makes it a 24-hour Story, false an ordinary feed post. One image or one video, no carousel.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / targetAudience
      Added value: +{
      +  "description": "LINKEDIN COMPANY PAGE — replaces who sees the post; {} removes the limit. The matching audience must be over 300 followers.",
      +  "properties": {
      +    "degrees": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "fieldsOfStudy": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "geoLocations": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "industries": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "jobFunctions": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "organizations": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "seniorities": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "staffCountRanges": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / thumbOffset
      Added value: +{
      +  "description": "INSTAGRAM REEL — replaces the cover frame, in milliseconds; 0 removes it. Never together with coverUrl.",
      +  "type": "number"
      +}
  15. Changed2 schema fields changedv0.1.243
    • changedInput schema / properties / description / description
      Previous value: -"YOUTUBE — replace the video description; \"\" clears it. Remember the caption is the TITLE, not the description."New value: +"YOUTUBE — replace the video description; \"\" clears it and the caption is used."
    • addedInput schema / properties / thumbnailUrl
      Added value: +{
      +  "description": "YOUTUBE: replace the custom thumbnail; \"\" goes back to a frame of the video, \"auto\" to YouTube’s pick.",
      +  "type": "string"
      +}
  16. Changed2 schema fields changedv0.1.230
    • changedInput schema / properties / optimizeCopy / description
      Previous value: -"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 (YouTube keyword title + structured description + tags, Instagram/TikTok hashtags, LinkedIn longer, X/Bluesky short, Pinterest keyword-rich); a channel with its own caption is left exactly as written. Send false to switch it off on this item."New value: +"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."
    • addedInput schema / properties / xArticle
      Added value: +{
      +  "description": "X: replaces the X Article (title, headings); {} makes it an ordinary X post again.",
      +  "properties": {
      +    "headings": {
      +      "enum": [
      +        "blocks",
      +        "text"
      +      ],
      +      "type": "string"
      +    },
      +    "title": {
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
  17. Changed1 schema field changedv0.1.225
    • changedInput schema / properties / optimizeCopy / description
      Previous value: -"fit the shared caption to each channel’s own rules at publish time wherever no per-channel caption was written (YouTube keyword title + structured description + tags, Instagram/TikTok hashtags, LinkedIn longer, X/Bluesky short, Pinterest keyword-rich); a channel with its own caption is left exactly as written. Send false to switch it off on this item."New value: +"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 (YouTube keyword title + structured description + tags, Instagram/TikTok hashtags, LinkedIn longer, X/Bluesky short, Pinterest keyword-rich); a channel with its own caption is left exactly as written. Send false to switch it off on this item."
  18. Changed1 schema field changedv0.1.217
    • addedInput schema / properties / optimizeCopy
      Added value: +{
      +  "description": "fit the shared caption to each channel’s own rules at publish time wherever no per-channel caption was written (YouTube keyword title + structured description + tags, Instagram/TikTok hashtags, LinkedIn longer, X/Bluesky short, Pinterest keyword-rich); a channel with its own caption is left exactly as written. Send false to switch it off on this item.",
      +  "type": "boolean"
      +}
  19. Changed1 schema field changedv0.1.209
    • addedInput schema / properties / aiGenerated
      Added value: +{
      +  "description": "INSTAGRAM / FACEBOOK REEL — Meta’s is_ai_generated self-disclosure. OMIT IT and Hermoso decides from provenance: a Hermoso render is declared, media that came through upload_file or from an external URL (the user’s own photographs or footage) is NOT — a real photo must never carry Instagram’s “AI info” label. Pass true or false only to override: false strips the label from something Hermoso would otherwise declare, true declares a render the user uploaded themselves.",
      +  "type": "boolean"
      +}
  20. Addedv0.1.161

TDQS

A4.8/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations declare destructiveHint=true and idempotentHint=true but say nothing about partial-update mechanics. The description supplies the critical non-obvious behavior: omitted fields are untouched, an explicit empty string clears a field (with a concrete linkedinOrganizationId example), and the edited item is re-validated against the same per-channel rules the create passed, so an edit cannot bypass a refusal. That is genuinely additive context beyond the structured metadata.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Four sentences, front-loaded: what it does, then the update convention, then re-validation guarantees, then id sourcing and out-of-scope routing. Given the breadth of the operation, nothing is padding and each sentence adds a distinct operational fact.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 125-parameter mutation tool with nested objects and no output schema, the description covers purpose, patching semantics, validation guarantees, id provenance and the published-post exclusion. It does not say what the call returns or whether the response reflects the new state—the one meaningful gap, though annotations already flag side effects and idempotency.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% across 125 parameters, so per-parameter meaning is already documented. The description nonetheless adds a cross-cutting rule absent from the schema—the omit-vs-explicit-empty-string convention that governs clearing behavior across the whole payload—which is essential for correct invocation of a 125-param patch tool. It stops short of the top score because the rule is stated once generically rather than anchoring individual high-risk fields.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The first sentence names a specific verb and resource ('Change a post that is still QUEUED') and then enumerates exactly which dimensions can change: time, caption, media, channels, destination board/Page/company Page/listing. An agent can distinguish this from schedule_post (creates) and the post_to_* publish tools without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It states the precondition explicitly (only QUEUED posts), tells the agent where the required id comes from ('Get the id from list_scheduled'), and names the exclusion with concrete alternatives: published content must go through manage_meta_post / manage_linkedin_post / delete_x_post instead. Both when-to-use and when-not-to-use are covered.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools