Skip to main content
Glama

Validate Bulk Posts

validate_bulk_posts
Read-onlyIdempotent

Dry-run bulk_schedule_posts: takes exactly the same input and returns one validation report per item, in input order, without creating, uploading or writing anything. Nothing is published, so no confirmation is needed. Each report has valid, outcome, requiredPermissions, issues, accounts and notChecked, as in validate_post. Fix the items with ERROR issues, then call bulk_schedule_posts. Needs the posts.draft permission.

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": {
      "platforms": "<platforms>",
      "posts": "<posts>"
    },
    "name": "validate_bulk_posts"
  }
}

Input Schema

NameRequiredDescriptionDefault
postsYesThe posts to schedule; each is created independently
pageIdsNoFacebook page account ids from list_accounts (the account id; its pageId value is also accepted). Facebook has no connection-id array
timezoneNoIANA timezone stored with every post for display; does not shift scheduledAtUTC
platformsYesTarget platforms shared by every item. Each needs its connection-id array (pageIds for FACEBOOK, googleBusinessConnectionIds for GOOGLE_BUSINESS)
workspaceIdNoWorkspace 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
tiktokConfigsNoTikTok per-connection config. Each entry needs connectionId + privacyLevel at minimum
tumblrConfigsNoTumblr per-blog config: tags, a title and a source link. connectionId must match an entry in tumblrConnectionIds
youtubeConfigsNoYouTube per-connection config with video title, tags, privacy, etc.
facebookConfigsNoFacebook per-page config: post type, shareToStory, video title, text background, a grid or link carousel for several images, and the AI info label. pageId must match an entry in pageIds
instagramConfigsNoInstagram per-connection config: post type (FEED, REEL, STORY), shareToStory, collaborators, user tags, the AI info label, Reel audio, and trial reels
pinterestConfigsNoPinterest 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
wordpressConfigsNoWordPress per-site config: title, excerpt, categories, tags and status (publish, leave a draft or submit for review). connectionId must match an entry in wordpressConnectionIds
tiktokConnectionIdsNoTikTok account connection IDs to post from
tumblrConnectionIdsNoTumblr 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
blueskyConnectionIdsNoBluesky account connection IDs to post from
threadsConnectionIdsNoThreads account connection IDs to post from
twitterConnectionIdsNoX (Twitter) account connection IDs to post from
youtubeConnectionIdsNoYouTube channel connection IDs to post from
googleBusinessConfigsNoGoogle 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
linkedinConnectionIdsNoLinkedIn account connection IDs to post from
mastodonConnectionIdsNoMastodon account connection IDs to post from
telegramConnectionIdsNoTelegram 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
instagramConnectionIdsNoInstagram account connection IDs to post from
pinterestConnectionIdsNoPinterest account connection IDs to post from
wordpressConnectionIdsNoWordPress sites to post to, by the account id from list_accounts. WORDPRESS publishes the text as the body of a blog post, up to 100,000 characters: blank lines start new paragraphs and bare links become clickable. It takes up to 20 JPEG, PNG, WebP or GIF images (20 MB each) or one MP4 or MOV video (500 MB); the first image is the featured image and the other images or the video follow the text. A site without an entry in wordpressConfigs uses the first line of the text as the title. WordPress has no first comments, threads, thumbnails, image shapes or analytics
googleBusinessConnectionIdsNoGoogle 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

NameRequiredDescriptionDefault
resultYesAn object with valid (true when every item is valid), totalValid, totalInvalid, and results: one { index, report } per item, where report has the validate_post shape.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / posts / items / 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), 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"New value: +"A comment posted from the same account shortly 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 goes out within about a minute of the platform publishing (about two minutes on YouTube), or within about a minute of delayMinutes after it when the entry sets one, and is 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"
    • addedInput schema / properties / posts / items / properties / firstComments / items / properties / delayMinutes
      Added value: +{
      +  "description": "How many minutes after the platform publishes to post the comment, up to 10080 (7 days). Omit it or send 0 for no delay. The comment goes out within about a minute of that time; without a delay, within about a minute of the post (about two minutes on YouTube). Once the post is published the delay cannot be changed; deleting the post cancels a comment that has not gone out yet",
      +  "maximum": 10080,
      +  "minimum": 0,
      +  "type": "integer"
      +}
  2. Changed3 schema fields changed
    • changedInput schema / properties / posts / items / properties / contentType / description
      Previous value: -"What the post carries; it must match mediaUrls. DOCUMENT posts cannot be bulk scheduled; use create_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 and WORDPRESS, 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. Give a platform with a lower limit its own items through platformMedia. GOOGLE_BUSINESS takes TEXT or IMAGE with one JPEG or PNG image up to 5 MB, and text up to 1500 characters. 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. WORDPRESS publishes the text as the body of a blog post, up to 100,000 characters: blank lines start new paragraphs and bare links become clickable. It takes up to 20 JPEG, PNG, WebP or GIF images (20 MB each) or one MP4 or MOV video (500 MB); the first image is the featured image and the other images or the video follow the text"New value: +"What the post carries; it must match mediaUrls. DOCUMENT posts cannot be bulk scheduled; use create_post. CAROUSEL takes 2 or more items in mediaUrls, up to 4 on BLUESKY and MASTODON, 5 on PINTEREST, 10 on INSTAGRAM, FACEBOOK, THREADS and TELEGRAM, 20 on TWITTER, LINKEDIN and WORDPRESS, 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. Give a platform with a lower limit its own items through platformMedia. GOOGLE_BUSINESS takes TEXT or IMAGE with one JPEG or PNG image up to 5 MB, and text up to 1500 characters. 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. WORDPRESS publishes the text as the body of a blog post, up to 100,000 characters: blank lines start new paragraphs and bare links become clickable. It takes up to 20 JPEG, PNG, WebP or GIF images (20 MB each) or one MP4 or MOV video (500 MB); the first image is the featured image and the other images or the video follow the text"
    • addedInput schema / properties / posts / items / properties / wordpressConfigs / items / properties / status
      Added value: +{
      +  "description": "What the post becomes on the site at the post's time. PUBLISH (default) publishes it live. DRAFT leaves a WordPress draft the user finishes and publishes or schedules in WordPress. PENDING submits it for review (Pending Review). Unrelated to saveAsDraft: the post must still be published or scheduled to reach the site. For DRAFT and PENDING the post's postUrl opens it in the WordPress editor",
      +  "enum": [
      +    "PUBLISH",
      +    "DRAFT",
      +    "PENDING"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / wordpressConfigs / description
      Previous value: -"WordPress per-site config: title, excerpt, categories and tags. connectionId must match an entry in wordpressConnectionIds"New value: +"WordPress per-site config: title, excerpt, categories, tags and status (publish, leave a draft or submit for review). connectionId must match an entry in wordpressConnectionIds"
  3. Changed3 schema fields changed
    • changedInput schema / properties / posts / items / properties / instagramConfigs / items / properties / audio / properties / audioVolume / description
      Previous value: -"Volume of the added audio, where 100 is full volume. Defaults to 100"New value: +"How loud the added audio plays, as a percentage of its full volume. Omit for full volume"
    • changedInput schema / properties / posts / items / properties / instagramConfigs / items / properties / audio / properties / videoVolume / description
      Previous value: -"Volume of the video's own sound, where 100 is full volume. Defaults to 100"New value: +"How loud the video's own sound plays under the added audio, as a percentage of its full volume. Omit for full volume"
    • changedInput schema / properties / posts / items / properties / tiktokConfigs / items / properties / caption / description
      Previous value: -"TikTok-specific caption: up to 2200 characters on a video, 4000 on a photo or photo carousel post (where it is the description). Falls back to title, then to the post text. A video sent with sendAsDraft can reach the TikTok inbox without it, because TikTok's inbox upload takes no caption"New value: +"TikTok-specific caption, used instead of the post text. TikTok caps it at 2200 characters on a video; on a photo or photo carousel post it is the description and can use the full length. Falls back to title, then to the post text. A video sent with sendAsDraft can reach the TikTok inbox without it, because TikTok's inbox upload takes no caption"
  4. Changed38 schema fields changed
    • changedInput schema / properties / posts / description
      Previous value: -"1 to 100 posts to schedule; each is created independently"New value: +"The posts to schedule; each is created independently"
    • changedInput schema / properties / posts / items / properties / contentType / description
      Previous value: -"TEXT, IMAGE, VIDEO, or CAROUSEL; must match mediaUrls. DOCUMENT posts cannot be bulk scheduled; use create_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 and WORDPRESS, 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. 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. WORDPRESS publishes the text as the body of a blog post, up to 100,000 characters: blank lines start new paragraphs and bare links become clickable. It takes up to 20 JPEG, PNG, WebP or GIF images (20 MB each) or one MP4 or MOV video (500 MB); the first image is the featured image and the other images or the video follow the text"New value: +"What the post carries; it must match mediaUrls. DOCUMENT posts cannot be bulk scheduled; use create_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 and WORDPRESS, 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. Give a platform with a lower limit its own items through platformMedia. GOOGLE_BUSINESS takes TEXT or IMAGE with one JPEG or PNG image up to 5 MB, and text up to 1500 characters. 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. WORDPRESS publishes the text as the body of a blog post, up to 100,000 characters: blank lines start new paragraphs and bare links become clickable. It takes up to 20 JPEG, PNG, WebP or GIF images (20 MB each) or one MP4 or MOV video (500 MB); the first image is the featured image and the other images or the video follow the text"
    • changedInput schema / properties / posts / items / properties / facebookConfigs / items / properties / videoTitle / description
      Previous value: -"Video title for Facebook (max 255 chars)"New value: +"Title shown on the Facebook video"
    • addedInput schema / properties / posts / items / properties / firstComments / items / properties / platform / description
      Added value: +"The platform whose published post gets this comment"
    • changedInput schema / properties / posts / items / properties / googleBusinessConfigs / items / properties / callToActionUrl / description
      Previous value: -"Ignored when callToActionType is CALL"New value: +"Page the button opens. Ignored when callToActionType is CALL"
    • changedInput schema / properties / posts / items / properties / googleBusinessConfigs / items / properties / eventEnd / description
      Previous value: -"YYYY-MM-DD or YYYY-MM-DDTHH:mm in the business's local time, with no offset (e.g. \"2026-10-01T21:00\")"New value: +"End of the event or offer in the business's local time with no offset, as a date or a date and time (e.g. \"2026-10-01T21:00\")"
    • changedInput schema / properties / posts / items / properties / googleBusinessConfigs / items / properties / eventStart / description
      Previous value: -"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"New value: +"Start of the event or offer in the business's local time with no offset, as a date or a date and time (e.g. \"2026-10-01T18:00\"). Google reads event times in the location's time zone"
    • changedInput schema / properties / posts / items / properties / instagramConfigs / items / properties / audio / properties / audioVolume / description
      Previous value: -"Volume of the added audio, 1 to 100. Defaults to 100"New value: +"Volume of the added audio, where 100 is full volume. Defaults to 100"
    • changedInput schema / properties / posts / items / properties / instagramConfigs / items / properties / audio / properties / videoVolume / description
      Previous value: -"Volume of the video's own sound, 1 to 100. Defaults to 100"New value: +"Volume of the video's own sound, where 100 is full volume. Defaults to 100"
    • changedInput schema / properties / posts / items / properties / instagramConfigs / items / properties / collaborators / description
      Previous value: -"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"New value: +"Instagram usernames invited as collaborators (Instagram Collab). 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"
    • changedInput schema / properties / posts / items / properties / instagramConfigs / items / properties / userTags / description
      Previous value: -"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"New value: +"Public Instagram accounts tagged in the media. 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"
    • changedInput schema / properties / posts / items / properties / instagramConfigs / items / properties / userTags / items / properties / x / description
      Previous value: -"Horizontal position of the tag on the image, from 0 (left edge) to 1 (right edge)"New value: +"Horizontal position of the tag as a fraction of the image width, where 0 is the left edge"
    • changedInput schema / properties / posts / items / properties / instagramConfigs / items / properties / userTags / items / properties / y / description
      Previous value: -"Vertical position of the tag on the image, from 0 (top edge) to 1 (bottom edge)"New value: +"Vertical position of the tag as a fraction of the image height, where 0 is the top edge"
    • changedInput schema / properties / posts / items / 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, Tumblr, WordPress, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube, Google Business Profile and videos ignore it"New value: +"Alt text per image, in the same order as mediaUrls (use \"\" to skip an image). Sent to X, Bluesky, Mastodon, Tumblr, WordPress, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube, Google Business Profile and videos ignore it"
    • changedInput schema / properties / posts / items / properties / pinterestConfigs / items / properties / title / description
      Previous value: -"Pin title (max 100 chars)"New value: +"Title shown on the pin"
    • addedInput schema / properties / posts / items / properties / platformAspectRatios / items / properties / platform / description
      Added value: +"The platform whose images are reframed to aspectRatio"
    • addedInput schema / properties / posts / items / properties / platformMedia
      Added value: +{
      +  "description": "Different media for one platform, for when the post media does not fit it (a video too long for TikTok, a carousel with more images than X takes), one entry per platform. A platform without an entry uses the post mediaUrls. The entry must match the post contentType: one video for VIDEO, one image for IMAGE, one document for DOCUMENT, two or more items for CAROUSEL; TEXT posts take none. Each entry is checked against its own platform's limits only, and the post mediaUrls is no longer checked against that platform. An entry for a platform the post does not go to, an empty mediaUrls, a data URI, a second entry for one platform and media of another type are refused with 400. An overridden platform does not use the post-level thumbnailUrl or thumbnailTimestampMs; give it its own through platformThumbnails. On an update, sending the array replaces every override, [] clears them all and omitting it keeps the stored ones; it takes effect even without platforms. get_post shows an override as mediaOverrideUrls and mediaOverrideAltTexts on that platform",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "mediaAltTexts": {
      +        "description": "Alt text per item, in the same order as this entry's mediaUrls (use \"\" to skip one)",
      +        "items": {
      +          "maxLength": 1000,
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "mediaUrls": {
      +        "description": "This platform's media, publicUrl values from upload_media or get_upload_urls. Public https URLs only, no data URIs",
      +        "items": {
      +          "type": "string"
      +        },
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "platform": {
      +        "description": "The platform that publishes this media instead of the post mediaUrls",
      +        "enum": [
      +          "LINKEDIN",
      +          "YOUTUBE",
      +          "INSTAGRAM",
      +          "FACEBOOK",
      +          "TIKTOK",
      +          "PINTEREST",
      +          "THREADS",
      +          "BLUESKY",
      +          "TWITTER",
      +          "MASTODON",
      +          "GOOGLE_BUSINESS",
      +          "TUMBLR",
      +          "WORDPRESS",
      +          "TELEGRAM"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "platform",
      +      "mediaUrls"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • removedInput schema / properties / posts / items / properties / platformTexts / items / properties / platform / $ref
      Removed value: -"#/properties/platforms/items"
    • addedInput schema / properties / posts / items / properties / platformTexts / items / properties / platform / description
      Added value: +"The platform that gets this text instead of the post text; one entry per platform"
    • addedInput schema / properties / posts / items / properties / platformTexts / items / properties / platform / enum
      Added value: +[
      +  "LINKEDIN",
      +  "YOUTUBE",
      +  "INSTAGRAM",
      +  "FACEBOOK",
      +  "TIKTOK",
      +  "PINTEREST",
      +  "THREADS",
      +  "BLUESKY",
      +  "TWITTER",
      +  "MASTODON",
      +  "GOOGLE_BUSINESS",
      +  "TUMBLR",
      +  "WORDPRESS",
      +  "TELEGRAM"
      +]
    • addedInput schema / properties / posts / items / properties / platformTexts / items / properties / platform / type
      Added value: +"string"
    • addedInput schema / properties / posts / items / properties / platformThumbnails / items / properties / platform / description
      Added value: +"The platform that uses this thumbnail instead of the post-level one"
    • changedInput schema / properties / posts / items / properties / threadReplies / items / properties / mediaUrls / description
      Previous value: -"Parallel to texts: the image URLs of each reply, from upload_media, and [] for a reply without images. Up to 4 JPEG, PNG, GIF or WEBP images per reply"New value: +"Parallel to texts: the JPEG, PNG, GIF or WEBP image URLs of each reply, from upload_media, and [] for a reply without images"
    • addedInput schema / properties / posts / items / properties / threadReplies / items / properties / platform / description
      Added value: +"The platform whose published post these replies follow"
    • changedInput schema / properties / posts / items / properties / tiktokConfigs / items / properties / privacyLevel / description
      Previous value: -"TikTok privacy level"New value: +"Who can see the TikTok post: everyone, mutual followers, followers of the creator, or only the creator (SELF_ONLY)"
    • changedInput schema / properties / posts / items / properties / tiktokConfigs / items / properties / title / description
      Previous value: -"Max 90 characters. On a photo post, the title shown above the description. On a video, sent as the caption only when caption is empty"New value: +"On a photo post, the title shown above the description. On a video, sent as the caption only when caption is empty"
    • changedInput schema / properties / posts / items / properties / tumblrConfigs / items / properties / tags / description
      Previous value: -"Tumblr tags, up to 30, each up to 140 characters and without commas. A leading # is stripped and duplicates are dropped, ignoring case"New value: +"Tags shown on the Tumblr post. A leading # is stripped and duplicates are dropped, ignoring case"
    • changedInput schema / properties / posts / items / properties / wordpressConfigs / items / properties / tags / description
      Previous value: -"Tag names, up to 50. A tag the site does not have yet is created when the WordPress user may manage tags, and skipped otherwise"New value: +"WordPress tag names. A tag the site does not have yet is created when the WordPress user may manage tags, and skipped otherwise"
    • changedInput schema / properties / posts / items / properties / youtubeConfigs / items / properties / categoryId / description
      Previous value: -"YouTube category ID"New value: +"Numeric YouTube video category id, as a string, such as \"22\" for People & Blogs"
    • changedInput schema / properties / posts / items / properties / youtubeConfigs / items / properties / license / description
      Previous value: -"Video license type"New value: +"youtube is the standard YouTube license; creativeCommon publishes the video under Creative Commons Attribution so others may reuse it"
    • changedInput schema / properties / posts / items / properties / youtubeConfigs / items / properties / playlistId / description
      Previous value: -"Add video to this playlist"New value: +"Id of a playlist on this YouTube channel; the uploaded video is added to it"
    • changedInput schema / properties / posts / items / properties / youtubeConfigs / items / properties / privacyStatus / description
      Previous value: -"Video privacy status"New value: +"Who can watch the video: public is everyone, unlisted is anyone with the link, private is only the channel"
    • changedInput schema / properties / posts / items / properties / youtubeConfigs / items / properties / tags / description
      Previous value: -"Video tags (max 20)"New value: +"Keyword tags stored on the YouTube video"
    • changedInput schema / properties / posts / items / properties / youtubeConfigs / items / properties / videoTitle / description
      Previous value: -"YouTube video title (max 100 chars)"New value: +"Title of the YouTube video"
    • addedOutput schema / properties / result / additionalProperties
      Added value: +true
    • addedOutput schema / properties / result / properties
      Added value: +{
      +  "results": {
      +    "anyOf": [
      +      {
      +        "items": {
      +          "additionalProperties": true,
      +          "properties": {
      +            "index": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "report": {
      +              "anyOf": [
      +                {
      +                  "additionalProperties": true,
      +                  "properties": {
      +                    "accounts": {
      +                      "anyOf": [
      +                        {
      +                          "items": {
      +                            "additionalProperties": true,
      +                            "properties": {
      +                              "accountName": {
      +                                "type": [
      +                                  "string",
      +                                  "null"
      +                                ]
      +                              },
      +                              "connectionId": {
      +                                "type": [
      +                                  "string",
      +                                  "null"
      +                                ]
      +                              },
      +                              "issues": {
      +                                "anyOf": [
      +                                  {
      +                                    "items": {
      +                                      "$ref": "#/properties/result/properties/results/anyOf/0/items/properties/report/anyOf/0/properties/issues/anyOf/0/items"
      +                                    },
      +                                    "type": "array"
      +                                  },
      +                                  {
      +                                    "type": "null"
      +                                  }
      +                                ]
      +                              },
      +                              "platform": {
      +                                "description": "One of: FACEBOOK, INSTAGRAM, THREADS, TIKTOK, TWITTER, BLUESKY, LINKEDIN, PINTEREST, YOUTUBE, MASTODON, TELEGRAM, GOOGLE_BUSINESS, TUMBLR, WORDPRESS",
      +                                "type": [
      +                                  "string",
      +                                  "null"
      +                                ]
      +                              },
      +                              "status": {
      +                                "description": "One of: READY, WARNING, BLOCKED",
      +                                "type": [
      +                                  "string",
      +                                  "null"
      +                                ]
      +                              }
      +                            },
      +                            "type": "object"
      +                          },
      +                          "type": "array"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "issues": {
      +                      "anyOf": [
      +                        {
      +                          "items": {
      +                            "additionalProperties": true,
      +                            "properties": {
      +                              "code": {
      +                                "description": "Stable machine-readable reason, such as `TEXT_TOO_LONG`, `ACCOUNT_DISCONNECTED`, `TIKTOK_POSTING_BLOCKED` or `YOUTUBE_UPLOAD_QUOTA_EXHAUSTED`",
      +                                "type": [
      +                                  "string",
      +                                  "null"
      +                                ]
      +                              },
      +                              "connectionId": {
      +                                "description": "The account the issue is about, when it is about one",
      +                                "type": [
      +                                  "string",
      +                                  "null"
      +                                ]
      +                              },
      +                              "message": {
      +                                "type": [
      +                                  "string",
      +                                  "null"
      +                                ]
      +                              },
      +                              "platform": {
      +                                "description": "One of: FACEBOOK, INSTAGRAM, THREADS, TIKTOK, TWITTER, BLUESKY, LINKEDIN, PINTEREST, YOUTUBE, MASTODON, TELEGRAM, GOOGLE_BUSINESS, TUMBLR, WORDPRESS",
      +                                "type": [
      +                                  "string",
      +                                  "null"
      +                                ]
      +                              },
      +                              "severity": {
      +                                "description": "`ERROR` stops the post (or that account) from going out; `WARNING` lets it through with a caveat",
      +                                "type": [
      +                                  "string",
      +                                  "null"
      +                                ]
      +                              }
      +                            },
      +                            "type": "object"
      +                          },
      +                          "type": "array"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ],
      +                      "description": "Issues not tied to one selected account"
      +                    },
      +                    "notChecked": {
      +                      "anyOf": [
      +                        {
      +                          "items": {
      +                            "additionalProperties": true,
      +                            "properties": {
      +                              "code": {
      +                                "description": "One of: PLATFORM_PROCESSING, DUPLICATE_CONTENT, PLATFORM_RATE_LIMITS, LIVE_ACCOUNT_ACCESS, VIDEO_DURATION",
      +                                "type": [
      +                                  "string",
      +                                  "null"
      +                                ]
      +                              },
      +                              "message": {
      +                                "type": [
      +                                  "string",
      +                                  "null"
      +                                ]
      +                              }
      +                            },
      +                            "type": "object"
      +                          },
      +                          "type": "array"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "outcome": {
      +                      "description": "What creating this post would do",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "requiredPermissions": {
      +                      "anyOf": [
      +                        {
      +                          "items": {
      +                            "description": "One of: workspace.read, workspace.manage, posts.read, posts.draft, posts.others, posts.schedule, posts.publish, posts.delete, media.upload, accounts.read, accounts.manage, analytics.read, analytics.sync, inbox.read, inbox.reply, ai.generate, members.read, members.manage, tokens.own, tokens.manage, webhooks.read, webhooks.manage, signature.manage, flowsery.write, redreplier.write, claw.use",
      +                            "type": "string"
      +                          },
      +                          "type": "array"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "scheduledAt": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "valid": {
      +                      "type": [
      +                        "boolean",
      +                        "null"
      +                      ]
      +                    }
      +                  },
      +                  "type": "object"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "totalInvalid": {
      +    "type": [
      +      "number",
      +      "null"
      +    ]
      +  },
      +  "totalValid": {
      +    "type": [
      +      "number",
      +      "null"
      +    ]
      +  },
      +  "valid": {
      +    "type": [
      +      "boolean",
      +      "null"
      +    ]
      +  }
      +}
    • addedOutput schema / properties / result / type
      Added value: +"object"
    • addedOutput schema / required
      Added value: +[
      +  "result"
      +]
  5. Changed9 schema fields changed
    • changedInput schema / properties / posts / items / 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), 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"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 / posts / items / properties / firstComments / items / properties / platform / enum
      Previous value: -[
      -  "LINKEDIN",
      -  "TWITTER",
      -  "BLUESKY",
      -  "MASTODON",
      -  "YOUTUBE",
      -  "FACEBOOK",
      -  "INSTAGRAM"
      -]New value: +[
      +  "LINKEDIN",
      +  "TWITTER",
      +  "THREADS",
      +  "BLUESKY",
      +  "MASTODON",
      +  "YOUTUBE",
      +  "FACEBOOK",
      +  "INSTAGRAM"
      +]
    • addedInput schema / properties / posts / items / properties / threadReplies / items / properties / texts / items / maxLength
      Added value: +25000
    • changedInput schema / properties / posts / items / properties / tiktokConfigs / items / properties / caption / description
      Previous value: -"TikTok-specific caption: up to 2200 characters on a video, 4000 on a photo or photo carousel post"New value: +"TikTok-specific caption: up to 2200 characters on a video, 4000 on a photo or photo carousel post (where it is the description). Falls back to title, then to the post text. A video sent with sendAsDraft can reach the TikTok inbox without it, because TikTok's inbox upload takes no caption"
    • changedInput schema / properties / posts / items / properties / tiktokConfigs / items / properties / title / description
      Previous value: -"Video title (max 90 chars)"New value: +"Max 90 characters. On a photo post, the title shown above the description. On a video, sent as the caption only when caption is empty"
    • changedInput schema / properties / posts / items / properties / tumblrConfigs / items / properties / tags / description
      Previous value: -"Tumblr tags, without commas, up to 30. A leading # is stripped and duplicates are dropped, ignoring case"New value: +"Tumblr tags, up to 30, each up to 140 characters and without commas. A leading # is stripped and duplicates are dropped, ignoring case"
    • addedInput schema / properties / posts / items / properties / tumblrConfigs / items / properties / tags / items / maxLength
      Added value: +140
    • addedInput schema / properties / posts / items / properties / tumblrConfigs / items / properties / tags / items / pattern
      Added value: +"^[^,]+$"
    • addedInput schema / properties / posts / items / properties / youtubeConfigs / items / properties / scheduleOnYouTube
      Added value: +{
      +  "description": "Upload the video as soon as the post is scheduled, as a private video that YouTube publishes itself at scheduledAt, so the user can set up a Test & Compare (thumbnail and title A/B test) in YouTube Studio before it goes public. privacyStatus must be public or omitted (400 YOUTUBE_SCHEDULE_REQUIRES_PUBLIC), and a recurring post is refused (400 YOUTUBE_SCHEDULE_NOT_RECURRING). With a scheduledAt less than 15 minutes ahead the video uploads at scheduledAt as usual. Once the video is on YouTube (youtubeScheduledVideoId is set on the platform), the post cannot be updated, unscheduled or published early (409 SCHEDULED_ON_YOUTUBE); to change it, delete it and schedule it again. Deleting it before scheduledAt also deletes the video from YouTube",
      +  "type": "boolean"
      +}
  6. Changed3 schema fields changed
    • changedInput schema / properties / posts / items / properties / threadReplies / description
      Previous value: -"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), 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"New value: +"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. A reply can carry up to 4 images (JPEG, PNG, GIF or WEBP) through mediaUrls, adapted to the platform like the post's own images; a reply with images may leave its text empty. 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, a reply with neither text nor images, a too long reply, more than 25 replies, more than 4 images or a video on a reply, 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"
    • addedInput schema / properties / posts / items / properties / threadReplies / items / properties / mediaUrls
      Added value: +{
      +  "description": "Parallel to texts: the image URLs of each reply, from upload_media, and [] for a reply without images. Up to 4 JPEG, PNG, GIF or WEBP images per reply",
      +  "items": {
      +    "items": {
      +      "type": "string"
      +    },
      +    "maxItems": 4,
      +    "type": "array"
      +  },
      +  "maxItems": 25,
      +  "type": "array"
      +}
    • changedInput schema / properties / posts / items / properties / threadReplies / items / properties / platform / enum
      Previous value: -[
      -  "TWITTER",
      -  "BLUESKY",
      -  "MASTODON"
      -]New value: +[
      +  "TWITTER",
      +  "THREADS",
      +  "BLUESKY",
      +  "MASTODON"
      +]
  7. Changed2 schema fields changed
    • changedInput schema / properties / facebookConfigs / description
      Previous 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"New value: +"Facebook per-page config: post type, shareToStory, video title, text background, a grid or link carousel for several images, and the AI info label. pageId must match an entry in pageIds"
    • addedInput schema / properties / posts / items / properties / facebookConfigs / items / properties / aiGenerated
      Added value: +{
      +  "description": "Disclose that the post was made or edited with AI. Facebook shows its \"AI info\" label on the post. Works on every contentType VIDEO post, whatever its postType: Facebook publishes every video as a reel, and a video story carries the label too. Photos, carousels and text posts are rejected with a 400. Omit it or send false for no label",
      +  "type": "boolean"
      +}
  8. Changed15 schema fields changed
    • changedInput schema / properties / platforms / items / enum
      Previous value: -[
      -  "LINKEDIN",
      -  "YOUTUBE",
      -  "INSTAGRAM",
      -  "FACEBOOK",
      -  "TIKTOK",
      -  "PINTEREST",
      -  "THREADS",
      -  "BLUESKY",
      -  "TWITTER",
      -  "MASTODON",
      -  "GOOGLE_BUSINESS",
      -  "TUMBLR",
      -  "TELEGRAM"
      -]New value: +[
      +  "LINKEDIN",
      +  "YOUTUBE",
      +  "INSTAGRAM",
      +  "FACEBOOK",
      +  "TIKTOK",
      +  "PINTEREST",
      +  "THREADS",
      +  "BLUESKY",
      +  "TWITTER",
      +  "MASTODON",
      +  "GOOGLE_BUSINESS",
      +  "TUMBLR",
      +  "WORDPRESS",
      +  "TELEGRAM"
      +]
    • changedInput schema / properties / posts / items / properties / contentType / description
      Previous value: -"TEXT, IMAGE, VIDEO, or CAROUSEL; must match mediaUrls. DOCUMENT posts cannot be bulk scheduled; use create_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. 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"New value: +"TEXT, IMAGE, VIDEO, or CAROUSEL; must match mediaUrls. DOCUMENT posts cannot be bulk scheduled; use create_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 and WORDPRESS, 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. 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. WORDPRESS publishes the text as the body of a blog post, up to 100,000 characters: blank lines start new paragraphs and bare links become clickable. It takes up to 20 JPEG, PNG, WebP or GIF images (20 MB each) or one MP4 or MOV video (500 MB); the first image is the featured image and the other images or the video follow the text"
    • changedInput schema / properties / posts / items / 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), 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"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), 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 / posts / items / properties / firstComments / items / properties / platform / enum
      Previous value: -[
      -  "LINKEDIN",
      -  "TWITTER",
      -  "THREADS",
      -  "BLUESKY",
      -  "MASTODON",
      -  "YOUTUBE",
      -  "FACEBOOK",
      -  "INSTAGRAM"
      -]New value: +[
      +  "LINKEDIN",
      +  "TWITTER",
      +  "BLUESKY",
      +  "MASTODON",
      +  "YOUTUBE",
      +  "FACEBOOK",
      +  "INSTAGRAM"
      +]
    • changedInput schema / properties / posts / items / 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, Tumblr, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube, Google Business Profile 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, Tumblr, WordPress, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube, Google Business Profile and videos ignore it"
    • changedInput schema / properties / posts / items / 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, 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"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, INSTAGRAM, LINKEDIN, PINTEREST and TELEGRAM take an image (thumbnailUrl) 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 / posts / items / properties / threadReplies / description
      Previous value: -"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"New value: +"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), 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"
    • changedInput schema / properties / posts / items / properties / threadReplies / items / properties / platform / enum
      Previous value: -[
      -  "TWITTER",
      -  "THREADS",
      -  "BLUESKY",
      -  "MASTODON"
      -]New value: +[
      +  "TWITTER",
      +  "BLUESKY",
      +  "MASTODON"
      +]
    • changedInput schema / properties / posts / items / properties / thumbnailTimestampMs / description
      Previous value: -"Video frame timestamp (ms) to use as the thumbnail, used by INSTAGRAM, PINTEREST and TIKTOK unless platformThumbnails overrides it"New value: +"Video frame timestamp (ms) to use as the thumbnail on every platform that takes one: YOUTUBE, FACEBOOK, INSTAGRAM, LINKEDIN, PINTEREST, TELEGRAM and TIKTOK. A thumbnailUrl sent with it wins everywhere except TIKTOK, which takes only a frame, and platformThumbnails overrides both"
    • changedInput schema / properties / posts / items / properties / tiktokConfigs / items / properties / caption / description
      Previous value: -"TikTok-specific caption (max 2200 chars)"New value: +"TikTok-specific caption: up to 2200 characters on a video, 4000 on a photo or photo carousel post"
    • changedInput schema / properties / posts / items / properties / tiktokConfigs / items / properties / caption / maxLength
      Previous value: -2200New value: +4000
    • addedInput schema / properties / posts / items / properties / wordpressConfigs
      Added value: +{
      +  "description": "WordPress config for this item only, such as its own title or categories; replaces the batch-level wordpressConfigs",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "categoryIds": {
      +        "description": "Category ids from list_wordpress_categories for this site. Omitted, WordPress files the post under the site's default category",
      +        "items": {
      +          "minimum": 1,
      +          "type": "integer"
      +        },
      +        "maxItems": 50,
      +        "type": "array"
      +      },
      +      "connectionId": {
      +        "description": "WordPress site account id from list_accounts",
      +        "type": "string"
      +      },
      +      "excerpt": {
      +        "description": "Summary WordPress shows in post lists and feeds",
      +        "maxLength": 1000,
      +        "type": "string"
      +      },
      +      "tags": {
      +        "description": "Tag names, up to 50. A tag the site does not have yet is created when the WordPress user may manage tags, and skipped otherwise",
      +        "items": {
      +          "maxLength": 100,
      +          "type": "string"
      +        },
      +        "maxItems": 50,
      +        "type": "array"
      +      },
      +      "title": {
      +        "description": "Post title. Defaults to the first line of the text, cut to 100 characters",
      +        "maxLength": 300,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "connectionId"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / posts / items / properties / youtubeConfigs / items / properties / defaultAudioLanguage
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maxLength": 35,
      +      "pattern": "^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "Language spoken in the video's original audio, as a BCP-47 tag such as en, pt-BR or es-419, so YouTube does not treat it as another language. null clears a saved value. It does not turn off YouTube's automatic dubbing"
      +}
    • addedInput schema / properties / wordpressConfigs
      Added value: +{
      +  "description": "WordPress per-site config: title, excerpt, categories and tags. connectionId must match an entry in wordpressConnectionIds",
      +  "items": {
      +    "$ref": "#/properties/posts/items/properties/wordpressConfigs/items"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / wordpressConnectionIds
      Added value: +{
      +  "description": "WordPress sites to post to, by the account id from list_accounts. WORDPRESS publishes the text as the body of a blog post, up to 100,000 characters: blank lines start new paragraphs and bare links become clickable. It takes up to 20 JPEG, PNG, WebP or GIF images (20 MB each) or one MP4 or MOV video (500 MB); the first image is the featured image and the other images or the video follow the text. A site without an entry in wordpressConfigs uses the first line of the text as the title. WordPress has no first comments, threads, thumbnails, image shapes or analytics",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
  9. Changed1 schema field changed
    • 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"
  10. Added

TDQS

A4.6/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=true and destructiveHint=false, but the description adds real value beyond them: no uploads/writes occur, one report per item in input order, and the permission requirement. It does not discuss batch-size limits or failure modes of the validation call itself, so it stops short of a 5.

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

Conciseness5/5

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

Four tight sentences, front-loaded with the identity of the tool, then behavior, then the report shape, then the next action. No sentence is redundant and nothing is buried.

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

Completeness4/5

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

For a 26-parameter dry-run tool this is close to complete: identity, input equivalence, output shape, permission, and next step are all covered, and an output schema exists to carry the report fields. Minor gaps remain around batch limits and how per-item failures are surfaced beyond the 'valid' flag.

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

Parameters4/5

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

Schema coverage is 100% across 26 parameters, so baseline is 3; the description earns an extra point by stating that the input is exactly the same as bulk_schedule_posts, which lets the agent reuse an already-constructed payload rather than re-deriving field semantics.

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?

Opens with a specific verb+resource ('Dry-run bulk_schedule_posts') and immediately names the sibling it mirrors, so the agent knows this validates rather than creates. It also names validate_post as the semantic analogue for report shape, distinguishing it from both siblings.

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?

Gives an explicit workflow: run this first, fix items with ERROR issues, then call bulk_schedule_posts. It also states the precondition ('Needs the posts.draft permission') and that no confirmation is required, which removes the usual mutation-approval step.

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