AdaptlyPost

Update Post

update_post

Destructive

Update a DRAFT or SCHEDULED post in place; any other status fails with "Cannot edit post in current state", so published posts cannot be changed. Updates are partial: text, contentType, scheduledAt, timezone, thumbnail fields, firstComments and platformThumbnails you omit keep their values; sending firstComments or platformThumbnails replaces every stored entry. The exception is platforms: sending it rebuilds the post's target set from this request alone, so include every connection-id array and platform config you want to keep (TikTok with privacyLevel, Pinterest with its boardId or boardName); omitting platforms leaves accounts, configs, and media untouched. mediaUrls only take effect together with platforms; use publicUrl values from upload_media. On SCHEDULED posts new media is verified in storage. Returns the updated post record. Use publish_draft to change a draft's status, unschedule_post to take a scheduled post off the calendar, delete_post to cancel, and create_post for a new post.

Input Schema

Name	Required	Description
`id`	Yes	Post ID to update (must be DRAFT or SCHEDULED)
`text`	No	Updated text; omit to keep the current text. On LinkedIn, mention a company page with @[Page Name](urn:li:organization:<id>), using the page name exactly as LinkedIn shows it
`pageIds`	No	Facebook page account ids from list_accounts (the account id; its pageId value is also accepted). Facebook has no connection-id array
`timezone`	No	IANA timezone stored for display; does not shift scheduledAt
`mediaUrls`	No	Replacement media URLs, applied only when platforms is also sent. Use publicUrl values from upload_media or get_upload_urls
`platforms`	No	New target platforms. Sending this replaces every target, so also resend the connection-id arrays and platform configs to keep; omit to leave targets unchanged
`contentType`	No	New content type; must match the media on the post. CAROUSEL takes 2 or more items in mediaUrls, up to 4 on TWITTER, BLUESKY and MASTODON, 5 on PINTEREST, 10 on INSTAGRAM, FACEBOOK, THREADS and TELEGRAM, 20 on LINKEDIN, 30 on TUMBLR and 35 on TIKTOK (JPEG or WebP photos only). INSTAGRAM and THREADS accept images and videos in the same carousel; every other platform takes images only, and YOUTUBE has no carousel. GOOGLE_BUSINESS takes TEXT or IMAGE with one JPEG or PNG image up to 5 MB, and text up to 1500 characters. DOCUMENT publishes one PDF, PPT, PPTX, DOC or DOCX file (max 100 MB, 300 pages) as a LinkedIn document post and is LinkedIn only: put exactly that one file in mediaUrls, target only LINKEDIN, and set the title with linkedinConfigs
`scheduledAt`	No	New schedule time as an absolute ISO 8601 instant; omit to keep. On a DRAFT it sets the planned date and the post stays a draft. Moving a SCHEDULED post more than a minute into the past fails with 400; use publish_draft to publish now
`workspaceId`	No	Workspace to act in: an id from list_workspaces. Omit to act in the workspace list_workspaces marks current. Use the same workspaceId for every call about the same workspace, since ids from one workspace (accounts, posts, uploads) do not exist in another
`thumbnailUrl`	No	Video thumbnail as an https URL or an image data URI, used on every platform that takes one unless platformThumbnails overrides it
`firstComments`	No	A comment posted from the same account right after the post goes out on a platform, one entry per platform. Available on LINKEDIN (1250 characters), TWITTER (280, as a reply), THREADS (500, as a reply), BLUESKY (300, as a reply), MASTODON (500, as a reply), YOUTUBE (10000), FACEBOOK (8000) and INSTAGRAM (2200). A platform the post does not go to, an empty or too long comment, a second entry for one platform, a platform that also has threadReplies, a private or made for kids YouTube video and Facebook or Instagram stories are refused with 400. The comment is posted about 10 seconds after the platform publishes (60 on YouTube) and retried up to 3 times; on X it is not retried, and a lifetime-deal account pays for it like any X post. A Facebook Page or Instagram account connected before first comments came to them must be reconnected once; until then its comment fails and firstCommentError says to reconnect. A comment that fails never fails the post: read firstCommentStatus and firstCommentError on the platform in get_post. On an update, sending the array replaces every first comment and omitting it keeps the stored ones
`mediaAltTexts`	No	Alt text per image, in the same order as mediaUrls (max 1000 characters each; use "" to skip an image). Sent to X, Bluesky, Mastodon, Tumblr, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube, Google Business Profile and videos ignore it. Applied only when platforms is also sent
`platformTexts`	No	Per-platform caption overrides; applied to the targets sent in platforms
`threadReplies`	No	Turns the post into a thread: the post opens it and each text is published as a reply to the one before, from the same account, one entry per platform. Available on TWITTER (280 characters per reply, or the account's own limit on X Premium), THREADS (500), BLUESKY (300) and MASTODON (500, or the instance's limit), up to 25 replies. A platform the post does not go to, an empty or too long reply, more than 25 replies, a second entry for one platform and a platform that also has a first comment are refused with 400. An entry with an empty texts array removes the thread. Replies start about 10 seconds after the platform publishes, 2 seconds apart. A failed run is retried up to 3 times and resumes after the last reply that went out; on X it is not retried, and a lifetime-deal account pays for each reply like any X post. A thread that fails never fails the post: read threadStatus, threadReplyIds and threadError on the platform in get_post. On an update, sending the array replaces every thread and omitting it keeps the stored ones
`tiktokConfigs`	No	TikTok per-connection config. Each entry needs connectionId + privacyLevel at minimum
`tumblrConfigs`	No	Tumblr per-blog config: tags, a title and a source link. connectionId must match an entry in tumblrConnectionIds
`youtubeConfigs`	No	YouTube per-connection config with video title, tags, privacy, etc.
`facebookConfigs`	No	Facebook per-page config: post type, shareToStory, video title, text background, and a grid or link carousel for several images. pageId must match an entry in pageIds
`linkedinConfigs`	No	LinkedIn per-connection config: documentTitle names a DOCUMENT post, reshareOf reshares another LinkedIn post with the text as commentary. connectionId must match an entry in linkedinConnectionIds
`instagramConfigs`	No	Instagram per-connection config: post type (FEED, REEL, STORY), shareToStory, collaborators, user tags, the AI info label, Reel audio, and trial reels
`pinterestConfigs`	No	Pinterest per-connection config: the board to pin to, a pin title and a destination link. Get boardId from list_pinterest_boards for that connectionId, or pass the board name as boardName instead (not both); a board belongs to one Pinterest account. A boardName that matches no board or several fails with 400. Without either the pin goes to a board named AdaptlyPost
`twitterKeepLinks`	No	Keep links in the X text clickable. X charges over 10 times more for a post with a link, so by default every link in X text is broken (example.com becomes example. com). Only AppSumo lifetime deals can turn this on, and a kept link costs 20 credits instead of 2. true on any other plan is refused with 400; it is ignored when the X text has no link
`platformThumbnails`	No	A different thumbnail for one platform of a VIDEO post, one entry per platform. A platform without an entry uses the post-level thumbnailUrl and thumbnailTimestampMs. YOUTUBE, FACEBOOK, LINKEDIN and TELEGRAM take an image (thumbnailUrl); INSTAGRAM and PINTEREST take an image or a frame (thumbnailTimestampMs), the image winning when both are sent; TIKTOK takes only a frame. Posts that are not videos, Facebook and Instagram stories, a second entry for one platform and an entry the platform cannot use are refused with 400. On an update, sending the array replaces every override and omitting it keeps the stored ones
`tiktokConnectionIds`	No	TikTok account connection IDs to post from
`tumblrConnectionIds`	No	Tumblr blogs to post to, by the account id from list_accounts. TUMBLR takes text up to 32768 characters, up to 30 JPEG, PNG or GIF images (10 MB each) or one MP4 video (500 MB, up to 10 minutes), and alt text; it has no first comments, threads, per-platform thumbnails, image shapes or analytics
`blueskyConnectionIds`	No	Bluesky account connection IDs to post from
`platformAspectRatios`	No	Reframe every image of an IMAGE or CAROUSEL post to one shape on a platform, one entry per platform. INSTAGRAM takes SQUARE, PORTRAIT or LANDSCAPE (Instagram refuses 9:16 feed and carousel images); TIKTOK takes all four. Video posts, Instagram stories and a second entry for the same platform are refused with 400. Omit a platform to keep its images as uploaded. On an update it applies to the mediaUrls sent in the same request
`threadsConnectionIds`	No	Threads account connection IDs to post from
`thumbnailTimestampMs`	No	Video frame timestamp (ms) to use as the thumbnail, used by INSTAGRAM, PINTEREST and TIKTOK unless platformThumbnails overrides it
`twitterConnectionIds`	No	X (Twitter) account connection IDs to post from
`youtubeConnectionIds`	No	YouTube channel connection IDs to post from
`googleBusinessConfigs`	No	Google Business Profile per-location config: update, event or offer, plus a button. connectionId must match an entry in googleBusinessConnectionIds. GOOGLE_BUSINESS takes TEXT or IMAGE with one JPEG or PNG image up to 5 MB, and text up to 1500 characters
`linkedinConnectionIds`	No	LinkedIn account connection IDs to post from
`mastodonConnectionIds`	No	Mastodon account connection IDs to post from
`telegramConnectionIds`	No	Telegram channels and groups to post to, by the account id from list_accounts. TELEGRAM takes text up to 4096 characters, up to 10 images (JPEG, PNG or WebP, 10 MB each) or one MP4 or MOV video (50 MB); a caption over 1024 characters goes out as its own message after the media
`instagramConnectionIds`	No	Instagram account connection IDs to post from
`pinterestConnectionIds`	No	Pinterest account connection IDs to post from
`googleBusinessConnectionIds`	No	Google Business Profile locations to post to, by the account id from list_accounts. A location without an entry in googleBusinessConfigs gets a STANDARD update

