Skip to main content
Glama

update_post

Destructive

Update an existing post. Only draft and scheduled posts can be updated.

Per-platform options (youtube, pinterest, instagram, tiktok, google_business) are accepted here, same shape as in create_post. Pass an object — never a JSON-encoded string. For YouTube Shorts, the title lives at youtube.title; the video description lives in content (or content.youtube for a per-platform override). They are not the same field — changing the caption does NOT rename the Short.

X threads: To convert an existing draft into a chained X thread, pass x.thread_parts as a 2–25 entry array of { text } objects (each ≤ 280 chars). Pass x.thread_parts: null to revert to single-tweet mode. Do NOT shove "1/", "2/" into content — that's a single tweet, not a thread.

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

NameRequiredDescriptionDefault
xNoX (Twitter) options: thread mode via `thread_parts`, a poll via `poll`.
idYesThe post ID to update
tagsNoReplaces the post's tags (names or ids; a new name becomes a tag); null or [] removes them all. An update with only tags works on every post, published ones included. To add or remove a tag on many posts at once, use tag_posts.
tiktokNoTikTok options
blueskyNoBluesky options, including thread mode via `thread_parts`.
contentNoUpdated post caption / body text. For YouTube Shorts this becomes the video description, NOT the title — to rename the Short, use `youtube.title`. String or object with platform keys: { "default": "fallback", "linkedin": "long" }.
discordNoDiscord options. The post goes to the connected Discord channel through its webhook and shows the webhook's name and picture. Text up to 2,000 chars. Up to 10 images, GIFs and videos per message (they may mix); a video or GIF over Discord's 20 MB file limit is sent as a link in the text. No Stories; a 'reel' is sent as one video message.
threadsNoThreads options: thread mode via `thread_parts`, location tag via `location_id`, a poll via `poll`, the topic via `topic_tag`.
youtubeNoYouTube Shorts options. Only applies when type is 'reel' and youtube is among the selected channels. A custom Shorts thumbnail is set with the top-level `video_cover` (a `youtube` override for a YouTube-only image); it shows on Shorts only on channels where YouTube has enabled custom Shorts thumbnails (Partner Program channels first, since July 2026), other channels show a frame from the video.
channelsNoUpdated channel IDs. Note: `linkedin` (personal profile) and `linkedin_page` (company page) are independent channels.
facebookNoFacebook options
link_urlNoURL to share as a rich preview card on platforms that support link-share posts (LinkedIn and Facebook). Renders as a tile with thumbnail/title/description instead of plain text. Ignored on platforms that don't support link shares, and ignored on posts that already have media attached (media wins).
linkedinNoLinkedIn Profile options
mastodonNoMastodon options: thread mode via `thread_parts`, a poll via `poll`.
telegramNoTelegram options. Text up to 4,096 chars; with media, text over 1,024 chars is sent as a reply under the media. Up to 10 photos and videos per album, videos up to 50 MB, no Stories. A 'reel' is sent as a video message.
instagramNoInstagram options
media_fitNoImage fit per channel, for feed images (type 'post') whose ratio is outside what a channel shows uncropped: { instagram: 'auto' | 'crop' | 'keep', pinterest: ... }. 'auto' (the default when omitted) takes the channel's rule: Instagram crops a tall (9:16) or wide image to 4:5 / 1.91:1 around the subject (Instagram cuts it to that window anyway, and Meta cannot boost a feed post outside it); Pinterest keeps a Pin taller than 2:3 and only reports it. 'crop' / 'keep' force it for that channel. Every decision comes back in the response `warnings` with code `image_fit` (relay it). The crop is a separate file for that channel only; 'default' and the other channels keep the original. On update_post, media_fit alone (no media) re-decides the stored images: 'keep' gives the original back, 'crop' crops an image that was kept.
media_idsNo
pinterestNo
user_tagsNoInstagram only. Tag public accounts at x/y positions on a PHOTO (not video/reels/stories). For a single image omit image_index; for a carousel, set image_index to the slide each tag belongs to. Private/non-existent usernames are rejected at publish time. Ignored by other platforms.
link_titleNoOptional title for the link-share preview. LinkedIn uses this when set; Facebook ignores it and fetches OG metadata server-side. Omit to let LinkedIn auto-fetch the page title.
media_urlsNoExternal image/video/PDF URLs — flat array or per-platform object. Max 10 total (Pinterest: max 5 images per carousel pin), each file ≤ 100 MB. Entries are URL strings or { url, alt } objects (alt = accessibility description, delivered to Mastodon/Bluesky/X/Pinterest/Instagram (images)/LinkedIn (images)). For larger files (up to 1 GB): upload_media with method 'url' first, then pass the returned media id in `media`.
location_idNoInstagram only. Facebook Place ID for a single physical venue (with a street address) to tag the post's location. Find it via the location search in the OmniSocials dashboard. Ignored by other platforms.
video_coverNoReplaces the stored video cover wholesale; pass null to remove it; omit to leave it untouched. facebook.thumbnail_type / thumb_offset / cover_url merge into overrides.facebook on their own.
scheduled_atNoUpdated scheduled date (ISO 8601)
collaboratorsNoInstagram only. Up to 3 public Instagram usernames to invite as co-authors (the 'Collab' feature). Works on image, carousel, and reel posts — NOT Stories. Invited users get an invite in the Instagram app; once they accept, the post also appears on their profile and feed. A leading '@' is stripped; usernames are case-insensitive. Private or non-existent usernames are rejected by Instagram at publish time. Ignored by other platforms.
linkedin_pageNoLinkedIn Company Page options
linkedin_pollNoNon-sponsored LinkedIn poll(s) — independent per channel, keyed by `linkedin` (personal profile) / `linkedin_page` (company page). A poll is mutually exclusive with media and a link share on that channel's post — a poll takes priority over both at publish time. Still requires `content.linkedin` (or `content.default`) as that channel's caption; the poll itself only carries the question/options/duration. On update_post, set a channel's key to `null` to clear that channel's poll and revert it to a normal post — send the full desired state for both channels, since the whole object replaces wholesale.
google_businessNoGoogle Business Profile options. Use to publish EVENT or OFFER posts, attach a CTA button, or both. Shape mirrors Google's LocalPost resource (see https://developers.google.com/my-business/reference/rest/v4/accounts.locations.localPosts#LocalPost). Google Business caption rules (enforced at scheduling — text that violates these will return a `validation_error` 400 before the post is saved): • Phone numbers in the caption are rejected — use a CALL button instead. • Inline URLs / bare domains / emails are rejected — use LEARN_MORE / BOOK / SHOP / SIGN_UP / ORDER buttons instead. • Caption max 1500 characters. • Media is optional (text-only posts are allowed). If attached: exactly one JPEG/PNG/WebP image (no video, no carousels). • The workspace must have a Google Business location selected (Settings → Organisation → Workspaces → Google Business) before scheduling — otherwise returns a 400.
link_descriptionNoOptional description for the link-share preview. LinkedIn uses this when set; Facebook auto-fetches the OG description.
link_thumbnail_urlNoOptional thumbnail image URL for the preview card. Currently applied on Facebook; reserved for LinkedIn.
comment_dm_automationNoReplaces the post's comment-to-DM setup (keywords, DM text, public replies, Follow first, limits, platforms); a channel no longer listed in platforms loses its automation; leave out follow_gate and Follow first is off after the update; leave out the follow-up fields and each automation keeps its stored follow-up (follow_up false switches it off); pass null to remove them all; omit to leave them untouched.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / comment_dm_automation / anyOf
      Previous value: -[
      -  {
      -    "description": "Comment-to-DM automation on this post: when somebody comments one of trigger.keywords on the post once it is live on Instagram or the Facebook Page, the account DMs them actions.dm.text once (on Facebook the DM lands in Messenger), and optionally posts one of actions.public_reply.variations under the comment. On Instagram follow_gate (Follow first) can make the link wait until the person follows the account. Instagram or Facebook must be in channels; platforms picks which ones get it. Show the user the keywords and the exact DM text (and the Follow first texts) before creating it. The created automations come back as comment_dm_automation on the post (automations lists the id of each channel); manage them later with update_automation / get_automation_activity.",
      -    "properties": {
      -      "actions": {
      -        "properties": {
      -          "dm": {
      -            "properties": {
      -              "text": {
      -                "description": "The DM the person receives, once (max 1000 characters). Confirm the text with the user: it goes out in their name.",
      -                "maxLength": 1000,
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "text"
      -            ],
      -            "type": "object"
      -          },
      -          "public_reply": {
      -            "properties": {
      -              "enabled": {
      -                "type": "boolean"
      -              },
      -              "variations": {
      -                "description": "Public replies posted under the comment, one picked at random per comment.",
      -                "items": {
      -                  "maxLength": 300,
      -                  "type": "string"
      -                },
      -                "maxItems": 10,
      -                "type": "array"
      -              }
      -            },
      -            "type": "object"
      -          }
      -        },
      -        "required": [
      -          "dm"
      -        ],
      -        "type": "object"
      -      },
      -      "follow_gate": {
      -        "description": "Instagram only. Follow first: true = the link (actions.dm.text) goes out only to people who follow the account. The private reply to the comment is a short message with one button (follow_gate_text, follow_gate_button); the tap makes OmniSocials ask Instagram whether they follow. A follower gets the link; anybody else gets not_following_text with its button and can tap again after following. When Instagram gives no answer the link goes out anyway. With platforms ['instagram', 'facebook'] only the Instagram automation waits for the follow: the Facebook one sends the DM at once. On update_post the object replaces the setup, so pass follow_gate and its texts again to keep Follow first on.",
      -        "type": "boolean"
      -      },
      -      "follow_gate_button": {
      -        "description": "Follow first: the label of the button on the first message (max 20 characters). Default: \"Send me the link\".",
      -        "maxLength": 20,
      -        "type": "string"
      -      },
      -      "follow_gate_text": {
      -        "description": "Follow first: the first message, sent with one button (max 640 characters). Default: \"Tap the button and I'll send you the link 👇\". Confirm the text with the user: it goes out in the account's name.",
      -        "maxLength": 640,
      -        "type": "string"
      -      },
      -      "limits": {
      -        "properties": {
      -          "max_sends": {
      -            "anyOf": [
      -              {
      -                "exclusiveMinimum": 0,
      -                "maximum": 9007199254740991,
      -                "type": "integer"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "Stop after this many DMs."
      -          },
      -          "stop_at": {
      -            "description": "Stop at this time (ISO 8601).",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "not_following_button": {
      -        "description": "Follow first: the label of the button on that answer (max 20 characters). Default: \"I follow now\".",
      -        "maxLength": 20,
      -        "type": "string"
      -      },
      -      "not_following_text": {
      -        "description": "Follow first: the answer to a tap from somebody who does not follow yet, sent with its own button (max 640 characters). Default: \"Almost there! Follow us first, then tap the button again.\" Naming the account reads better, e.g. \"Almost there! Follow @yourbrand first, then tap the button again.\" Confirm the text with the user: it goes out in the account's name.",
      -        "maxLength": 640,
      -        "type": "string"
      -      },
      -      "platforms": {
      -        "description": "The channels that get the automation: 'instagram', 'facebook' (the Facebook Page; the DM lands in Messenger) or both. One automation per channel, each with the same keywords, DM, public reply and limits. Each one must be in channels. Omit it for one automation: Instagram when the post goes there, else Facebook.",
      -        "items": {
      -          "enum": [
      -            "instagram",
      -            "facebook"
      -          ],
      -          "type": "string"
      -        },
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "trigger": {
      -        "properties": {
      -          "keywords": {
      -            "description": "Keywords that start the automation, matched case-insensitively (up to 20). Required unless match is 'any'.",
      -            "items": {
      -              "type": "string"
      -            },
      -            "maxItems": 20,
      -            "type": "array"
      -          },
      -          "match": {
      -            "description": "word (default): the keyword stands on its own. contains: anywhere in the comment. any: every comment (ask the user first).",
      -            "enum": [
      -              "word",
      -              "contains",
      -              "any"
      -            ],
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "actions"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "Comment-to-DM automation on this post: when somebody comments one of trigger.keywords on the post once it is live on Instagram or the Facebook Page, the account DMs them actions.dm.text once (on Facebook the DM lands in Messenger), and optionally posts one of actions.public_reply.variations under the comment. On Instagram follow_gate (Follow first) can make the link wait until the person follows the account; follow_up adds one more DM up to 23 hours later. Instagram or Facebook must be in channels; platforms picks which ones get it. Show the user the keywords and the exact DM text (and the Follow first and follow-up texts) before creating it. The created automations come back as comment_dm_automation on the post (automations lists the id of each channel); manage them later with update_automation / get_automation_activity.",
      +    "properties": {
      +      "actions": {
      +        "properties": {
      +          "dm": {
      +            "properties": {
      +              "text": {
      +                "description": "The DM the person receives, once (max 1000 characters). Confirm the text with the user: it goes out in their name.",
      +                "maxLength": 1000,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "text"
      +            ],
      +            "type": "object"
      +          },
      +          "public_reply": {
      +            "properties": {
      +              "enabled": {
      +                "type": "boolean"
      +              },
      +              "variations": {
      +                "description": "Public replies posted under the comment, one picked at random per comment.",
      +                "items": {
      +                  "maxLength": 300,
      +                  "type": "string"
      +                },
      +                "maxItems": 10,
      +                "type": "array"
      +              }
      +            },
      +            "type": "object"
      +          }
      +        },
      +        "required": [
      +          "dm"
      +        ],
      +        "type": "object"
      +      },
      +      "follow_gate": {
      +        "description": "Instagram only. Follow first: true = the link (actions.dm.text) goes out only to people who follow the account. The private reply to the comment is a short message with one button (follow_gate_text, follow_gate_button); the tap makes OmniSocials ask Instagram whether they follow. A follower gets the link; anybody else gets not_following_text with its button and can tap again after following. When Instagram gives no answer the link goes out anyway. With platforms ['instagram', 'facebook'] only the Instagram automation waits for the follow: the Facebook one sends the DM at once. On update_post the object replaces the setup, so pass follow_gate and its texts again to keep Follow first on.",
      +        "type": "boolean"
      +      },
      +      "follow_gate_button": {
      +        "description": "Follow first: the label of the button on the first message (max 20 characters). Default: \"Send me the link\".",
      +        "maxLength": 20,
      +        "type": "string"
      +      },
      +      "follow_gate_text": {
      +        "description": "Follow first: the first message, sent with one button (max 640 characters). Default: \"Tap the button and I'll send you the link 👇\". Confirm the text with the user: it goes out in the account's name.",
      +        "maxLength": 640,
      +        "type": "string"
      +      },
      +      "follow_up": {
      +        "description": "Follow-up (Instagram and Facebook): true = one more DM (follow_up_text) goes out follow_up_delay_hours (1 to 23, default 23) after the answer, inside Meta's 24-hour window. On Instagram the private reply to the comment becomes a tap step with one button (follow_up_tap_text, follow_up_tap_button) whose tap sends actions.dm.text and opens the window, unless follow_gate is on (its tap does that); people who never tap get no link and no follow-up. On Facebook only people who answer the DM get the follow-up. It applies to every channel in platforms. On update_post, leaving the follow-up fields out keeps each automation's stored follow-up; false switches it off.",
      +        "type": "boolean"
      +      },
      +      "follow_up_button_title": {
      +        "anyOf": [
      +          {
      +            "maxLength": 20,
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Follow-up: the label of an optional link button under the follow-up (max 20 characters). Pass it together with follow_up_button_url; null (either one) removes the button."
      +      },
      +      "follow_up_button_url": {
      +        "anyOf": [
      +          {
      +            "maxLength": 2000,
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Follow-up: the web address of that button (https:// or http://, max 2000 characters). Pass it together with follow_up_button_title; null (either one) removes the button."
      +      },
      +      "follow_up_delay_hours": {
      +        "description": "Follow-up: hours after the answer went out, 1 to 23 (default 23, the end of Meta's 24-hour window).",
      +        "maximum": 23,
      +        "minimum": 1,
      +        "type": "integer"
      +      },
      +      "follow_up_tap_button": {
      +        "description": "Follow-up, Instagram only: the tap step's button label (max 20 characters). Default: \"Send me the link\".",
      +        "maxLength": 20,
      +        "type": "string"
      +      },
      +      "follow_up_tap_text": {
      +        "description": "Follow-up, Instagram only: the tap step's message, the first DM of a comment answer when Follow first is off (max 640 characters). Default: \"Tap the button and I'll send you the link 👇\". Confirm the text with the user.",
      +        "maxLength": 640,
      +        "type": "string"
      +      },
      +      "follow_up_text": {
      +        "description": "Follow-up: the message (max 1000 characters, 640 with a button). Giving it switches the follow-up on unless follow_up is false. Required to switch it on when none is stored. Confirm the text with the user: it goes out in the account's name.",
      +        "maxLength": 1000,
      +        "type": "string"
      +      },
      +      "limits": {
      +        "properties": {
      +          "max_sends": {
      +            "anyOf": [
      +              {
      +                "exclusiveMinimum": 0,
      +                "maximum": 9007199254740991,
      +                "type": "integer"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "Stop after this many DMs."
      +          },
      +          "stop_at": {
      +            "description": "Stop at this time (ISO 8601).",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "not_following_button": {
      +        "description": "Follow first: the label of the button on that answer (max 20 characters). Default: \"I follow now\".",
      +        "maxLength": 20,
      +        "type": "string"
      +      },
      +      "not_following_text": {
      +        "description": "Follow first: the answer to a tap from somebody who does not follow yet, sent with its own button (max 640 characters). Default: \"Almost there! Follow us first, then tap the button again.\" Naming the account reads better, e.g. \"Almost there! Follow @yourbrand first, then tap the button again.\" Confirm the text with the user: it goes out in the account's name.",
      +        "maxLength": 640,
      +        "type": "string"
      +      },
      +      "platforms": {
      +        "description": "The channels that get the automation: 'instagram', 'facebook' (the Facebook Page; the DM lands in Messenger) or both. One automation per channel, each with the same keywords, DM, public reply and limits. Each one must be in channels. Omit it for one automation: Instagram when the post goes there, else Facebook.",
      +        "items": {
      +          "enum": [
      +            "instagram",
      +            "facebook"
      +          ],
      +          "type": "string"
      +        },
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "trigger": {
      +        "properties": {
      +          "keywords": {
      +            "description": "Keywords that start the automation, matched case-insensitively (up to 20). Required unless match is 'any'.",
      +            "items": {
      +              "type": "string"
      +            },
      +            "maxItems": 20,
      +            "type": "array"
      +          },
      +          "match": {
      +            "description": "word (default): the keyword stands on its own. contains: anywhere in the comment. any: every comment (ask the user first).",
      +            "enum": [
      +              "word",
      +              "contains",
      +              "any"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "actions"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / comment_dm_automation / description
      Previous value: -"Replaces the post's comment-to-DM setup (keywords, DM text, public replies, Follow first, limits, platforms); a channel no longer listed in platforms loses its automation; leave out follow_gate and Follow first is off after the update; pass null to remove them all; omit to leave them untouched."New value: +"Replaces the post's comment-to-DM setup (keywords, DM text, public replies, Follow first, limits, platforms); a channel no longer listed in platforms loses its automation; leave out follow_gate and Follow first is off after the update; leave out the follow-up fields and each automation keeps its stored follow-up (follow_up false switches it off); pass null to remove them all; omit to leave them untouched."
  2. Changed2 schema fields changed
    • changedInput schema / properties / comment_dm_automation / anyOf
      Previous value: -[
      -  {
      -    "description": "Comment-to-DM automation on this post: when somebody comments one of trigger.keywords on the post once it is live on Instagram or the Facebook Page, the account DMs them actions.dm.text once (on Facebook the DM lands in Messenger), and optionally posts one of actions.public_reply.variations under the comment. Instagram or Facebook must be in channels; platforms picks which ones get it. Show the user the keywords and the exact DM text before creating it. The created automations come back as comment_dm_automation on the post (automations lists the id of each channel); manage them later with update_automation / get_automation_activity.",
      -    "properties": {
      -      "actions": {
      -        "properties": {
      -          "dm": {
      -            "properties": {
      -              "text": {
      -                "description": "The DM the person receives, once (max 1000 characters). Confirm the text with the user: it goes out in their name.",
      -                "maxLength": 1000,
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "text"
      -            ],
      -            "type": "object"
      -          },
      -          "public_reply": {
      -            "properties": {
      -              "enabled": {
      -                "type": "boolean"
      -              },
      -              "variations": {
      -                "description": "Public replies posted under the comment, one picked at random per comment.",
      -                "items": {
      -                  "maxLength": 300,
      -                  "type": "string"
      -                },
      -                "maxItems": 10,
      -                "type": "array"
      -              }
      -            },
      -            "type": "object"
      -          }
      -        },
      -        "required": [
      -          "dm"
      -        ],
      -        "type": "object"
      -      },
      -      "limits": {
      -        "properties": {
      -          "max_sends": {
      -            "anyOf": [
      -              {
      -                "exclusiveMinimum": 0,
      -                "maximum": 9007199254740991,
      -                "type": "integer"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "Stop after this many DMs."
      -          },
      -          "stop_at": {
      -            "description": "Stop at this time (ISO 8601).",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "platforms": {
      -        "description": "The channels that get the automation: 'instagram', 'facebook' (the Facebook Page; the DM lands in Messenger) or both. One automation per channel, each with the same keywords, DM, public reply and limits. Each one must be in channels. Omit it for one automation: Instagram when the post goes there, else Facebook.",
      -        "items": {
      -          "enum": [
      -            "instagram",
      -            "facebook"
      -          ],
      -          "type": "string"
      -        },
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "trigger": {
      -        "properties": {
      -          "keywords": {
      -            "description": "Keywords that start the automation, matched case-insensitively (up to 20). Required unless match is 'any'.",
      -            "items": {
      -              "type": "string"
      -            },
      -            "maxItems": 20,
      -            "type": "array"
      -          },
      -          "match": {
      -            "description": "word (default): the keyword stands on its own. contains: anywhere in the comment. any: every comment (ask the user first).",
      -            "enum": [
      -              "word",
      -              "contains",
      -              "any"
      -            ],
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "actions"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "Comment-to-DM automation on this post: when somebody comments one of trigger.keywords on the post once it is live on Instagram or the Facebook Page, the account DMs them actions.dm.text once (on Facebook the DM lands in Messenger), and optionally posts one of actions.public_reply.variations under the comment. On Instagram follow_gate (Follow first) can make the link wait until the person follows the account. Instagram or Facebook must be in channels; platforms picks which ones get it. Show the user the keywords and the exact DM text (and the Follow first texts) before creating it. The created automations come back as comment_dm_automation on the post (automations lists the id of each channel); manage them later with update_automation / get_automation_activity.",
      +    "properties": {
      +      "actions": {
      +        "properties": {
      +          "dm": {
      +            "properties": {
      +              "text": {
      +                "description": "The DM the person receives, once (max 1000 characters). Confirm the text with the user: it goes out in their name.",
      +                "maxLength": 1000,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "text"
      +            ],
      +            "type": "object"
      +          },
      +          "public_reply": {
      +            "properties": {
      +              "enabled": {
      +                "type": "boolean"
      +              },
      +              "variations": {
      +                "description": "Public replies posted under the comment, one picked at random per comment.",
      +                "items": {
      +                  "maxLength": 300,
      +                  "type": "string"
      +                },
      +                "maxItems": 10,
      +                "type": "array"
      +              }
      +            },
      +            "type": "object"
      +          }
      +        },
      +        "required": [
      +          "dm"
      +        ],
      +        "type": "object"
      +      },
      +      "follow_gate": {
      +        "description": "Instagram only. Follow first: true = the link (actions.dm.text) goes out only to people who follow the account. The private reply to the comment is a short message with one button (follow_gate_text, follow_gate_button); the tap makes OmniSocials ask Instagram whether they follow. A follower gets the link; anybody else gets not_following_text with its button and can tap again after following. When Instagram gives no answer the link goes out anyway. With platforms ['instagram', 'facebook'] only the Instagram automation waits for the follow: the Facebook one sends the DM at once. On update_post the object replaces the setup, so pass follow_gate and its texts again to keep Follow first on.",
      +        "type": "boolean"
      +      },
      +      "follow_gate_button": {
      +        "description": "Follow first: the label of the button on the first message (max 20 characters). Default: \"Send me the link\".",
      +        "maxLength": 20,
      +        "type": "string"
      +      },
      +      "follow_gate_text": {
      +        "description": "Follow first: the first message, sent with one button (max 640 characters). Default: \"Tap the button and I'll send you the link 👇\". Confirm the text with the user: it goes out in the account's name.",
      +        "maxLength": 640,
      +        "type": "string"
      +      },
      +      "limits": {
      +        "properties": {
      +          "max_sends": {
      +            "anyOf": [
      +              {
      +                "exclusiveMinimum": 0,
      +                "maximum": 9007199254740991,
      +                "type": "integer"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "Stop after this many DMs."
      +          },
      +          "stop_at": {
      +            "description": "Stop at this time (ISO 8601).",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "not_following_button": {
      +        "description": "Follow first: the label of the button on that answer (max 20 characters). Default: \"I follow now\".",
      +        "maxLength": 20,
      +        "type": "string"
      +      },
      +      "not_following_text": {
      +        "description": "Follow first: the answer to a tap from somebody who does not follow yet, sent with its own button (max 640 characters). Default: \"Almost there! Follow us first, then tap the button again.\" Naming the account reads better, e.g. \"Almost there! Follow @yourbrand first, then tap the button again.\" Confirm the text with the user: it goes out in the account's name.",
      +        "maxLength": 640,
      +        "type": "string"
      +      },
      +      "platforms": {
      +        "description": "The channels that get the automation: 'instagram', 'facebook' (the Facebook Page; the DM lands in Messenger) or both. One automation per channel, each with the same keywords, DM, public reply and limits. Each one must be in channels. Omit it for one automation: Instagram when the post goes there, else Facebook.",
      +        "items": {
      +          "enum": [
      +            "instagram",
      +            "facebook"
      +          ],
      +          "type": "string"
      +        },
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "trigger": {
      +        "properties": {
      +          "keywords": {
      +            "description": "Keywords that start the automation, matched case-insensitively (up to 20). Required unless match is 'any'.",
      +            "items": {
      +              "type": "string"
      +            },
      +            "maxItems": 20,
      +            "type": "array"
      +          },
      +          "match": {
      +            "description": "word (default): the keyword stands on its own. contains: anywhere in the comment. any: every comment (ask the user first).",
      +            "enum": [
      +              "word",
      +              "contains",
      +              "any"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "actions"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / comment_dm_automation / description
      Previous value: -"Replaces the post's comment-to-DM setup (keywords, DM text, public replies, limits, platforms); a channel no longer listed in platforms loses its automation; pass null to remove them all; omit to leave them untouched."New value: +"Replaces the post's comment-to-DM setup (keywords, DM text, public replies, Follow first, limits, platforms); a channel no longer listed in platforms loses its automation; leave out follow_gate and Follow first is off after the update; pass null to remove them all; omit to leave them untouched."
  3. Changed1 schema field changed
    • addedInput schema / properties / tags
      Added value: +{
      +  "anyOf": [
      +    {
      +      "description": "Tags for this post: tag names or ids, e.g. [\"Question hook\", \"Talking head\"]; a name that does not exist yet becomes a new tag. Tags are the workspace's own labels (a hook style, a format, a campaign) to filter and compare posts in Analytics (get_tag_analytics); nothing goes to a platform. Use list_tags to see the existing ones and reuse their exact names.",
      +      "items": {
      +        "type": "string"
      +      },
      +      "maxItems": 20,
      +      "type": "array"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "Replaces the post's tags (names or ids; a new name becomes a tag); null or [] removes them all. An update with only tags works on every post, published ones included. To add or remove a tag on many posts at once, use tag_posts."
      +}
  4. Changed7 schema fields changed
    • changedInput schema / properties / mastodon / description
      Previous value: -"Mastodon options, including thread mode via `thread_parts`."New value: +"Mastodon options: thread mode via `thread_parts`, a poll via `poll`."
    • addedInput schema / properties / mastodon / properties / poll
      Added value: +{
      +  "anyOf": [
      +    {
      +      "properties": {
      +        "expires_in": {
      +          "description": "How long the poll runs, in seconds, within the instance's range (Mastodon's defaults: 5 minutes to 1 month). Default 86400 (one day).",
      +          "maximum": 9007199254740991,
      +          "minimum": 300,
      +          "type": "integer"
      +        },
      +        "hide_totals": {
      +          "description": "Hide the vote counts until the poll ends.",
      +          "type": "boolean"
      +        },
      +        "multiple": {
      +          "description": "Allow several answers per person.",
      +          "type": "boolean"
      +        },
      +        "options": {
      +          "description": "The answer options, all different; count and length within the instance's limits (Mastodon's defaults: 4 options of 50 characters).",
      +          "items": {
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "minItems": 2,
      +          "type": "array"
      +        }
      +      },
      +      "required": [
      +        "options"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "Attach a poll to the status; the status text is the question. No media on Mastodon together with a poll. On a thread the poll goes on the first status. On update_post, null removes it."
      +}
    • changedInput schema / properties / threads / description
      Previous value: -"Threads options: thread mode via `thread_parts`, location tag via `location_id`."New value: +"Threads options: thread mode via `thread_parts`, location tag via `location_id`, a poll via `poll`, the topic via `topic_tag`."
    • addedInput schema / properties / threads / properties / poll
      Added value: +{
      +  "anyOf": [
      +    {
      +      "properties": {
      +        "options": {
      +          "description": "2 to 4 answer options of 1 to 25 characters, all different.",
      +          "items": {
      +            "maxLength": 25,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 4,
      +          "minItems": 2,
      +          "type": "array"
      +        }
      +      },
      +      "required": [
      +        "options"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "Attach a poll to the post; the post text is the question. Threads closes the poll 24 hours after it is published (no duration). Polls go on text-only posts: no media on Threads together with a poll. On a thread the poll goes on the first post. On update_post, null removes it."
      +}
    • addedInput schema / properties / threads / properties / topic_tag
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maxLength": 50,
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "The topic of the post on Threads, one per post, e.g. \"Build in public\". Unlike a #tag in the text it can hold spaces. 1 to 50 characters, no period (.) and no ampersand (&); a leading # is dropped. On a multi-post thread the topic goes on the first post. On update_post, pass null to remove it."
      +}
    • changedInput schema / properties / x / description
      Previous value: -"X (Twitter) options, including thread mode via `thread_parts`."New value: +"X (Twitter) options: thread mode via `thread_parts`, a poll via `poll`."
    • addedInput schema / properties / x / properties / poll
      Added value: +{
      +  "anyOf": [
      +    {
      +      "properties": {
      +        "duration_minutes": {
      +          "description": "How long the poll runs, in minutes (5 to 10080 = 7 days). Default 1440 (one day).",
      +          "maximum": 10080,
      +          "minimum": 5,
      +          "type": "integer"
      +        },
      +        "options": {
      +          "description": "2 to 4 answer options of up to 25 characters, all different.",
      +          "items": {
      +            "maxLength": 25,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 4,
      +          "minItems": 2,
      +          "type": "array"
      +        }
      +      },
      +      "required": [
      +        "options"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "Attach a poll to the tweet; the tweet text is the question. No media on X together with a poll. On a thread the poll goes on the first tweet. On update_post, null removes it."
      +}
  5. Changed9 schema fields changed
    • changedInput schema / properties / comment_dm_automation / anyOf
      Previous value: -[
      -  {
      -    "description": "Comment-to-DM automation on this post: when somebody comments one of trigger.keywords on the post once it is live on Instagram or the Facebook Page, the account DMs them actions.dm.text once (on Facebook the DM lands in Messenger), and optionally posts one of actions.public_reply.variations under the comment. Instagram or Facebook must be in channels; platforms picks which ones get it. Show the user the keywords and the exact DM text before creating it. The created automations come back as comment_dm_automation on the post (automations lists the id of each channel); manage them later with update_automation / get_automation_activity.",
      -    "properties": {
      -      "actions": {
      -        "properties": {
      -          "dm": {
      -            "properties": {
      -              "text": {
      -                "description": "The DM the person receives, once (max 1000 characters). Confirm the text with the user: it goes out in their name.",
      -                "maxLength": 1000,
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "text"
      -            ],
      -            "type": "object"
      -          },
      -          "public_reply": {
      -            "properties": {
      -              "enabled": {
      -                "type": "boolean"
      -              },
      -              "variations": {
      -                "description": "Public replies posted under the comment, one picked at random per comment.",
      -                "items": {
      -                  "maxLength": 300,
      -                  "type": "string"
      -                },
      -                "maxItems": 10,
      -                "type": "array"
      -              }
      -            },
      -            "type": "object"
      -          }
      -        },
      -        "required": [
      -          "dm"
      -        ],
      -        "type": "object"
      -      },
      -      "limits": {
      -        "properties": {
      -          "max_sends": {
      -            "anyOf": [
      -              {
      -                "exclusiveMinimum": 0,
      -                "maximum": 9007199254740991,
      -                "type": "integer"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "Stop after this many DMs."
      -          },
      -          "stop_at": {
      -            "anyOf": [
      -              {
      -                "type": "string"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "Stop at this time (ISO 8601)."
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "platforms": {
      -        "description": "The channels that get the automation: 'instagram', 'facebook' (the Facebook Page; the DM lands in Messenger) or both. One automation per channel, each with the same keywords, DM, public reply and limits. Each one must be in channels. Omit it for one automation: Instagram when the post goes there, else Facebook.",
      -        "items": {
      -          "enum": [
      -            "instagram",
      -            "facebook"
      -          ],
      -          "type": "string"
      -        },
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "trigger": {
      -        "properties": {
      -          "keywords": {
      -            "description": "Keywords that start the automation, matched case-insensitively (up to 20). Required unless match is 'any'.",
      -            "items": {
      -              "type": "string"
      -            },
      -            "maxItems": 20,
      -            "type": "array"
      -          },
      -          "match": {
      -            "description": "word (default): the keyword stands on its own. contains: anywhere in the comment. any: every comment (ask the user first).",
      -            "enum": [
      -              "word",
      -              "contains",
      -              "any"
      -            ],
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "actions"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "Comment-to-DM automation on this post: when somebody comments one of trigger.keywords on the post once it is live on Instagram or the Facebook Page, the account DMs them actions.dm.text once (on Facebook the DM lands in Messenger), and optionally posts one of actions.public_reply.variations under the comment. Instagram or Facebook must be in channels; platforms picks which ones get it. Show the user the keywords and the exact DM text before creating it. The created automations come back as comment_dm_automation on the post (automations lists the id of each channel); manage them later with update_automation / get_automation_activity.",
      +    "properties": {
      +      "actions": {
      +        "properties": {
      +          "dm": {
      +            "properties": {
      +              "text": {
      +                "description": "The DM the person receives, once (max 1000 characters). Confirm the text with the user: it goes out in their name.",
      +                "maxLength": 1000,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "text"
      +            ],
      +            "type": "object"
      +          },
      +          "public_reply": {
      +            "properties": {
      +              "enabled": {
      +                "type": "boolean"
      +              },
      +              "variations": {
      +                "description": "Public replies posted under the comment, one picked at random per comment.",
      +                "items": {
      +                  "maxLength": 300,
      +                  "type": "string"
      +                },
      +                "maxItems": 10,
      +                "type": "array"
      +              }
      +            },
      +            "type": "object"
      +          }
      +        },
      +        "required": [
      +          "dm"
      +        ],
      +        "type": "object"
      +      },
      +      "limits": {
      +        "properties": {
      +          "max_sends": {
      +            "anyOf": [
      +              {
      +                "exclusiveMinimum": 0,
      +                "maximum": 9007199254740991,
      +                "type": "integer"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "Stop after this many DMs."
      +          },
      +          "stop_at": {
      +            "description": "Stop at this time (ISO 8601).",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "platforms": {
      +        "description": "The channels that get the automation: 'instagram', 'facebook' (the Facebook Page; the DM lands in Messenger) or both. One automation per channel, each with the same keywords, DM, public reply and limits. Each one must be in channels. Omit it for one automation: Instagram when the post goes there, else Facebook.",
      +        "items": {
      +          "enum": [
      +            "instagram",
      +            "facebook"
      +          ],
      +          "type": "string"
      +        },
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "trigger": {
      +        "properties": {
      +          "keywords": {
      +            "description": "Keywords that start the automation, matched case-insensitively (up to 20). Required unless match is 'any'.",
      +            "items": {
      +              "type": "string"
      +            },
      +            "maxItems": 20,
      +            "type": "array"
      +          },
      +          "match": {
      +            "description": "word (default): the keyword stands on its own. contains: anywhere in the comment. any: every comment (ask the user first).",
      +            "enum": [
      +              "word",
      +              "contains",
      +              "any"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "actions"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / discord / anyOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "allow_mentions": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "true lets @everyone, @here, role and user mentions in the text notify people. Off by default: mentions show as text and ping nobody. Only turn it on when the user asks to ping."
      -      },
      -      "buttons": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "properties": {
      -                "text": {
      -                  "description": "Button label (1 to 80 chars).",
      -                  "maxLength": 80,
      -                  "type": "string"
      -                },
      -                "url": {
      -                  "description": "Link the button opens: https:// or http://.",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "text",
      -                "url"
      -              ],
      -              "type": "object"
      -            },
      -            "maxItems": 5,
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Up to 5 link buttons in one row under the message. Not with a poll."
      -      },
      -      "link_preview": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "false hides the previews of the links in the text (shown by default)."
      -      },
      -      "poll": {
      -        "anyOf": [
      -          {
      -            "properties": {
      -              "duration_hours": {
      -                "description": "Hours the poll stays open (1 to 768, 32 days). Default 24.",
      -                "maximum": 768,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "multiple": {
      -                "description": "Allow several answers per person.",
      -                "type": "boolean"
      -              },
      -              "options": {
      -                "description": "2 to 10 answer options of up to 55 chars, all different.",
      -                "items": {
      -                  "maxLength": 55,
      -                  "type": "string"
      -                },
      -                "maxItems": 10,
      -                "minItems": 2,
      -                "type": "array"
      -              }
      -            },
      -            "required": [
      -              "options"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "A native Discord poll. The post text is the question (max 300 chars). No media and no buttons with a poll. On update_post, null removes it."
      -      },
      -      "silent": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Send without a push or desktop notification (Discord's @silent)."
      -      },
      -      "spoiler": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Blur every image and video until someone clicks it."
      -      },
      -      "thread_name": {
      -        "anyOf": [
      -          {
      -            "maxLength": 100,
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "The post title in a forum or media channel, where Discord requires one (max 100 chars). Only for those channels: a text channel takes none, so the post goes out there without it (warning thread_name_ignored)."
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "allow_mentions": {
      +        "description": "true lets @everyone, @here, role and user mentions in the text notify people. Off by default: mentions show as text and ping nobody. Only turn it on when the user asks to ping.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "buttons": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "properties": {
      +                "text": {
      +                  "description": "Button label (1 to 80 chars).",
      +                  "maxLength": 80,
      +                  "type": "string"
      +                },
      +                "url": {
      +                  "description": "Link the button opens: https:// or http://.",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "text",
      +                "url"
      +              ],
      +              "type": "object"
      +            },
      +            "maxItems": 5,
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Up to 5 link buttons in one row under the message. Not with a poll."
      +      },
      +      "link_preview": {
      +        "description": "false hides the previews of the links in the text (shown by default).",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "poll": {
      +        "anyOf": [
      +          {
      +            "properties": {
      +              "duration_hours": {
      +                "description": "Hours the poll stays open (1 to 768, 32 days). Default 24.",
      +                "maximum": 768,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "multiple": {
      +                "description": "Allow several answers per person.",
      +                "type": "boolean"
      +              },
      +              "options": {
      +                "description": "2 to 10 answer options of up to 55 chars, all different.",
      +                "items": {
      +                  "maxLength": 55,
      +                  "type": "string"
      +                },
      +                "maxItems": 10,
      +                "minItems": 2,
      +                "type": "array"
      +              }
      +            },
      +            "required": [
      +              "options"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "A native Discord poll. The post text is the question (max 300 chars). No media and no buttons with a poll. On update_post, null removes it."
      +      },
      +      "silent": {
      +        "description": "Send without a push or desktop notification (Discord's @silent).",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "spoiler": {
      +        "description": "Blur every image and video until someone clicks it.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "thread_name": {
      +        "anyOf": [
      +          {
      +            "maxLength": 100,
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "The post title in a forum or media channel, where Discord requires one (max 100 chars). Only for those channels: a text channel takes none, so the post goes out there without it (warning thread_name_ignored)."
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / linkedin / properties / carousel_as_images / anyOf
      Removed value: -[
      -  {
      -    "type": "boolean"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedInput schema / properties / linkedin / properties / carousel_as_images / type
      Added value: +[
      +  "boolean",
      +  "null"
      +]
    • removedInput schema / properties / linkedin_page / properties / carousel_as_images / anyOf
      Removed value: -[
      -  {
      -    "type": "boolean"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedInput schema / properties / linkedin_page / properties / carousel_as_images / type
      Added value: +[
      +  "boolean",
      +  "null"
      +]
    • changedInput schema / properties / telegram / anyOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "buttons": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "properties": {
      -                "text": {
      -                  "description": "Button label (max 64 chars).",
      -                  "maxLength": 64,
      -                  "type": "string"
      -                },
      -                "url": {
      -                  "description": "Link the button opens: https://, http:// or tg://.",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "text",
      -                "url"
      -              ],
      -              "type": "object"
      -            },
      -            "maxItems": 3,
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Up to 3 link buttons under the post, one per row. Not on an album (2+ media) or a poll."
      -      },
      -      "caption_above_media": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Show the text above the media instead of below."
      -      },
      -      "first_comment": {
      -        "description": "A reply the bot sends under the post right after it is published.",
      -        "maxLength": 4096,
      -        "type": "string"
      -      },
      -      "link_preview": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "false hides the link preview of a text-only post (shown by default)."
      -      },
      -      "pin": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Pin the post in the chat after it is sent. Needs the bot's Edit messages right in a channel (Pin messages in a group); without it the post is sent unpinned."
      -      },
      -      "poll": {
      -        "anyOf": [
      -          {
      -            "properties": {
      -              "multiple": {
      -                "description": "Allow several answers per person.",
      -                "type": "boolean"
      -              },
      -              "open_period": {
      -                "description": "Seconds the poll stays open (5 s to about 30 days). Omit to keep it open.",
      -                "maximum": 2628000,
      -                "minimum": 5,
      -                "type": "integer"
      -              },
      -              "options": {
      -                "description": "2 to 12 answer options of up to 100 chars, all different.",
      -                "items": {
      -                  "maxLength": 100,
      -                  "type": "string"
      -                },
      -                "maxItems": 12,
      -                "minItems": 2,
      -                "type": "array"
      -              }
      -            },
      -            "required": [
      -              "options"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "A native Telegram poll. The post text is the question (max 300 chars). No media with a poll. On update_post, null removes it."
      -      },
      -      "protect_content": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Stop forwarding and saving of the post in Telegram apps."
      -      },
      -      "silent": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Send without a notification sound."
      -      },
      -      "spoiler": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Blur the photos and videos until someone taps them."
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "buttons": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "properties": {
      +                "text": {
      +                  "description": "Button label (max 64 chars).",
      +                  "maxLength": 64,
      +                  "type": "string"
      +                },
      +                "url": {
      +                  "description": "Link the button opens: https://, http:// or tg://.",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "text",
      +                "url"
      +              ],
      +              "type": "object"
      +            },
      +            "maxItems": 3,
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Up to 3 link buttons under the post, one per row. Not on an album (2+ media) or a poll."
      +      },
      +      "caption_above_media": {
      +        "description": "Show the text above the media instead of below.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "first_comment": {
      +        "description": "A reply the bot sends under the post right after it is published.",
      +        "maxLength": 4096,
      +        "type": "string"
      +      },
      +      "link_preview": {
      +        "description": "false hides the link preview of a text-only post (shown by default).",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "pin": {
      +        "description": "Pin the post in the chat after it is sent. Needs the bot's Edit messages right in a channel (Pin messages in a group); without it the post is sent unpinned.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "poll": {
      +        "anyOf": [
      +          {
      +            "properties": {
      +              "multiple": {
      +                "description": "Allow several answers per person.",
      +                "type": "boolean"
      +              },
      +              "open_period": {
      +                "description": "Seconds the poll stays open (5 s to about 30 days). Omit to keep it open.",
      +                "maximum": 2628000,
      +                "minimum": 5,
      +                "type": "integer"
      +              },
      +              "options": {
      +                "description": "2 to 12 answer options of up to 100 chars, all different.",
      +                "items": {
      +                  "maxLength": 100,
      +                  "type": "string"
      +                },
      +                "maxItems": 12,
      +                "minItems": 2,
      +                "type": "array"
      +              }
      +            },
      +            "required": [
      +              "options"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "A native Telegram poll. The post text is the question (max 300 chars). No media with a poll. On update_post, null removes it."
      +      },
      +      "protect_content": {
      +        "description": "Stop forwarding and saving of the post in Telegram apps.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "silent": {
      +        "description": "Send without a notification sound.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "spoiler": {
      +        "description": "Blur the photos and videos until someone taps them.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / threads / properties / location_id / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedInput schema / properties / threads / properties / location_id / type
      Added value: +[
      +  "string",
      +  "null"
      +]
  6. Changed3 schema fields changed
    • changedInput schema / properties / comment_dm_automation / anyOf
      Previous value: -[
      -  {
      -    "description": "Comment-to-DM automation on this post: when somebody comments one of trigger.keywords on the post once it is live on Instagram, the account DMs them actions.dm.text once, and optionally posts one of actions.public_reply.variations under the comment. Instagram must be in channels. Show the user the keywords and the exact DM text before creating it. The created automation comes back as comment_dm_automation on the post; manage it later with update_automation / get_automation_activity.",
      -    "properties": {
      -      "actions": {
      -        "properties": {
      -          "dm": {
      -            "properties": {
      -              "text": {
      -                "description": "The DM the person receives, once (max 1000 characters). Confirm the text with the user: it goes out in their name.",
      -                "maxLength": 1000,
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "text"
      -            ],
      -            "type": "object"
      -          },
      -          "public_reply": {
      -            "properties": {
      -              "enabled": {
      -                "type": "boolean"
      -              },
      -              "variations": {
      -                "description": "Public replies posted under the comment, one picked at random per comment.",
      -                "items": {
      -                  "maxLength": 300,
      -                  "type": "string"
      -                },
      -                "maxItems": 10,
      -                "type": "array"
      -              }
      -            },
      -            "type": "object"
      -          }
      -        },
      -        "required": [
      -          "dm"
      -        ],
      -        "type": "object"
      -      },
      -      "limits": {
      -        "properties": {
      -          "max_sends": {
      -            "anyOf": [
      -              {
      -                "exclusiveMinimum": 0,
      -                "maximum": 9007199254740991,
      -                "type": "integer"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "Stop after this many DMs."
      -          },
      -          "stop_at": {
      -            "anyOf": [
      -              {
      -                "type": "string"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ],
      -            "description": "Stop at this time (ISO 8601)."
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "trigger": {
      -        "properties": {
      -          "keywords": {
      -            "description": "Keywords that start the automation, matched case-insensitively (up to 20). Required unless match is 'any'.",
      -            "items": {
      -              "type": "string"
      -            },
      -            "maxItems": 20,
      -            "type": "array"
      -          },
      -          "match": {
      -            "description": "word (default): the keyword stands on its own. contains: anywhere in the comment. any: every comment (ask the user first).",
      -            "enum": [
      -              "word",
      -              "contains",
      -              "any"
      -            ],
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "actions"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "Comment-to-DM automation on this post: when somebody comments one of trigger.keywords on the post once it is live on Instagram or the Facebook Page, the account DMs them actions.dm.text once (on Facebook the DM lands in Messenger), and optionally posts one of actions.public_reply.variations under the comment. Instagram or Facebook must be in channels; platforms picks which ones get it. Show the user the keywords and the exact DM text before creating it. The created automations come back as comment_dm_automation on the post (automations lists the id of each channel); manage them later with update_automation / get_automation_activity.",
      +    "properties": {
      +      "actions": {
      +        "properties": {
      +          "dm": {
      +            "properties": {
      +              "text": {
      +                "description": "The DM the person receives, once (max 1000 characters). Confirm the text with the user: it goes out in their name.",
      +                "maxLength": 1000,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "text"
      +            ],
      +            "type": "object"
      +          },
      +          "public_reply": {
      +            "properties": {
      +              "enabled": {
      +                "type": "boolean"
      +              },
      +              "variations": {
      +                "description": "Public replies posted under the comment, one picked at random per comment.",
      +                "items": {
      +                  "maxLength": 300,
      +                  "type": "string"
      +                },
      +                "maxItems": 10,
      +                "type": "array"
      +              }
      +            },
      +            "type": "object"
      +          }
      +        },
      +        "required": [
      +          "dm"
      +        ],
      +        "type": "object"
      +      },
      +      "limits": {
      +        "properties": {
      +          "max_sends": {
      +            "anyOf": [
      +              {
      +                "exclusiveMinimum": 0,
      +                "maximum": 9007199254740991,
      +                "type": "integer"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "Stop after this many DMs."
      +          },
      +          "stop_at": {
      +            "anyOf": [
      +              {
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "Stop at this time (ISO 8601)."
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "platforms": {
      +        "description": "The channels that get the automation: 'instagram', 'facebook' (the Facebook Page; the DM lands in Messenger) or both. One automation per channel, each with the same keywords, DM, public reply and limits. Each one must be in channels. Omit it for one automation: Instagram when the post goes there, else Facebook.",
      +        "items": {
      +          "enum": [
      +            "instagram",
      +            "facebook"
      +          ],
      +          "type": "string"
      +        },
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "trigger": {
      +        "properties": {
      +          "keywords": {
      +            "description": "Keywords that start the automation, matched case-insensitively (up to 20). Required unless match is 'any'.",
      +            "items": {
      +              "type": "string"
      +            },
      +            "maxItems": 20,
      +            "type": "array"
      +          },
      +          "match": {
      +            "description": "word (default): the keyword stands on its own. contains: anywhere in the comment. any: every comment (ask the user first).",
      +            "enum": [
      +              "word",
      +              "contains",
      +              "any"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "actions"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / comment_dm_automation / description
      Previous value: -"Replaces the post's comment-to-DM automation (keywords, DM text, public replies, limits); pass null to remove it; omit to leave it untouched."New value: +"Replaces the post's comment-to-DM setup (keywords, DM text, public replies, limits, platforms); a channel no longer listed in platforms loses its automation; pass null to remove them all; omit to leave them untouched."
    • addedInput schema / properties / discord
      Added value: +{
      +  "anyOf": [
      +    {
      +      "properties": {
      +        "allow_mentions": {
      +          "anyOf": [
      +            {
      +              "type": "boolean"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "true lets @everyone, @here, role and user mentions in the text notify people. Off by default: mentions show as text and ping nobody. Only turn it on when the user asks to ping."
      +        },
      +        "buttons": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "properties": {
      +                  "text": {
      +                    "description": "Button label (1 to 80 chars).",
      +                    "maxLength": 80,
      +                    "type": "string"
      +                  },
      +                  "url": {
      +                    "description": "Link the button opens: https:// or http://.",
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "text",
      +                  "url"
      +                ],
      +                "type": "object"
      +              },
      +              "maxItems": 5,
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Up to 5 link buttons in one row under the message. Not with a poll."
      +        },
      +        "link_preview": {
      +          "anyOf": [
      +            {
      +              "type": "boolean"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "false hides the previews of the links in the text (shown by default)."
      +        },
      +        "poll": {
      +          "anyOf": [
      +            {
      +              "properties": {
      +                "duration_hours": {
      +                  "description": "Hours the poll stays open (1 to 768, 32 days). Default 24.",
      +                  "maximum": 768,
      +                  "minimum": 1,
      +                  "type": "integer"
      +                },
      +                "multiple": {
      +                  "description": "Allow several answers per person.",
      +                  "type": "boolean"
      +                },
      +                "options": {
      +                  "description": "2 to 10 answer options of up to 55 chars, all different.",
      +                  "items": {
      +                    "maxLength": 55,
      +                    "type": "string"
      +                  },
      +                  "maxItems": 10,
      +                  "minItems": 2,
      +                  "type": "array"
      +                }
      +              },
      +              "required": [
      +                "options"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "A native Discord poll. The post text is the question (max 300 chars). No media and no buttons with a poll. On update_post, null removes it."
      +        },
      +        "silent": {
      +          "anyOf": [
      +            {
      +              "type": "boolean"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Send without a push or desktop notification (Discord's @silent)."
      +        },
      +        "spoiler": {
      +          "anyOf": [
      +            {
      +              "type": "boolean"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Blur every image and video until someone clicks it."
      +        },
      +        "thread_name": {
      +          "anyOf": [
      +            {
      +              "maxLength": 100,
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "The post title in a forum or media channel, where Discord requires one (max 100 chars). Only for those channels: a text channel takes none, so the post goes out there without it (warning thread_name_ignored)."
      +        }
      +      },
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "Discord options. The post goes to the connected Discord channel through its webhook and shows the webhook's name and picture. Text up to 2,000 chars. Up to 10 images, GIFs and videos per message (they may mix); a video or GIF over Discord's 20 MB file limit is sent as a link in the text. No Stories; a 'reel' is sent as one video message."
      +}
  7. Changed1 schema field changed
    • changedInput schema / properties / bluesky / properties / thread_parts / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "properties": {
      -        "media_ids": {
      -          "description": "Per-post media as Library IDs from upload_media (max 4) — bare IDs or { id, alt } objects. A part is one video OR up to 4 images.",
      -          "items": {
      -            "anyOf": [
      -              {
      -                "type": "string"
      -              },
      -              {
      -                "properties": {
      -                  "alt": {
      -                    "description": "Accessibility description (alt text) for this media item, shown to screen-reader users (max 1500 chars). Applied on Mastodon, Bluesky, X, Pinterest, Instagram (images and carousel image slides — not Reels/Stories) and LinkedIn (images only — not video or documents). Describe what the image shows; strongly valued by the Mastodon/Bluesky communities.",
      -                    "maxLength": 1500,
      -                    "type": "string"
      -                  },
      -                  "id": {
      -                    "description": "Library media ID from upload_media",
      -                    "type": "string"
      -                  }
      -                },
      -                "required": [
      -                  "id"
      -                ],
      -                "type": "object"
      -              }
      -            ]
      -          },
      -          "maxItems": 4,
      -          "type": "array"
      -        },
      -        "media_urls": {
      -          "description": "Per-post media as external URLs (max 4) — URL strings or { url, alt } objects. A part is one video OR up to 4 images.",
      -          "items": {
      -            "anyOf": [
      -              {
      -                "type": "string"
      -              },
      -              {
      -                "properties": {
      -                  "alt": {
      -                    "description": "Accessibility description (alt text) for this media item, shown to screen-reader users (max 1500 chars). Applied on Mastodon, Bluesky, X, Pinterest, Instagram (images and carousel image slides — not Reels/Stories) and LinkedIn (images only — not video or documents). Describe what the image shows; strongly valued by the Mastodon/Bluesky communities.",
      -                    "maxLength": 1500,
      -                    "type": "string"
      -                  },
      -                  "url": {
      -                    "description": "External media URL",
      -                    "type": "string"
      -                  }
      -                },
      -                "required": [
      -                  "url"
      -                ],
      -                "type": "object"
      -              }
      -            ]
      -          },
      -          "maxItems": 4,
      -          "type": "array"
      -        },
      -        "text": {
      -          "description": "Post text (≤ 300 chars, counted as graphemes — one emoji = 1)",
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "text"
      -      ],
      -      "type": "object"
      -    },
      -    "maxItems": 25,
      -    "minItems": 2,
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "properties": {
      +        "media_ids": {
      +          "description": "Per-post media as Library IDs from upload_media (max 10) — bare IDs or { id, alt } objects. A part is one video OR up to 10 images (5 or more post as a gallery).",
      +          "items": {
      +            "anyOf": [
      +              {
      +                "type": "string"
      +              },
      +              {
      +                "properties": {
      +                  "alt": {
      +                    "description": "Accessibility description (alt text) for this media item, shown to screen-reader users (max 1500 chars). Applied on Mastodon, Bluesky, X, Pinterest, Instagram (images and carousel image slides — not Reels/Stories) and LinkedIn (images only — not video or documents). Describe what the image shows; strongly valued by the Mastodon/Bluesky communities.",
      +                    "maxLength": 1500,
      +                    "type": "string"
      +                  },
      +                  "id": {
      +                    "description": "Library media ID from upload_media",
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "id"
      +                ],
      +                "type": "object"
      +              }
      +            ]
      +          },
      +          "maxItems": 10,
      +          "type": "array"
      +        },
      +        "media_urls": {
      +          "description": "Per-post media as external URLs (max 10) — URL strings or { url, alt } objects. A part is one video OR up to 10 images (5 or more post as a gallery).",
      +          "items": {
      +            "anyOf": [
      +              {
      +                "type": "string"
      +              },
      +              {
      +                "properties": {
      +                  "alt": {
      +                    "description": "Accessibility description (alt text) for this media item, shown to screen-reader users (max 1500 chars). Applied on Mastodon, Bluesky, X, Pinterest, Instagram (images and carousel image slides — not Reels/Stories) and LinkedIn (images only — not video or documents). Describe what the image shows; strongly valued by the Mastodon/Bluesky communities.",
      +                    "maxLength": 1500,
      +                    "type": "string"
      +                  },
      +                  "url": {
      +                    "description": "External media URL",
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "url"
      +                ],
      +                "type": "object"
      +              }
      +            ]
      +          },
      +          "maxItems": 10,
      +          "type": "array"
      +        },
      +        "text": {
      +          "description": "Post text (≤ 300 chars, counted as graphemes — one emoji = 1)",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "text"
      +      ],
      +      "type": "object"
      +    },
      +    "maxItems": 25,
      +    "minItems": 2,
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  8. Changed1 schema field changed
    • addedInput schema / properties / telegram
      Added value: +{
      +  "anyOf": [
      +    {
      +      "properties": {
      +        "buttons": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "properties": {
      +                  "text": {
      +                    "description": "Button label (max 64 chars).",
      +                    "maxLength": 64,
      +                    "type": "string"
      +                  },
      +                  "url": {
      +                    "description": "Link the button opens: https://, http:// or tg://.",
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "text",
      +                  "url"
      +                ],
      +                "type": "object"
      +              },
      +              "maxItems": 3,
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Up to 3 link buttons under the post, one per row. Not on an album (2+ media) or a poll."
      +        },
      +        "caption_above_media": {
      +          "anyOf": [
      +            {
      +              "type": "boolean"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Show the text above the media instead of below."
      +        },
      +        "first_comment": {
      +          "description": "A reply the bot sends under the post right after it is published.",
      +          "maxLength": 4096,
      +          "type": "string"
      +        },
      +        "link_preview": {
      +          "anyOf": [
      +            {
      +              "type": "boolean"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "false hides the link preview of a text-only post (shown by default)."
      +        },
      +        "pin": {
      +          "anyOf": [
      +            {
      +              "type": "boolean"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Pin the post in the chat after it is sent. Needs the bot's Edit messages right in a channel (Pin messages in a group); without it the post is sent unpinned."
      +        },
      +        "poll": {
      +          "anyOf": [
      +            {
      +              "properties": {
      +                "multiple": {
      +                  "description": "Allow several answers per person.",
      +                  "type": "boolean"
      +                },
      +                "open_period": {
      +                  "description": "Seconds the poll stays open (5 s to about 30 days). Omit to keep it open.",
      +                  "maximum": 2628000,
      +                  "minimum": 5,
      +                  "type": "integer"
      +                },
      +                "options": {
      +                  "description": "2 to 12 answer options of up to 100 chars, all different.",
      +                  "items": {
      +                    "maxLength": 100,
      +                    "type": "string"
      +                  },
      +                  "maxItems": 12,
      +                  "minItems": 2,
      +                  "type": "array"
      +                }
      +              },
      +              "required": [
      +                "options"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "A native Telegram poll. The post text is the question (max 300 chars). No media with a poll. On update_post, null removes it."
      +        },
      +        "protect_content": {
      +          "anyOf": [
      +            {
      +              "type": "boolean"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Stop forwarding and saving of the post in Telegram apps."
      +        },
      +        "silent": {
      +          "anyOf": [
      +            {
      +              "type": "boolean"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Send without a notification sound."
      +        },
      +        "spoiler": {
      +          "anyOf": [
      +            {
      +              "type": "boolean"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Blur the photos and videos until someone taps them."
      +        }
      +      },
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "Telegram options. Text up to 4,096 chars; with media, text over 1,024 chars is sent as a reply under the media. Up to 10 photos and videos per album, videos up to 50 MB, no Stories. A 'reel' is sent as a video message."
      +}
  9. Changed1 schema field changed
    • changedInput schema / properties / pinterest / properties / product_tags / description
      Previous value: -"Products to tag on the Pin, so people can shop the items in the image. Up to 24 product Pins of the connected Pinterest account, each as a Pin ID string or a Pin link (https://www.pinterest.com/pin/<id>/). Get the IDs with list_pinterest_products. Only the account's own product Pins can be tagged (public, with a link on a website the account claimed on Pinterest); products of other merchants cannot. The tags are added right after the Pin is published; a product Pinterest refuses never fails the post, and get_post shows the outcome (product_tags_result). On update_post the pinterest object replaces the stored one, so leave product_tags out to remove the tags."New value: +"Product Pins to tag on the Pin (Pinterest shows the tagged items on the image). Up to 24 product Pins of the connected Pinterest account, each as a Pin ID string or a Pin link (https://www.pinterest.com/pin/<id>/). Get the IDs with list_pinterest_products. Only the account's own product Pins can be tagged (public, with a link on a website the account claimed on Pinterest); products of other merchants cannot. The tags are added right after the Pin is published; a product Pinterest refuses never fails the post, and get_post shows the outcome (product_tags_result). On update_post the pinterest object replaces the stored one, so leave product_tags out to remove the tags."
  10. Changed4 schema fields changed
    • addedInput schema / properties / comment_dm_automation
      Added value: +{
      +  "anyOf": [
      +    {
      +      "description": "Comment-to-DM automation on this post: when somebody comments one of trigger.keywords on the post once it is live on Instagram, the account DMs them actions.dm.text once, and optionally posts one of actions.public_reply.variations under the comment. Instagram must be in channels. Show the user the keywords and the exact DM text before creating it. The created automation comes back as comment_dm_automation on the post; manage it later with update_automation / get_automation_activity.",
      +      "properties": {
      +        "actions": {
      +          "properties": {
      +            "dm": {
      +              "properties": {
      +                "text": {
      +                  "description": "The DM the person receives, once (max 1000 characters). Confirm the text with the user: it goes out in their name.",
      +                  "maxLength": 1000,
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "text"
      +              ],
      +              "type": "object"
      +            },
      +            "public_reply": {
      +              "properties": {
      +                "enabled": {
      +                  "type": "boolean"
      +                },
      +                "variations": {
      +                  "description": "Public replies posted under the comment, one picked at random per comment.",
      +                  "items": {
      +                    "maxLength": 300,
      +                    "type": "string"
      +                  },
      +                  "maxItems": 10,
      +                  "type": "array"
      +                }
      +              },
      +              "type": "object"
      +            }
      +          },
      +          "required": [
      +            "dm"
      +          ],
      +          "type": "object"
      +        },
      +        "limits": {
      +          "properties": {
      +            "max_sends": {
      +              "anyOf": [
      +                {
      +                  "exclusiveMinimum": 0,
      +                  "maximum": 9007199254740991,
      +                  "type": "integer"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "description": "Stop after this many DMs."
      +            },
      +            "stop_at": {
      +              "anyOf": [
      +                {
      +                  "type": "string"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "description": "Stop at this time (ISO 8601)."
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "trigger": {
      +          "properties": {
      +            "keywords": {
      +              "description": "Keywords that start the automation, matched case-insensitively (up to 20). Required unless match is 'any'.",
      +              "items": {
      +                "type": "string"
      +              },
      +              "maxItems": 20,
      +              "type": "array"
      +            },
      +            "match": {
      +              "description": "word (default): the keyword stands on its own. contains: anywhere in the comment. any: every comment (ask the user first).",
      +              "enum": [
      +                "word",
      +                "contains",
      +                "any"
      +              ],
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        }
      +      },
      +      "required": [
      +        "actions"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "Replaces the post's comment-to-DM automation (keywords, DM text, public replies, limits); pass null to remove it; omit to leave it untouched."
      +}
    • changedInput schema / properties / google_business / properties / event / description
      Previous value: -"Required when topic_type is EVENT."New value: +"Required when topic_type is EVENT or OFFER. For an OFFER, the title is the offer's name and the schedule its validity period (Google rejects an offer without it)."
    • addedInput schema / properties / media_fit
      Added value: +{
      +  "additionalProperties": {
      +    "enum": [
      +      "auto",
      +      "crop",
      +      "keep"
      +    ],
      +    "type": "string"
      +  },
      +  "description": "Image fit per channel, for feed images (type 'post') whose ratio is outside what a channel shows uncropped: { instagram: 'auto' | 'crop' | 'keep', pinterest: ... }. 'auto' (the default when omitted) takes the channel's rule: Instagram crops a tall (9:16) or wide image to 4:5 / 1.91:1 around the subject (Instagram cuts it to that window anyway, and Meta cannot boost a feed post outside it); Pinterest keeps a Pin taller than 2:3 and only reports it. 'crop' / 'keep' force it for that channel. Every decision comes back in the response `warnings` with code `image_fit` (relay it). The crop is a separate file for that channel only; 'default' and the other channels keep the original. On update_post, media_fit alone (no media) re-decides the stored images: 'keep' gives the original back, 'crop' crops an image that was kept.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • changedInput schema / properties / youtube / properties / title / description
      Previous value: -"Short title shown on YouTube. Falls back to \"YouTube Short\" when omitted."New value: +"Short title shown on YouTube (max 100 characters). When omitted, the first line of the caption is used; \"YouTube Short\" only when there is no caption either."
  11. Changed1 schema field changed
    • addedInput schema / properties / pinterest / properties / product_tags
      Added value: +{
      +  "description": "Products to tag on the Pin, so people can shop the items in the image. Up to 24 product Pins of the connected Pinterest account, each as a Pin ID string or a Pin link (https://www.pinterest.com/pin/<id>/). Get the IDs with list_pinterest_products. Only the account's own product Pins can be tagged (public, with a link on a website the account claimed on Pinterest); products of other merchants cannot. The tags are added right after the Pin is published; a product Pinterest refuses never fails the post, and get_post shows the outcome (product_tags_result). On update_post the pinterest object replaces the stored one, so leave product_tags out to remove the tags.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "maxItems": 24,
      +  "type": "array"
      +}
  12. Changed5 schema fields changed
    • addedInput schema / properties / facebook / properties / cover_url
      Added value: +{
      +  "description": "Custom thumbnail image URL (JPEG/PNG, max 10 MB). Used with thumbnail_type 'from-library'.",
      +  "type": "string"
      +}
    • addedInput schema / properties / facebook / properties / thumb_offset
      Added value: +{
      +  "description": "Frame timestamp in MILLISECONDS from the start of the video (e.g. 3000 = 0:03). Used with thumbnail_type 'from-video'.",
      +  "type": "number"
      +}
    • addedInput schema / properties / facebook / properties / thumbnail_type
      Added value: +{
      +  "anyOf": [
      +    {
      +      "enum": [
      +        "from-video",
      +        "from-library"
      +      ],
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "Video thumbnail for Facebook feed videos and reels: 'from-video' uses the frame at thumb_offset, 'from-library' uploads the image at cover_url. Applied after the video is live; a thumbnail failure never fails the post. On update_post, null removes the Facebook override."
      +}
    • addedInput schema / properties / video_cover
      Added value: +{
      +  "anyOf": [
      +    {
      +      "description": "Video thumbnail for a post whose media is ONE video. Applied on Instagram (feed videos and reels), Facebook (feed videos and reels), LinkedIn Profile and Page, TikTok, Pinterest and YouTube Shorts. YouTube Shorts: the cover shows on Shorts only on channels where YouTube has enabled custom Shorts thumbnails (rolling out since July 2026, Partner Program channels first); on other channels YouTube stores it as the default thumbnail but shows a frame from the video on Shorts. Say that it depends on the channel; do not promise it. TikTok only takes a frame: a 'custom' cover is skipped there, so add a tiktok override with type 'frame' when the user wants a specific TikTok frame. The per-platform reel fields (instagram.thumb_offset / cover_url, tiktok.video_cover_timestamp_ms, pinterest.video_cover) keep working and win over the base cover for their platform. get_post reads it back as `video_cover`.",
      +      "properties": {
      +        "cover_url": {
      +          "description": "Public image URL, JPEG or PNG (type 'custom').",
      +          "type": "string"
      +        },
      +        "overrides": {
      +          "additionalProperties": {
      +            "anyOf": [
      +              {
      +                "properties": {
      +                  "cover_url": {
      +                    "description": "Public image URL, JPEG or PNG (type 'custom').",
      +                    "type": "string"
      +                  },
      +                  "thumb_offset": {
      +                    "description": "Milliseconds into the video (type 'frame'). 3000 = 0:03.",
      +                    "maximum": 9007199254740991,
      +                    "minimum": 0,
      +                    "type": "integer"
      +                  },
      +                  "type": {
      +                    "description": "'frame' uses the video frame at thumb_offset; 'custom' uploads the image at cover_url.",
      +                    "enum": [
      +                      "frame",
      +                      "custom"
      +                    ],
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "type"
      +                ],
      +                "type": "object"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "description": "Per-platform overrides keyed by platform id (instagram, facebook, linkedin, linkedin_page, tiktok, pinterest, youtube). An override wins over the base cover for that platform.",
      +          "propertyNames": {
      +            "type": "string"
      +          },
      +          "type": "object"
      +        },
      +        "thumb_offset": {
      +          "description": "Milliseconds into the video (type 'frame'). 3000 = 0:03.",
      +          "maximum": 9007199254740991,
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "type": {
      +          "description": "'frame' uses the video frame at thumb_offset; 'custom' uploads the image at cover_url.",
      +          "enum": [
      +            "frame",
      +            "custom"
      +          ],
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "type"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "Replaces the stored video cover wholesale; pass null to remove it; omit to leave it untouched. facebook.thumbnail_type / thumb_offset / cover_url merge into overrides.facebook on their own."
      +}
    • changedInput schema / properties / youtube / description
      Previous value: -"YouTube Shorts options. Only applies when type is 'reel' and youtube is among the selected channels."New value: +"YouTube Shorts options. Only applies when type is 'reel' and youtube is among the selected channels. A custom Shorts thumbnail is set with the top-level `video_cover` (a `youtube` override for a YouTube-only image); it shows on Shorts only on channels where YouTube has enabled custom Shorts thumbnails (Partner Program channels first, since July 2026), other channels show a frame from the video."
  13. First observed

TDQS

A4/5.0
Behavior4/5

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

Annotations already declare destructiveHint=true and openWorldHint=true, so the safety profile is known. The description still adds genuine behavior: edits are limited to draft/scheduled state, thread conversion happens via x.thread_parts and is reverted with null, and the caption does not rename a Short. It omits the wholesale-replacement semantics for nested objects, but the schema covers those.

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

Conciseness4/5

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

Three short paragraphs with bold lead-ins and the purpose front-loaded; each paragraph targets a distinct gotcha (per-platform objects, YouTube fields, X threads). Some content duplicates the schema's own property descriptions, which keeps it from a 5.

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

Completeness3/5

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

For a 32-parameter, deeply nested mutation tool with no output schema, the description covers only the most common pitfalls (per-platform objects, YouTube title, X threads). It never states the top-level partial-update model (which omitted fields are preserved vs. replaced) or what the response contains, leaving the schema to carry most of the weight.

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

Parameters3/5

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

Schema coverage is 94%, so the baseline is 3. The description's highlight—title vs. content on YouTube Shorts—is already spelled out in the `content` and `youtube.title` property descriptions, and the `thread_parts` null-revert rule is likewise in the schema, so it adds little beyond what the schema already gives.

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 opening states a specific verb and resource ("Update an existing post") and immediately narrows the scope with "Only draft and scheduled posts can be updated," which lets an agent decide eligibility without opening the schema. It is clearly an edit operation distinct from create_post, which it references only for parameter shape.

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

Usage Guidelines4/5

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

The draft/scheduled restriction is a real when-not rule, and the per-platform pointer to create_post clarifies how to shape nested options. It stops short of routing published posts elsewhere (e.g., delete_post, or an edit flow) and never names an alternative tool for the cases it excludes.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources