Change a scheduled post

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."

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"
+}

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"
+}

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"
+}

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."

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"
+}

Added value: +{
+  "description": "INSTAGRAM REEL — how loud that track plays, 0–100 (Instagram’s default 100). Needs audioId.",
+  "maximum": 100,
+  "minimum": 0,
+  "type": "integer"
+}

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."

Added value: +{
+  "description": "THE VIDEO COVER on every channel, as one frame in milliseconds (see schedule_post).",
+  "type": "number"
+}

Added value: +{
+  "description": "THE VIDEO COVER on every channel, as a Hermoso-hosted picture (see schedule_post).",
+  "type": "string"
+}

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"
+}

Added value: +{
+  "description": "short id of the content-plan idea this post came from",
+  "type": "string"
+}

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"
+}

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."

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"
+}

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"
+}

Added value: +{
+  "description": "INSTAGRAM REEL — replaces the audio track name; an empty string removes it.",
+  "type": "string"
+}

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"
+}

Added value: +{
+  "description": "INSTAGRAM — replaces the sponsor user ids behind the paid-partnership label (at most 2); [] removes them.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

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"
+}

Added value: +{
+  "description": "FACEBOOK — replaces where the button goes; an empty string falls back to the post link.",
+  "type": "string"
+}

Added value: +{
+  "description": "INSTAGRAM REEL — replaces the cover image url; an empty string removes it.",
+  "type": "string"
+}

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"
+}

Added value: +{
+  "description": "FACEBOOK — replaces the link preview description; an empty string removes the override.",
+  "type": "string"
+}

Added value: +{
+  "description": "FACEBOOK — replaces the link preview headline; an empty string removes the override.",
+  "type": "string"
+}

Added value: +{
+  "description": "FACEBOOK — replaces the link preview image url; an empty string removes the override.",
+  "type": "string"
+}

Previous value: -"X — the paid-partnership label; false turns it off."New value: +"INSTAGRAM AND X — the paid-partnership label; false turns it off."

Added value: +{
+  "description": "FACEBOOK — replaces the tagged place (the numeric id of its Facebook Page); an empty string removes it.",
+  "type": "string"
+}

Added value: +{
+  "description": "INSTAGRAM REEL — whether the Reel also shows in the Feed grid.",
+  "type": "boolean"
+}

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"
+}

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"
+}

Added value: +{
+  "description": "INSTAGRAM REEL — replaces the cover frame, in milliseconds; 0 removes it. Never together with coverUrl.",
+  "type": "number"
+}

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."

Added value: +{
+  "description": "YOUTUBE: replace the custom thumbnail; \"\" goes back to a frame of the video, \"auto\" to YouTube’s pick.",
+  "type": "string"
+}

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."

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"
+}

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."

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"
+}

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"
+}