Output Schema

Name	Required	Description	Default
`result`	No	The updated post record: id, status (still DRAFT or SCHEDULED), text, contentType, scheduledAt, timezone, and platforms with per-target details.

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 28, 2026

changedInput schema / properties / scheduledAt / description

Previous value: -"New schedule time as an absolute ISO 8601 instant; omit to keep. Moving a SCHEDULED post more than a minute into the past fails with 400; use publish_draft to publish now"New value: +"New schedule time as an absolute ISO 8601 instant; omit to keep. On a DRAFT it sets the planned date and the post stays a draft. Moving a SCHEDULED post more than a minute into the past fails with 400; use publish_draft to publish now"

Changed1 schema field changedOct 27, 2026

changedInput schema / properties / tumblrConnectionIds / description

Previous value: -"Tumblr blog account ids from list_accounts to post to"New value: +"Tumblr blogs to post to, by the account id from list_accounts. TUMBLR takes text up to 32768 characters, up to 30 JPEG, PNG or GIF images (10 MB each) or one MP4 video (500 MB, up to 10 minutes), and alt text; it has no first comments, threads, per-platform thumbnails, image shapes or analytics"

Changed20 schema fields changedOct 27, 2026

changedInput schema / properties / contentType / description

Previous value: -"New content type; must match the media on the post. CAROUSEL takes 2 or more items in mediaUrls, up to 4 on TWITTER, BLUESKY and MASTODON, 5 on PINTEREST, 10 on INSTAGRAM, FACEBOOK and THREADS, 20 on LINKEDIN and 35 on TIKTOK (JPEG or WebP photos only). INSTAGRAM and THREADS accept images and videos in the same carousel; every other platform takes images only, and YOUTUBE has no carousel. GOOGLE_BUSINESS takes TEXT or IMAGE with one JPEG or PNG image up to 5 MB, and text up to 1500 characters. DOCUMENT publishes one PDF, PPT, PPTX, DOC or DOCX file (max 100 MB, 300 pages) as a LinkedIn document post and is LinkedIn only: put exactly that one file in mediaUrls, target only LINKEDIN, and set the title with linkedinConfigs"New value: +"New content type; must match the media on the post. CAROUSEL takes 2 or more items in mediaUrls, up to 4 on TWITTER, BLUESKY and MASTODON, 5 on PINTEREST, 10 on INSTAGRAM, FACEBOOK, THREADS and TELEGRAM, 20 on LINKEDIN, 30 on TUMBLR and 35 on TIKTOK (JPEG or WebP photos only). INSTAGRAM and THREADS accept images and videos in the same carousel; every other platform takes images only, and YOUTUBE has no carousel. GOOGLE_BUSINESS takes TEXT or IMAGE with one JPEG or PNG image up to 5 MB, and text up to 1500 characters. DOCUMENT publishes one PDF, PPT, PPTX, DOC or DOCX file (max 100 MB, 300 pages) as a LinkedIn document post and is LinkedIn only: put exactly that one file in mediaUrls, target only LINKEDIN, and set the title with linkedinConfigs"

changedInput schema / properties / facebookConfigs / description

Previous value: -"Facebook per-page config: post type, shareToStory, video title and text background. pageId must match an entry in pageIds"New value: +"Facebook per-page config: post type, shareToStory, video title, text background, and a grid or link carousel for several images. pageId must match an entry in pageIds"

addedInput schema / properties / facebookConfigs / items / properties / carouselCards

Added value: +{
+  "description": "One card per image, in the same order as the media, used when imageLayout is CAROUSEL. Facebook only shows your image, title and description on a card whose link points to a website the Page owns; for any other link the post fails with the error Facebook returns",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "description": {
+        "description": "The line under the headline, such as a price or the domain. Without it Facebook uses the linked page",
+        "maxLength": 200,
+        "type": "string"
+      },
+      "link": {
+        "description": "The http or https URL the card opens",
+        "maxLength": 2048,
+        "type": "string"
+      },
+      "title": {
+        "description": "The card's headline. Without it Facebook uses the linked page's title",
+        "maxLength": 100,
+        "type": "string"
+      }
+    },
+    "required": [
+      "link"
+    ],
+    "type": "object"
+  },
+  "maxItems": 5,
+  "type": "array"
+}

addedInput schema / properties / facebookConfigs / items / properties / imageLayout

Added value: +{
+  "description": "How a post with several images shows on Facebook. GRID is a photo grid. CAROUSEL is a swipeable carousel where each image is a card with its own link, and needs 2 to 5 images, no videos, postType FEED and one carouselCards entry per image; anything else is refused with 400",
+  "enum": [
+    "GRID",
+    "CAROUSEL"
+  ],
+  "type": "string"
+}

changedInput schema / properties / firstComments / description

Previous value: -"A comment posted from the same account right after the post goes out on a platform, one entry per platform. Available on LINKEDIN (1250 characters), TWITTER (280, as a reply), THREADS (500, as a reply), BLUESKY (300, as a reply), MASTODON (500, as a reply) and YOUTUBE (10000). A platform the post does not go to, an empty or too long comment, a second entry for one platform, a private or made for kids YouTube video and Facebook or Instagram stories are refused with 400. The comment is posted about 10 seconds after the platform publishes (60 on YouTube) and retried up to 3 times; on X it is not retried, and a lifetime-deal account pays for it like any X post. A comment that fails never fails the post: read firstCommentStatus and firstCommentError on the platform in get_post. On an update, sending the array replaces every first comment and omitting it keeps the stored ones"New value: +"A comment posted from the same account right after the post goes out on a platform, one entry per platform. Available on LINKEDIN (1250 characters), TWITTER (280, as a reply), THREADS (500, as a reply), BLUESKY (300, as a reply), MASTODON (500, as a reply), YOUTUBE (10000), FACEBOOK (8000) and INSTAGRAM (2200). A platform the post does not go to, an empty or too long comment, a second entry for one platform, a platform that also has threadReplies, a private or made for kids YouTube video and Facebook or Instagram stories are refused with 400. The comment is posted about 10 seconds after the platform publishes (60 on YouTube) and retried up to 3 times; on X it is not retried, and a lifetime-deal account pays for it like any X post. A Facebook Page or Instagram account connected before first comments came to them must be reconnected once; until then its comment fails and firstCommentError says to reconnect. A comment that fails never fails the post: read firstCommentStatus and firstCommentError on the platform in get_post. On an update, sending the array replaces every first comment and omitting it keeps the stored ones"

changedInput schema / properties / firstComments / items / properties / platform / enum

Previous value: -[
-  "LINKEDIN",
-  "TWITTER",
-  "THREADS",
-  "BLUESKY",
-  "MASTODON",
-  "YOUTUBE"
-]New value: +[
+  "LINKEDIN",
+  "TWITTER",
+  "THREADS",
+  "BLUESKY",
+  "MASTODON",
+  "YOUTUBE",
+  "FACEBOOK",
+  "INSTAGRAM"
+]

changedInput schema / properties / instagramConfigs / description

Previous value: -"Instagram per-connection config: post type (FEED, REEL, STORY), shareToStory, collaborators, Reel audio, and trial reels"New value: +"Instagram per-connection config: post type (FEED, REEL, STORY), shareToStory, collaborators, user tags, the AI info label, Reel audio, and trial reels"

addedInput schema / properties / instagramConfigs / items / properties / aiGenerated

Added value: +{
+  "description": "Disclose that the post was made or edited with AI. Instagram shows its \"AI info\" label on the post. Works on images, carousels, reels and stories, and a story made with shareToStory carries the label too. Omit it or send false for no label",
+  "type": "boolean"
+}

addedInput schema / properties / instagramConfigs / items / properties / userTags

Added value: +{
+  "description": "Public Instagram accounts tagged in the media, up to 20. Works on a single image, a single video (published as a Reel) or a single story; a carousel or several stories with tags is refused with 400. On a feed image every tag needs x and y; on a story they are optional, and on a video they are ignored because the person is tagged on the video as a whole. A leading @ is stripped and a repeated username keeps its first entry. If Instagram refuses a tag because the account is private or does not exist, the post goes out without its tags and instagramUntaggedUsernames in get_post lists the refused usernames",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "username": {
+        "description": "The public Instagram username to tag",
+        "pattern": "^@?[A-Za-z0-9._]{1,30}$",
+        "type": "string"
+      },
+      "x": {
+        "description": "Horizontal position of the tag on the image, from 0 (left edge) to 1 (right edge)",
+        "maximum": 1,
+        "minimum": 0,
+        "type": "number"
+      },
+      "y": {
+        "description": "Vertical position of the tag on the image, from 0 (top edge) to 1 (bottom edge)",
+        "maximum": 1,
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "username"
+    ],
+    "type": "object"
+  },
+  "maxItems": 20,
+  "type": "array"
+}

changedInput schema / properties / linkedinConfigs / description

Previous value: -"LinkedIn per-connection config: documentTitle names a DOCUMENT post. connectionId must match an entry in linkedinConnectionIds"New value: +"LinkedIn per-connection config: documentTitle names a DOCUMENT post, reshareOf reshares another LinkedIn post with the text as commentary. connectionId must match an entry in linkedinConnectionIds"

addedInput schema / properties / linkedinConfigs / items / properties / reshareOf

Added value: +{
+  "description": "Reshare this LinkedIn post from the account, with the post text as the commentary. Takes a urn:li:share: or urn:li:ugcPost: URN, such as the platformPostId from list_post_results, or a LinkedIn post link of the form https://www.linkedin.com/feed/update/<urn>, which is also the link inside a post's Embed code. urn:li:activity: links are refused because LinkedIn cannot reshare them through its API. Media on the post is not attached on this account",
+  "maxLength": 500,
+  "type": "string"
+}

changedInput schema / properties / mediaAltTexts / description

Previous value: -"Alt text per image, in the same order as mediaUrls (max 1000 characters each; use \"\" to skip an image). Sent to X, Bluesky, Mastodon, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube, Google Business Profile and videos ignore it. Applied only when platforms is also sent"New value: +"Alt text per image, in the same order as mediaUrls (max 1000 characters each; use \"\" to skip an image). Sent to X, Bluesky, Mastodon, Tumblr, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube, Google Business Profile and videos ignore it. Applied only when platforms is also sent"

changedInput schema / properties / platformThumbnails / description

Previous value: -"A different thumbnail for one platform of a VIDEO post, one entry per platform. A platform without an entry uses the post-level thumbnailUrl and thumbnailTimestampMs. YOUTUBE, FACEBOOK and LINKEDIN take an image (thumbnailUrl); INSTAGRAM and PINTEREST take an image or a frame (thumbnailTimestampMs), the image winning when both are sent; TIKTOK takes only a frame. Posts that are not videos, Facebook and Instagram stories, a second entry for one platform and an entry the platform cannot use are refused with 400. On an update, sending the array replaces every override and omitting it keeps the stored ones"New value: +"A different thumbnail for one platform of a VIDEO post, one entry per platform. A platform without an entry uses the post-level thumbnailUrl and thumbnailTimestampMs. YOUTUBE, FACEBOOK, LINKEDIN and TELEGRAM take an image (thumbnailUrl); INSTAGRAM and PINTEREST take an image or a frame (thumbnailTimestampMs), the image winning when both are sent; TIKTOK takes only a frame. Posts that are not videos, Facebook and Instagram stories, a second entry for one platform and an entry the platform cannot use are refused with 400. On an update, sending the array replaces every override and omitting it keeps the stored ones"

changedInput schema / properties / platformThumbnails / items / properties / platform / enum

Previous value: -[
-  "YOUTUBE",
-  "FACEBOOK",
-  "LINKEDIN",
-  "INSTAGRAM",
-  "PINTEREST",
-  "TIKTOK"
-]New value: +[
+  "YOUTUBE",
+  "FACEBOOK",
+  "LINKEDIN",
+  "TELEGRAM",
+  "INSTAGRAM",
+  "PINTEREST",
+  "TIKTOK"
+]

changedInput schema / properties / platforms / items / enum

Previous value: -[
-  "LINKEDIN",
-  "YOUTUBE",
-  "INSTAGRAM",
-  "FACEBOOK",
-  "TIKTOK",
-  "PINTEREST",
-  "THREADS",
-  "BLUESKY",
-  "TWITTER",
-  "MASTODON",
-  "GOOGLE_BUSINESS"
-]New value: +[
+  "LINKEDIN",
+  "YOUTUBE",
+  "INSTAGRAM",
+  "FACEBOOK",
+  "TIKTOK",
+  "PINTEREST",
+  "THREADS",
+  "BLUESKY",
+  "TWITTER",
+  "MASTODON",
+  "GOOGLE_BUSINESS",
+  "TUMBLR",
+  "TELEGRAM"
+]

addedInput schema / properties / telegramConnectionIds

Added value: +{
+  "description": "Telegram channels and groups to post to, by the account id from list_accounts. TELEGRAM takes text up to 4096 characters, up to 10 images (JPEG, PNG or WebP, 10 MB each) or one MP4 or MOV video (50 MB); a caption over 1024 characters goes out as its own message after the media",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedInput schema / properties / threadReplies

Added value: +{
+  "description": "Turns the post into a thread: the post opens it and each text is published as a reply to the one before, from the same account, one entry per platform. Available on TWITTER (280 characters per reply, or the account's own limit on X Premium), THREADS (500), BLUESKY (300) and MASTODON (500, or the instance's limit), up to 25 replies. A platform the post does not go to, an empty or too long reply, more than 25 replies, a second entry for one platform and a platform that also has a first comment are refused with 400. An entry with an empty texts array removes the thread. Replies start about 10 seconds after the platform publishes, 2 seconds apart. A failed run is retried up to 3 times and resumes after the last reply that went out; on X it is not retried, and a lifetime-deal account pays for each reply like any X post. A thread that fails never fails the post: read threadStatus, threadReplyIds and threadError on the platform in get_post. On an update, sending the array replaces every thread and omitting it keeps the stored ones",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "platform": {
+        "enum": [
+          "TWITTER",
+          "THREADS",
+          "BLUESKY",
+          "MASTODON"
+        ],
+        "type": "string"
+      },
+      "texts": {
+        "description": "The replies in order, each trimmed. The limit per reply depends on the platform, see threadReplies",
+        "items": {
+          "type": "string"
+        },
+        "maxItems": 25,
+        "type": "array"
+      }
+    },
+    "required": [
+      "platform",
+      "texts"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedInput schema / properties / tumblrConfigs

Added value: +{
+  "description": "Tumblr per-blog config: tags, a title and a source link. connectionId must match an entry in tumblrConnectionIds",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "connectionId": {
+        "description": "Tumblr blog account id from list_accounts",
+        "type": "string"
+      },
+      "sourceUrl": {
+        "description": "Shown as the source link of the post",
+        "maxLength": 2048,
+        "type": "string"
+      },
+      "tags": {
+        "description": "Tumblr tags, without commas, up to 30. A leading # is stripped and duplicates are dropped, ignoring case",
+        "items": {
+          "type": "string"
+        },
+        "maxItems": 30,
+        "type": "array"
+      },
+      "title": {
+        "description": "Shown as a heading above the media and the text",
+        "maxLength": 4096,
+        "type": "string"
+      }
+    },
+    "required": [
+      "connectionId"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedInput schema / properties / tumblrConnectionIds

Added value: +{
+  "description": "Tumblr blog account ids from list_accounts to post to",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedInput schema / properties / youtubeConfigs / items / properties / aiGenerated

Added value: +{
+  "description": "Disclose altered or synthetic content, such as an AI voice, an AI avatar or realistic footage that was generated or edited. YouTube shows its \"Altered or synthetic content\" label on the video. Omit it or send false for no label",
+  "type": "boolean"
+}

Changed3 schema fields changedOct 14, 2026

changedInput schema / properties / pinterestConfigs / description

Previous value: -"Pinterest per-connection config: the board to pin to, a pin title and a destination link. Get boardId from list_pinterest_boards for that connectionId; a board belongs to one Pinterest account. Without boardId the pin goes to a board named AdaptlyPost"New value: +"Pinterest per-connection config: the board to pin to, a pin title and a destination link. Get boardId from list_pinterest_boards for that connectionId, or pass the board name as boardName instead (not both); a board belongs to one Pinterest account. A boardName that matches no board or several fails with 400. Without either the pin goes to a board named AdaptlyPost"

changedInput schema / properties / pinterestConfigs / items / properties / boardId / description

Previous value: -"Board id from list_pinterest_boards. Leave out to pin to a public board named AdaptlyPost, created on the account the first time it is needed"New value: +"Board id from list_pinterest_boards. Leave out boardId and boardName to pin to a public board named AdaptlyPost, created on the account the first time it is needed"

addedInput schema / properties / pinterestConfigs / items / properties / boardName

Added value: +{
+  "description": "The board's name, instead of boardId; never send both. Matched against this account's boards, exact first, then case-insensitive. A name no board has, or one several boards share, fails with 400 and never falls back to another board",
+  "maxLength": 180,
+  "minLength": 1,
+  "type": "string"
+}

Changed3 schema fields changedOct 13, 2026

changedInput schema / properties / pinterestConfigs / description

Previous value: -"Pinterest per-connection config. Each entry needs connectionId + boardId; there is no API to list boards, so ask the user for the board id"New value: +"Pinterest per-connection config: the board to pin to, a pin title and a destination link. Get boardId from list_pinterest_boards for that connectionId; a board belongs to one Pinterest account. Without boardId the pin goes to a board named AdaptlyPost"

changedInput schema / properties / pinterestConfigs / items / properties / boardId / description

Previous value: -"Pinterest board ID to pin to (required)"New value: +"Board id from list_pinterest_boards. Leave out to pin to a public board named AdaptlyPost, created on the account the first time it is needed"

changedInput schema / properties / pinterestConfigs / items / required

Previous value: -[
-  "connectionId",
-  "boardId"
-]New value: +[
+  "connectionId"
+]

Changed22 schema fields changedOct 13, 2026

changedInput schema / properties / contentType / description

Previous value: -"New content type; must match the media on the post. DOCUMENT publishes one PDF, PPT, PPTX, DOC or DOCX file (max 100 MB, 300 pages) as a LinkedIn document post and is LinkedIn only: put exactly that one file in mediaUrls, target only LINKEDIN, and set the title with linkedinConfigs"New value: +"New content type; must match the media on the post. CAROUSEL takes 2 or more items in mediaUrls, up to 4 on TWITTER, BLUESKY and MASTODON, 5 on PINTEREST, 10 on INSTAGRAM, FACEBOOK and THREADS, 20 on LINKEDIN and 35 on TIKTOK (JPEG or WebP photos only). INSTAGRAM and THREADS accept images and videos in the same carousel; every other platform takes images only, and YOUTUBE has no carousel. GOOGLE_BUSINESS takes TEXT or IMAGE with one JPEG or PNG image up to 5 MB, and text up to 1500 characters. DOCUMENT publishes one PDF, PPT, PPTX, DOC or DOCX file (max 100 MB, 300 pages) as a LinkedIn document post and is LinkedIn only: put exactly that one file in mediaUrls, target only LINKEDIN, and set the title with linkedinConfigs"

changedInput schema / properties / facebookConfigs / description

Previous value: -"Facebook per-page config with post type and video title. pageId must match an entry in pageIds"New value: +"Facebook per-page config: post type, shareToStory, video title and text background. pageId must match an entry in pageIds"

changedInput schema / properties / facebookConfigs / items / properties / postType / description

Previous value: -"Where the post goes: FEED works with every content type, REEL needs contentType VIDEO, STORY needs IMAGE or VIDEO. Any other combination is refused with 400"New value: +"Where the post goes: FEED works with every content type, REEL needs contentType VIDEO, STORY needs IMAGE, VIDEO or CAROUSEL (a CAROUSEL story publishes each media item as its own story, in order). Any other combination is refused with 400"

addedInput schema / properties / facebookConfigs / items / properties / shareToStory

Added value: +{
+  "description": "Also publish the same media as a story on this page, next to the FEED or REEL post. The story shows as its own entry in platforms with postType STORY, so it succeeds, fails and retries on its own. It skips the caption, video title and text background, needs IMAGE, VIDEO or CAROUSEL, and a video must fit the story length limit (60 seconds). Ignored when postType is STORY",
+  "type": "boolean"
+}

addedInput schema / properties / facebookConfigs / items / properties / textFormatPresetId

Added value: +{
+  "description": "Facebook's id for a colored text background (for example 106018623298955 is solid purple, 249307305544279 is a red to blue gradient). Only for contentType TEXT posts with no media and text up to 130 characters; anything else is refused with 400. Links in the text show without a preview. If Facebook refuses the background, the post goes out as plain text",
+  "pattern": "^\\d{1,20}$",
+  "type": "string"
+}

addedInput schema / properties / firstComments

Added value: +{
+  "description": "A comment posted from the same account right after the post goes out on a platform, one entry per platform. Available on LINKEDIN (1250 characters), TWITTER (280, as a reply), THREADS (500, as a reply), BLUESKY (300, as a reply), MASTODON (500, as a reply) and YOUTUBE (10000). A platform the post does not go to, an empty or too long comment, a second entry for one platform, a private or made for kids YouTube video and Facebook or Instagram stories are refused with 400. The comment is posted about 10 seconds after the platform publishes (60 on YouTube) and retried up to 3 times; on X it is not retried, and a lifetime-deal account pays for it like any X post. A comment that fails never fails the post: read firstCommentStatus and firstCommentError on the platform in get_post. On an update, sending the array replaces every first comment and omitting it keeps the stored ones",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "platform": {
+        "enum": [
+          "LINKEDIN",
+          "TWITTER",
+          "THREADS",
+          "BLUESKY",
+          "MASTODON",
+          "YOUTUBE"
+        ],
+        "type": "string"
+      },
+      "text": {
+        "description": "The comment's text, trimmed. The limit depends on the platform, see firstComments",
+        "maxLength": 10000,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "platform",
+      "text"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedInput schema / properties / googleBusinessConfigs

Added value: +{
+  "description": "Google Business Profile per-location config: update, event or offer, plus a button. connectionId must match an entry in googleBusinessConnectionIds. GOOGLE_BUSINESS takes TEXT or IMAGE with one JPEG or PNG image up to 5 MB, and text up to 1500 characters",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "callToActionType": {
+        "description": "Button shown on the post. Every type except CALL needs callToActionUrl; CALL dials the phone number on the Business Profile",
+        "enum": [
+          "BOOK",
+          "ORDER",
+          "SHOP",
+          "LEARN_MORE",
+          "SIGN_UP",
+          "CALL"
+        ],
+        "type": "string"
+      },
+      "callToActionUrl": {
+        "description": "Ignored when callToActionType is CALL",
+        "format": "uri",
+        "type": "string"
+      },
+      "connectionId": {
+        "description": "Google Business Profile account id from list_accounts",
+        "type": "string"
+      },
+      "eventEnd": {
+        "$ref": "#/properties/googleBusinessConfigs/items/properties/eventStart",
+        "description": "YYYY-MM-DD or YYYY-MM-DDTHH:mm in the business's local time, with no offset (e.g. \"2026-10-01T21:00\")"
+      },
+      "eventStart": {
+        "description": "YYYY-MM-DD or YYYY-MM-DDTHH:mm in the business's local time, with no offset (e.g. \"2026-10-01T18:00\"). Google reads event times in the location's time zone",
+        "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2})?$",
+        "type": "string"
+      },
+      "eventTitle": {
+        "description": "Title of the event or offer",
+        "type": "string"
+      },
+      "offerCouponCode": {
+        "description": "OFFER only: coupon code",
+        "type": "string"
+      },
+      "offerRedeemUrl": {
+        "description": "OFFER only: where the offer is redeemed",
+        "format": "uri",
+        "type": "string"
+      },
+      "offerTerms": {
+        "description": "OFFER only: terms and conditions",
+        "type": "string"
+      },
+      "topicType": {
+        "description": "STANDARD is an update. EVENT and OFFER need eventTitle, eventStart and eventEnd",
+        "enum": [
+          "STANDARD",
+          "EVENT",
+          "OFFER"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "connectionId",
+      "topicType"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedInput schema / properties / googleBusinessConnectionIds

Added value: +{
+  "description": "Google Business Profile locations to post to, by the account id from list_accounts. A location without an entry in googleBusinessConfigs gets a STANDARD update",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

changedInput schema / properties / instagramConfigs / description

Previous value: -"Instagram per-connection config to set post type (FEED, REEL, STORY) and publish a reel as a trial reel"New value: +"Instagram per-connection config: post type (FEED, REEL, STORY), shareToStory, collaborators, Reel audio, and trial reels"

addedInput schema / properties / instagramConfigs / items / properties / audio

Added value: +{
+  "additionalProperties": false,
+  "description": "Music or an original sound from Instagram's audio library, added to the Reel when it is published. Needs contentType VIDEO and a postType other than STORY, and only works for accounts with supportsInstagramAudio: true in list_accounts (connected through Facebook). Find ids with search_instagram_audio",
+  "properties": {
+    "artist": {
+      "description": "Artist or creator, stored for display only",
+      "maxLength": 255,
+      "type": "string"
+    },
+    "audioId": {
+      "description": "audioId from search_instagram_audio",
+      "maxLength": 64,
+      "minLength": 1,
+      "type": "string"
+    },
+    "audioVolume": {
+      "description": "Volume of the added audio, 1 to 100. Defaults to 100",
+      "maximum": 100,
+      "minimum": 1,
+      "type": "integer"
+    },
+    "title": {
+      "description": "Track title, stored for display only",
+      "maxLength": 255,
+      "type": "string"
+    },
+    "videoVolume": {
+      "description": "Volume of the video's own sound, 1 to 100. Defaults to 100",
+      "maximum": 100,
+      "minimum": 1,
+      "type": "integer"
+    }
+  },
+  "required": [
+    "audioId"
+  ],
+  "type": "object"
+}

addedInput schema / properties / instagramConfigs / items / properties / collaborators

Added value: +{
+  "description": "Instagram usernames invited as collaborators (Instagram Collab), up to 3. A leading @ is stripped and duplicates are dropped. Works on feed images, carousels and reels; a story or a trial reel with collaborators is refused with 400. Each collaborator gets an invite in Instagram and must accept it before the post shows on their profile",
+  "items": {
+    "pattern": "^@?[A-Za-z0-9._]{1,30}$",
+    "type": "string"
+  },
+  "maxItems": 3,
+  "type": "array"
+}

changedInput schema / properties / instagramConfigs / items / properties / postType / description

Previous value: -"Where the post goes: FEED works with every content type, REEL needs contentType VIDEO, STORY needs IMAGE or VIDEO. Any other combination is refused with 400"New value: +"Where the post goes: FEED works with every content type, REEL needs contentType VIDEO, STORY needs IMAGE, VIDEO or CAROUSEL (a CAROUSEL story publishes each media item as its own story, in order). Any other combination is refused with 400"

addedInput schema / properties / instagramConfigs / items / properties / shareToStory

Added value: +{
+  "description": "Also publish the same media as a story on this account, next to the FEED or REEL post. The story shows as its own entry in platforms with postType STORY, so it succeeds, fails and retries on its own. It skips the caption, first comment, cover, collaborators, trial and audio, needs IMAGE, VIDEO or CAROUSEL, and a video must fit the story length limit (60 seconds). Ignored when postType is STORY",
+  "type": "boolean"
+}

changedInput schema / properties / mediaAltTexts / description

Previous value: -"Alt text per image, in the same order as mediaUrls (max 1000 characters each; use \"\" to skip an image). Sent to X, Bluesky, Mastodon, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube and videos ignore it. Applied only when platforms is also sent"New value: +"Alt text per image, in the same order as mediaUrls (max 1000 characters each; use \"\" to skip an image). Sent to X, Bluesky, Mastodon, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube, Google Business Profile and videos ignore it. Applied only when platforms is also sent"

addedInput schema / properties / platformAspectRatios

Added value: +{
+  "description": "Reframe every image of an IMAGE or CAROUSEL post to one shape on a platform, one entry per platform. INSTAGRAM takes SQUARE, PORTRAIT or LANDSCAPE (Instagram refuses 9:16 feed and carousel images); TIKTOK takes all four. Video posts, Instagram stories and a second entry for the same platform are refused with 400. Omit a platform to keep its images as uploaded. On an update it applies to the mediaUrls sent in the same request",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "aspectRatio": {
+        "description": "SQUARE is 1:1, PORTRAIT 4:5, VERTICAL 9:16 and LANDSCAPE 1.91:1",
+        "enum": [
+          "SQUARE",
+          "PORTRAIT",
+          "VERTICAL",
+          "LANDSCAPE"
+        ],
+        "type": "string"
+      },
+      "fit": {
+        "description": "How an image of another shape reaches the ratio. CROP (the default) cuts it from the center; PAD keeps the whole image and fills the rest with a blurred copy of it",
+        "enum": [
+          "CROP",
+          "PAD"
+        ],
+        "type": "string"
+      },
+      "platform": {
+        "enum": [
+          "INSTAGRAM",
+          "TIKTOK"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "platform",
+      "aspectRatio"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedInput schema / properties / platformTexts / items / properties / text / description

Added value: +"On LinkedIn, mention a company page with @[Page Name](urn:li:organization:<id>), using the page name exactly as LinkedIn shows it"

addedInput schema / properties / platformThumbnails

Added value: +{
+  "description": "A different thumbnail for one platform of a VIDEO post, one entry per platform. A platform without an entry uses the post-level thumbnailUrl and thumbnailTimestampMs. YOUTUBE, FACEBOOK and LINKEDIN take an image (thumbnailUrl); INSTAGRAM and PINTEREST take an image or a frame (thumbnailTimestampMs), the image winning when both are sent; TIKTOK takes only a frame. Posts that are not videos, Facebook and Instagram stories, a second entry for one platform and an entry the platform cannot use are refused with 400. On an update, sending the array replaces every override and omitting it keeps the stored ones",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "platform": {
+        "enum": [
+          "YOUTUBE",
+          "FACEBOOK",
+          "LINKEDIN",
+          "INSTAGRAM",
+          "PINTEREST",
+          "TIKTOK"
+        ],
+        "type": "string"
+      },
+      "thumbnailTimestampMs": {
+        "description": "The video frame (ms from the start) to use as this platform's thumbnail",
+        "minimum": 0,
+        "type": "integer"
+      },
+      "thumbnailUrl": {
+        "description": "The image to use as this platform's thumbnail, an https URL or an image data URI",
+        "type": "string"
+      }
+    },
+    "required": [
+      "platform"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

changedInput schema / properties / platforms / items / enum

Previous value: -[
-  "LINKEDIN",
-  "YOUTUBE",
-  "INSTAGRAM",
-  "FACEBOOK",
-  "TIKTOK",
-  "PINTEREST",
-  "THREADS",
-  "BLUESKY",
-  "TWITTER",
-  "MASTODON"
-]New value: +[
+  "LINKEDIN",
+  "YOUTUBE",
+  "INSTAGRAM",
+  "FACEBOOK",
+  "TIKTOK",
+  "PINTEREST",
+  "THREADS",
+  "BLUESKY",
+  "TWITTER",
+  "MASTODON",
+  "GOOGLE_BUSINESS"
+]

changedInput schema / properties / text / description

Previous value: -"Updated text; omit to keep the current text"New value: +"Updated text; omit to keep the current text. On LinkedIn, mention a company page with @[Page Name](urn:li:organization:<id>), using the page name exactly as LinkedIn shows it"

changedInput schema / properties / thumbnailTimestampMs / description

Previous value: -"Generate thumbnail from video at this timestamp (milliseconds)"New value: +"Video frame timestamp (ms) to use as the thumbnail, used by INSTAGRAM, PINTEREST and TIKTOK unless platformThumbnails overrides it"

changedInput schema / properties / thumbnailUrl / description

Previous value: -"Custom thumbnail image URL for video posts"New value: +"Video thumbnail as an https URL or an image data URI, used on every platform that takes one unless platformThumbnails overrides it"

addedInput schema / properties / twitterKeepLinks

Added value: +{
+  "description": "Keep links in the X text clickable. X charges over 10 times more for a post with a link, so by default every link in X text is broken (example.com becomes example. com). Only AppSumo lifetime deals can turn this on, and a kept link costs 20 credits instead of 2. true on any other plan is refused with 400; it is ignored when the X text has no link",
+  "type": "boolean"
+}

Changed2 schema fields changedSep 28, 2026

removedInput schema / $schema

Removed value: -"http://json-schema.org/draft-07/schema#"

removedOutput schema / $schema

Removed value: -"http://json-schema.org/draft-07/schema#"

Changed4 schema fields changedSep 27, 2026

changedInput schema / properties / facebookConfigs / items / properties / postType / description

Previous value: -"Facebook post type — FEED, REEL, or STORY"New value: +"Where the post goes: FEED works with every content type, REEL needs contentType VIDEO, STORY needs IMAGE or VIDEO. Any other combination is refused with 400"

changedInput schema / properties / instagramConfigs / items / properties / postType / description

Previous value: -"Instagram post type — FEED, REEL, or STORY"New value: +"Where the post goes: FEED works with every content type, REEL needs contentType VIDEO, STORY needs IMAGE or VIDEO. Any other combination is refused with 400"

changedInput schema / properties / mediaAltTexts / description

Previous value: -"Alt text per image, in the same order as mediaUrls (max 1000 characters each; use \"\" to skip an image). Sent to X, Bluesky, Mastodon, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube and videos ignore it"New value: +"Alt text per image, in the same order as mediaUrls (max 1000 characters each; use \"\" to skip an image). Sent to X, Bluesky, Mastodon, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube and videos ignore it. Applied only when platforms is also sent"

changedInput schema / properties / workspaceId / description

Previous value: -"Workspace to act in: an id from list_workspaces. Omit to use the default workspace. Use the same workspaceId for every call about the same workspace, since ids from one workspace (accounts, posts, uploads) do not exist in another"New value: +"Workspace to act in: an id from list_workspaces. Omit to act in the workspace list_workspaces marks current. Use the same workspaceId for every call about the same workspace, since ids from one workspace (accounts, posts, uploads) do not exist in another"

Changed1 schema field changedSep 27, 2026

addedInput schema / properties / workspaceId

Added value: +{
+  "description": "Workspace to act in: an id from list_workspaces. Omit to use the default workspace. Use the same workspaceId for every call about the same workspace, since ids from one workspace (accounts, posts, uploads) do not exist in another",
+  "type": "string"
+}

Changed2 schema fields changedSep 27, 2026

changedInput schema / properties / instagramConfigs / description

Previous value: -"Instagram per-connection config to set post type (FEED, REEL, STORY)"New value: +"Instagram per-connection config to set post type (FEED, REEL, STORY) and publish a reel as a trial reel"

addedInput schema / properties / instagramConfigs / items / properties / trialGraduation

Added value: +{
+  "description": "Publish a video reel as a trial reel: Instagram shows it to non-followers first and keeps it off followers' feeds and the profile grid until it is shared. MANUAL means the account owner shares it from the Instagram app; SS_PERFORMANCE means Instagram shares it if it performs well. Only for a single video posted as a reel or feed video, never a story, image or carousel (400 otherwise). Needs a professional account Instagram has enabled for trial reels; otherwise that platform fails with a message saying so",
+  "enum": [
+    "MANUAL",
+    "SS_PERFORMANCE"
+  ],
+  "type": "string"
+}

Changed3 schema fields changedSep 25, 2026

changedInput schema / properties / contentType / description

Previous value: -"New content type; must match the media on the post"New value: +"New content type; must match the media on the post. DOCUMENT publishes one PDF, PPT, PPTX, DOC or DOCX file (max 100 MB, 300 pages) as a LinkedIn document post and is LinkedIn only: put exactly that one file in mediaUrls, target only LINKEDIN, and set the title with linkedinConfigs"

changedInput schema / properties / contentType / enum

Previous value: -[
-  "TEXT",
-  "IMAGE",
-  "VIDEO",
-  "CAROUSEL"
-]New value: +[
+  "TEXT",
+  "IMAGE",
+  "VIDEO",
+  "CAROUSEL",
+  "DOCUMENT"
+]

addedInput schema / properties / linkedinConfigs

Added value: +{
+  "description": "LinkedIn per-connection config: documentTitle names a DOCUMENT post. connectionId must match an entry in linkedinConnectionIds",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "connectionId": {
+        "description": "LinkedIn connection ID from list_accounts",
+        "type": "string"
+      },
+      "documentTitle": {
+        "description": "Title LinkedIn shows on a DOCUMENT post (max 100 chars). Defaults to the file name; ignored for other content types",
+        "maxLength": 100,
+        "type": "string"
+      }
+    },
+    "required": [
+      "connectionId"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Changed1 schema field changedSep 23, 2026

changedInput schema / properties / scheduledAt / description

Previous value: -"New schedule time as an absolute ISO 8601 instant; omit to keep"New value: +"New schedule time as an absolute ISO 8601 instant; omit to keep. Moving a SCHEDULED post more than a minute into the past fails with 400; use publish_draft to publish now"

Changed3 schema fields changedSep 23, 2026

addedInput schema / properties / mastodonConnectionIds

Added value: +{
+  "description": "Mastodon account connection IDs to post from",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

changedInput schema / properties / mediaAltTexts / description

Previous value: -"Alt text per image, in the same order as mediaUrls (max 1000 characters each; use \"\" to skip an image). Sent to X, Bluesky, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube and videos ignore it"New value: +"Alt text per image, in the same order as mediaUrls (max 1000 characters each; use \"\" to skip an image). Sent to X, Bluesky, Mastodon, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube and videos ignore it"

changedInput schema / properties / platforms / items / enum

Previous value: -[
-  "LINKEDIN",
-  "YOUTUBE",
-  "INSTAGRAM",
-  "FACEBOOK",
-  "TIKTOK",
-  "PINTEREST",
-  "THREADS",
-  "BLUESKY",
-  "TWITTER"
-]New value: +[
+  "LINKEDIN",
+  "YOUTUBE",
+  "INSTAGRAM",
+  "FACEBOOK",
+  "TIKTOK",
+  "PINTEREST",
+  "THREADS",
+  "BLUESKY",
+  "TWITTER",
+  "MASTODON"
+]

Changed1 schema field changedSep 19, 2026

addedInput schema / properties / mediaAltTexts

Added value: +{
+  "description": "Alt text per image, in the same order as mediaUrls (max 1000 characters each; use \"\" to skip an image). Sent to X, Bluesky, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube and videos ignore it",
+  "items": {
+    "maxLength": 1000,
+    "type": "string"
+  },
+  "type": "array"
+}

Changed12 schema fields changedSep 8, 2026

addedInput schema / properties / contentType / description

Added value: +"New content type; must match the media on the post"

changedInput schema / properties / facebookConfigs / description

Previous value: -"Facebook per-page config with post type and video title"New value: +"Facebook per-page config with post type and video title. pageId must match an entry in pageIds"

changedInput schema / properties / id / description

Previous value: -"Post ID to update"New value: +"Post ID to update (must be DRAFT or SCHEDULED)"

changedInput schema / properties / mediaUrls / description

Previous value: -"Updated media URLs. Use publicUrl values from upload_media or get_upload_urls"New value: +"Replacement media URLs, applied only when platforms is also sent. Use publicUrl values from upload_media or get_upload_urls"

changedInput schema / properties / pageIds / description

Previous value: -"Facebook page IDs"New value: +"Facebook page account ids from list_accounts (the account id; its pageId value is also accepted). Facebook has no connection-id array"

changedInput schema / properties / pinterestConfigs / description

Previous value: -"Pinterest per-connection config. boardId is required for Pinterest posts"New value: +"Pinterest per-connection config. Each entry needs connectionId + boardId; there is no API to list boards, so ask the user for the board id"

addedInput schema / properties / platformTexts / description

Added value: +"Per-platform caption overrides; applied to the targets sent in platforms"

changedInput schema / properties / platforms / description

Previous value: -"Updated target platforms"New value: +"New target platforms. Sending this replaces every target, so also resend the connection-id arrays and platform configs to keep; omit to leave targets unchanged"

changedInput schema / properties / scheduledAt / description

Previous value: -"Updated schedule time (ISO 8601)"New value: +"New schedule time as an absolute ISO 8601 instant; omit to keep"

changedInput schema / properties / text / description

Previous value: -"Updated text"New value: +"Updated text; omit to keep the current text"

changedInput schema / properties / timezone / description

Previous value: -"IANA timezone for the schedule time"New value: +"IANA timezone stored for display; does not shift scheduledAt"

changedOutput schema / properties / result / description

Previous value: -"The updated post record including its id, status, and scheduled time as returned by the AdaptlyPost API."New value: +"The updated post record: id, status (still DRAFT or SCHEDULED), text, contentType, scheduledAt, timezone, and platforms with per-target details."

First observedSep 1, 2026

TDQS

A4.8/5.0

Behavior5/5

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

Annotations already mark this as destructive and open-world, but the description adds crucial behavioral detail beyond them: partial-update defaults, destructive replacement semantics for platforms/firstComments/platformThumbnails, the mediaUrls dependency on platforms, and scheduled-post media verification. This is exactly the kind of consequence disclosure an agent needs before mutating a post.

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?

The key status constraint and partial-update behavior are front-loaded, and every sentence carries useful information. However, it is a single dense paragraph covering many distinct behaviors, so scanability could be improved with light structuring.

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

Completeness5/5

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

Given the tool's complexity, 38 parameters, full schema coverage, and an output schema, the description supplies the missing behavioral context: editability rules, replacement semantics, platform/media dependencies, and sibling routing. Nothing critical for a correct call is omitted.

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

Parameters4/5

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

Schema description coverage is 100%, so the baseline is 3, but the description adds important cross-parameter semantics the schema alone does not fully emphasize: platforms rebuilds the entire target set, mediaUrls only applies with platforms, and firstComments/platformThumbnails replace all stored entries. It does not discuss every one of the 38 parameters, but it covers the highest-risk interactions.

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?

States the specific verb and resource (update a post) and immediately narrows scope to DRAFT or SCHEDULED status. It also names the sibling tools that handle adjacent operations, so an agent can distinguish it without opening schemas.

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

Usage Guidelines5/5

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

Explicitly says when the tool cannot be used (published posts fail) and routes the agent to publish_draft, unschedule_post, delete_post, and create_post for the adjacent operations. The conditions for choosing alternatives are concrete.

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

All AdaptlyPost tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?