archive_post
ChatGPTArchive a post: it leaves the active list and stops being published, and it can be restored from the PostRite app. Also needs the organization's "Allow deleting via remote MCP" setting (else 403 "MCP delete is disabled").
cancel_post
ChatGPTCancel a post so it will not publish. Works on SCHEDULED posts and on posts waiting for external approval (PENDING_APPROVAL); any other status is refused.
create_post
ChatGPTCreate a post targeting one or more connected platform accounts. Control what happens with submissionIntent: 'draft' (save only — the response then carries advisory validationWarnings listing anything that must be fixed before scheduling), 'publish-now', or 'schedule' with a future scheduledAt (ISO 8601 with a UTC offset, e.g. 2026-10-20T09:00:00-03:00 — the timezone parameter does not shift it). platformConnectionIds come from list_platform_connections; the API assigns each connection its platform's canonical posting destination. Attach media with mediaIds (stable library IDs from list_media / import_media_from_url — preferred over URLs). Set platform-specific options via metadata (every network's options — see the metadata parameter), override text per platform with platformContents, and set requiresApproval + approvalEmail to route the post through external approval. When unsure the payload is valid, call validate_post first with the same input. Platform rules (enforced by the API — validate_post checks all of them): - Facebook: ≤63206 chars, ≤10 images, ≤1 videos, video 1–14400s, supports first comment - Instagram: ≤2200 chars, media REQUIRED, ≤10 images, ≤1 videos, video 3–900s, supports first comment - Threads: ≤500 chars, ≤10 images, ≤1 videos, video 0–300s, supports first comment - X (Twitter): ≤280 chars (25000 with a long-post subscription), ≤4 images, ≤1 videos, supports first comment - LinkedIn: ≤3000 chars, ≤9 images, ≤1 videos, video 3–1800s - TikTok: ≤2200 chars, media REQUIRED, ≤35 images, ≤1 videos, video 3–600s, supports first comment (TikTok Business connections only) - YouTube: ≤5000 chars, VIDEO REQUIRED, ≤1 images, ≤1 videos - Telegram: ≤4096 chars (≤1024 with media), ≤10 images, ≤1 videos - WhatsApp: ≤4096 chars (≤1024 with media), ≤1 images, ≤1 videos - Pinterest: ≤500 chars, media REQUIRED, ≤5 images, ≤1 videos, video 4–900s - Google Business: ≤1500 chars, ≤10 images, ≤1 videos - Discord: ≤2000 chars, ≤10 images, ≤1 videos - Bluesky: ≤300 chars, ≤4 images, ≤1 videos, video 0–180s - Mastodon: ≤500 chars, ≤4 images, ≤1 videos - Images and a video in the same post are refused on Facebook, LinkedIn, Pinterest, X (Twitter), Bluesky, Mastodon, TikTok — attach one kind per post (or per platform override) - X counts weighted length, not characters: every URL counts 23, CJK characters count 2, each emoji counts 2; the ≤280 limit applies to that count - X long posts: an X connection whose metadata.subscriptionType (list_platform_connections) is Basic, Premium, PremiumPlus may post up to 25000; every X connection the post targets must have one, or the whole post is held to 280. The first comment stays ≤280. A subscription bought after connecting counts once an owner or admin presses Refresh on the X connection in PostRite - Bluesky counts graphemes (what a reader sees as one character, so an emoji is 1), not UTF-16 units; the ≤300 limit applies to that count - Pinterest: requires metadata.pinterest.boardId (from list_pinterest_boards) unless the account has a default board - Discord bot connections: require metadata.discord.channels (map of platformConnectionId -> channelId, from list_discord_channels) - WhatsApp: requires metadata.whatsappRecipient (phone number) - TikTok: requires metadata.tiktokOptions.privacyLevel, one of the account's privacy_level_options from get_tiktok_creator_info - TikTok connection method (metadata.authMethod on list_platform_connections: "business_api" is TikTok Business, absent or "login_kit" is Login Kit): a TikTok Business VIDEO publishes public only — metadata.tiktokOptions.privacyLevel must be PUBLIC_TO_EVERYONE — and is capped at 1 GB (Login Kit: 4 GB); photo posts keep the privacy_level_options from get_tiktok_creator_info on both - TikTok Business only (Login Kit refuses both): metadata.tiktokOptions.uploadAsDraft: true sends the video to the creator's TikTok drafts instead of publishing it — TikTok then ignores everything but the caption, though privacyLevel must still be set — and metadata.tiktokOptions.coverMediaId (a library image) sets a separate video cover, which …
create_template
ChatGPTCreate a reusable content blueprint. Beyond the shared text and media, a template can target specific networks (platforms) and carry a different body or different media per network (platformContent), plus the portable network options (metadata) such as a YouTube title or Instagram collaborators. Attach media with mediaIds from list_media / import_media_from_url. Account-bound settings — Pinterest board, Discord channel, WhatsApp recipient, TikTok privacy — are NOT part of a template; set those on the post or automation that publishes it. Platform rules (enforced by the API — validate_post checks all of them): - Facebook: ≤63206 chars, ≤10 images, ≤1 videos, video 1–14400s, supports first comment - Instagram: ≤2200 chars, media REQUIRED, ≤10 images, ≤1 videos, video 3–900s, supports first comment - Threads: ≤500 chars, ≤10 images, ≤1 videos, video 0–300s, supports first comment - X (Twitter): ≤280 chars (25000 with a long-post subscription), ≤4 images, ≤1 videos, supports first comment - LinkedIn: ≤3000 chars, ≤9 images, ≤1 videos, video 3–1800s - TikTok: ≤2200 chars, media REQUIRED, ≤35 images, ≤1 videos, video 3–600s, supports first comment (TikTok Business connections only) - YouTube: ≤5000 chars, VIDEO REQUIRED, ≤1 images, ≤1 videos - Telegram: ≤4096 chars (≤1024 with media), ≤10 images, ≤1 videos - WhatsApp: ≤4096 chars (≤1024 with media), ≤1 images, ≤1 videos - Pinterest: ≤500 chars, media REQUIRED, ≤5 images, ≤1 videos, video 4–900s - Google Business: ≤1500 chars, ≤10 images, ≤1 videos - Discord: ≤2000 chars, ≤10 images, ≤1 videos - Bluesky: ≤300 chars, ≤4 images, ≤1 videos, video 0–180s - Mastodon: ≤500 chars, ≤4 images, ≤1 videos - Images and a video in the same post are refused on Facebook, LinkedIn, Pinterest, X (Twitter), Bluesky, Mastodon, TikTok — attach one kind per post (or per platform override) - X counts weighted length, not characters: every URL counts 23, CJK characters count 2, each emoji counts 2; the ≤280 limit applies to that count - X long posts: an X connection whose metadata.subscriptionType (list_platform_connections) is Basic, Premium, PremiumPlus may post up to 25000; every X connection the post targets must have one, or the whole post is held to 280. The first comment stays ≤280. A subscription bought after connecting counts once an owner or admin presses Refresh on the X connection in PostRite - Bluesky counts graphemes (what a reader sees as one character, so an emoji is 1), not UTF-16 units; the ≤300 limit applies to that count - Pinterest: requires metadata.pinterest.boardId (from list_pinterest_boards) unless the account has a default board - Discord bot connections: require metadata.discord.channels (map of platformConnectionId -> channelId, from list_discord_channels) - WhatsApp: requires metadata.whatsappRecipient (phone number) - TikTok: requires metadata.tiktokOptions.privacyLevel, one of the account's privacy_level_options from get_tiktok_creator_info - TikTok connection method (metadata.authMethod on list_platform_connections: "business_api" is TikTok Business, absent or "login_kit" is Login Kit): a TikTok Business VIDEO publishes public only — metadata.tiktokOptions.privacyLevel must be PUBLIC_TO_EVERYONE — and is capped at 1 GB (Login Kit: 4 GB); photo posts keep the privacy_level_options from get_tiktok_creator_info on both - TikTok Business only (Login Kit refuses both): metadata.tiktokOptions.uploadAsDraft: true sends the video to the creator's TikTok drafts instead of publishing it — TikTok then ignores everything but the caption, though privacyLevel must still be set — and metadata.tiktokOptions.coverMediaId (a library image) sets a separate video cover, which makes TikTok ignore videoCoverTimestampMs - TikTok first comment: metadata.tiktokOptions.firstComment (≤1200 chars) is posted only on a TikTok Business connection and never on an uploadAsDraft post; on Login Kit the post still publishes but the comment is not posted (validate_post warns with validation.tiktokFirstCommentBusinessOnly) - TikTok photo carousels: metadata.tiktokOptions.photoTitle is an optional headline…
delete_media
ChatGPTPermanently delete a media file from the library. Refused with a conflict (MEDIA_IN_USE) while the file is still used by a post that has not published yet (draft, scheduled, pending approval or publishing) or by a template; the error lists those posts and templates, so detach the file with update_post / update_template or remove them with archive_post / delete_template first. A 502 (MEDIA_STORAGE_DELETE_FAILED) means storage refused the file and nothing was deleted: the file is still in the library, so call delete_media again later rather than reporting it gone.
delete_template
ChatGPTPermanently delete a template.
get_account_insights
ChatGPTAccount-level insights of ONE connected account: the follower total and its growth for every platform, and what each platform adds. Platforms and the figures each one reports (the activity.series / activity.totals keys; the follower total is followers.current, and followersNow): Instagram (INSTAGRAM): followersCount, followerCount, follows, unfollows, reach, views, accountsEngaged, totalInteractions, likes, comments, saves, shares, replies, reposts, profileLinksTaps; Facebook (FACEBOOK): followersCount; YouTube (YOUTUBE): followersCount; Pinterest (PINTEREST): followersCount, impressions, totalInteractions, saves, pinClicks, outboundClicks; TikTok (TIKTOK): followersCount; Bluesky (BLUESKY): followersCount; Mastodon (MASTODON): followersCount; X (Twitter) (TWITTER): followersCount. Only Instagram (connected through either Instagram Login or Facebook Login) reports reach, views, accounts engaged, follows and unfollows per day and the audience's country, city and age/gender; Pinterest reports a daily series of impressions, totalInteractions (Pinterest's own engagement count), saves, pinClicks and outboundClicks; Facebook, YouTube, TikTok, Bluesky, Mastodon, X (Twitter) report the follower total only, so for them activity, followChanges and both demographics blocks come back NO_DATA, which means the platform does not report that block — it is not a zero and not "yet", so do not promise it will fill in. YouTube rounds its subscriber count down to three significant figures, so a YouTube channel's followers are YouTube's rounded figure, and a channel that hides its subscriber count has none. TikTok means Login Kit accounts (a TikTok Business account is refused). Collected once a day; every platform's follower series starts on the first day PostRite collected the account (for an account connected before account insights shipped, the first nightly run after that, not the day it was connected), so a new account has a single point (Pinterest also backfills the last 30 days of its daily series and stores only days Pinterest has finished counting, a few days late). Instagram: reports with a delay of up to 48 hours, so the latest days can still change (dataLagHours is that Instagram figure); the first collection backfills the last 30 days of reach and of the daily follower change and the last 7 days of views, accounts engaged, interactions, follows and unfollows, while the follower total and the audience start on the first day PostRite collected the account, so a new account has fewer days than the period asked; Instagram reports the follower figures only for accounts with at least 100 followers (minFollowers). Every block (followers, activity, followChanges, demographics.followers, demographics.engaged) is {data, reason}: either its data or the reason it has none (MISSING_PERMISSION, NOT_OFFERED, BELOW_FOLLOWER_THRESHOLD, NOT_COLLECTED_YET, NO_DATA, CONNECTION_INACTIVE, METRICS_OFF, METRICS_PAUSED) — an empty block is NOT zero, so say why it is empty instead of reporting 0. MISSING_PERMISSION and CONNECTION_INACTIVE are fixed by reconnecting the account in PostRite (MISSING_PERMISSION is Instagram's); NOT_OFFERED means PostRite does not request the permission right now, so reconnecting changes nothing; BELOW_FOLLOWER_THRESHOLD is Instagram's rule (followersNow and minFollowers say how far the account is); NOT_COLLECTED_YET resolves after the next daily run, and after the next weekly read for the audience (up to a week); NO_DATA means the platform answered with an empty dataset, or does not report that block at all. METRICS_OFF and METRICS_PAUSED are X's: reading an X account's metrics may add costs to the customer's own X developer account, so it is off until someone turns it on with the switch on the account's card in the app's Platforms page (METRICS_OFF), and X refusing the read (no credit left, or keys without read access) pauses it until someone clicks Resume there (METRICS_PAUSED) — no tool changes either, so tell the user where the switch is; what was collected before stays readable. In activity.series a null metric on a day …
get_analytics_insights
ChatGPTInsights computed from the organization's own posting history over the last 12 months: best day/time slots to post (by average lifetime engagement per publication), engagement by content type (text/image/video), weekly posting cadence vs engagement, and averages. In bestTimes, dayOfWeek is 0 = Sunday … 6 = Saturday and slot n covers hours [n×4, (n+1)×4) — e.g. slot 2 is 8:00–12:00 — both in the organization's timezone; topSlots only includes cells with at least 3 samples. Treat thin buckets as hints, and say so when notEnoughData is true. Restrict every block to one platform or one connected account. For one Instagram account the response also carries audienceActivity: {data, reason} with the hours your followers are online (same dayOfWeek/slot cells, avgOnline followers per hour), or the reason it is empty (MISSING_PERMISSION, NOT_OFFERED, BELOW_FOLLOWER_THRESHOLD, NOT_COLLECTED_YET, NO_DATA, CONNECTION_INACTIVE, METRICS_OFF, METRICS_PAUSED) — never read an empty block as zero. For concrete times to schedule at, use suggest_posting_times.
get_analytics_summary
ChatGPTFetch aggregated engagement for the organization's published posts in a period: metric totals, per-platform breakdown, and an engagement-gained-per-day series.
get_approval_events
ChatGPTReturn the approval timeline of a post (requested / resent / reminded / approved / rejected / changes-requested / expired), each with the actor email, optional note, and timestamp.
get_billing_status
ChatGPTFetch the organization's plan, subscription status, post usage, and limits — and, for a subscription paid by Pix (subscription.paymentMethod: pix), the amount and deadlines of the invoice waiting to be paid. The Pix code itself is not returned: paying happens in the PostRite app, under Settings → Billing. Requires the organization owner role.
get_competitor_snapshots
ChatGPTPublic figures of the other Instagram Business and Creator accounts the organization tracks, next to the organization's own Instagram account measured the same way. Read once a day through Instagram Business Discovery over each account's last 25 posts, so the two sides are comparable; competitors are added, refreshed and removed in the PostRite app by an Editor, not here. Without competitorId it returns every tracked competitor: its latest reading (followersCount, avgLikes, avgComments, avgViews, postsPerWeek, engagementPerFollower, followersChange30d over followersChangeDays days, lastPostAt), its status, up to 5 top posts (permalink, mediaType, timestamp and counts only; captions are never stored) and ourAccount, our reading to compare with, plus max (the ceiling on tracked competitors) and discovery {available, reason, connections}: when available is false nothing can be added or refreshed, and reason says who can act (NO_CONNECTION: connect Instagram through Facebook; MISSING_PERMISSION: reconnect that account so it grants the permission; NOT_OFFERED: PostRite does not request the permission right now, so reconnecting changes nothing). With competitorId (from this tool's list) it returns that competitor's stored days over days (default 30), oldest first, to show a trend. A null figure was not returned, never zero: an account that hides its like counts has null avgLikes and engagementPerFollower, and followersChange30d is null until two days are stored. postsLast30d counts the posts in the last 30 days, and when postsWindowDays is under 30 the sample of 25 posts ended before reaching that far back, so postsLast30d is a lower bound; postsPerWeek is already divided by postsWindowDays, so it is the rate over the days that were covered and not a lower bound. A competitor whose status is not ACTIVE (ACTIVE, NOT_FOUND, NOT_BUSINESS, UNAVAILABLE, NO_CONNECTION, RATE_LIMITED, ERROR) was not read on its last attempt: lastError carries Instagram's code, and the stored figures are from its last good read (capturedDate). NOT_FOUND cannot tell a handle that does not exist from a personal account, which Business Discovery cannot read; NO_CONNECTION is fixed by reconnecting Instagram in PostRite, and a competitor left at it for 90 days is removed with its stored days; RATE_LIMITED and ERROR retry with the next daily read.
get_conversation_messages
ChatGPTRead one conversation: the conversation itself (contact, window, status) and its messages, newest first. direction INBOUND is the contact, OUTBOUND the account (sentById set when a person or assistant sent it, flowRunId when an automation did). Attachments a contact sent are not stored by PostRite (external: true): describe them, do not claim to have seen them. Needs the organization's "Let AI assistants answer comments and messages" setting (owner-only; without it the api answers MCP_INBOX_DISABLED) and a connection authorized with the comments/chat permissions — one authorized before they existed must reconnect, and a client that kept its own registration from before then must remove PostRite and add it again.
get_media_usage
ChatGPTFetch the organization's media storage usage and quota.
get_platform_availability
ChatGPTReport which platforms are currently disabled or under maintenance. Check this if publishing to a platform is failing unexpectedly.
get_post
ChatGPTFetch a single post by ID, including its per-platform targets and status, platform options (metadata), and media (referenced by ID).
get_post_analytics
ChatGPTFetch per-platform engagement metrics for a post (views, likes, comments, shares, saves, clicks, impressions — whatever each platform exposes), including the daily snapshot series. Instagram posts, and Pinterest standard pins (follows and profileVisits only), may also carry detail, built field by field from the latest snapshots that reported each one (detail.asOf is the newest such day) and NOT part of engagement: follows, profileVisits, profileActivity, replies, totalInteractions, linkClicks, reelsAvgWatchTimeMs, reelsTotalWatchTimeMs, reelsSkipRate (Reels watch times are in milliseconds, reelsSkipRate is a percentage, 0-100) and, for Stories, storyNavigation (tapForward, tapBack, tapExit, swipeForward). A null or missing detail value means the platform did not report it, never zero — a Story with fewer than 5 viewers reports nothing. A Story's replies is null, not 0, when Instagram returns 0 (it does so for every Story created in Europe or Japan, whatever happened), so a null replies does not mean nobody replied. final: true on a platform means no more snapshots will be collected (an Instagram Story past 24 hours), so latest is its last word. metricsState (OFF or PAUSED) on a platform means that account's metrics are not being collected by its owner's choice or because the platform refused the read — X metrics are billed to the customer's own X developer account, so they run only when turned on in the app's Platforms page; tell the user that rather than reading it as zero engagement. Find post IDs with list_posts.
get_template
ChatGPTFetch a single template by ID, including its per-network text and media overrides and its network options.
get_tiktok_creator_info
ChatGPTRead what a connected TikTok account allows right now: privacy_level_options (tiktokOptions.privacyLevel must be one of them — never assume PUBLIC_TO_EVERYONE is available), whether comments, duets and stitches are disabled for the creator, and the longest video it may post. Ask the user which privacy level to use; TikTok does not allow a default to be chosen for them. The shape is the same for a TikTok Business connection (metadata.authMethod "business_api" on list_platform_connections): photo posts use the account's privacy_level_options, but a VIDEO on that connection publishes public only, so its privacyLevel must be PUBLIC_TO_EVERYONE (the one exception is tiktokOptions.uploadAsDraft, which sends the video to the creator's drafts).
get_top_posts
ChatGPTRank the organization's posts by an engagement metric over a period. Defaults to overall engagement (sum of all metrics). Returns at most the 10 best posts: there is no limit or page parameter, so narrow days or change metric to see others. Each post may carry media — a reference to its first media item in the library ({id, mimeType, hasThumbnail}), not a URL; null when the post has no media.
import_media_from_url
ChatGPTDownload an image, video, audio file or PDF document from a public http(s) URL into the media library. Images up to 10 MB, audio up to 25 MB, PDF documents up to 100 MB and videos up to 200 MB; the file type is taken from the file's own bytes, not its URL or extension, and internal/private addresses are refused. A larger video has to be uploaded from the PostRite app, which sends it straight to storage — there is no import path for it here. Audio files and PDF documents are for chat: a post publishes images and videos only and refuses them. Returns the new media record (use the id of an image or a video as a mediaId on a post). Importing the same file twice returns the existing record rather than a copy.
list_conversations
ChatGPTList direct-message conversations across the connected accounts (Instagram, Messenger and other channels switched on), most recent first. Each carries the contact, unreadCount, lastMessagePreview and window: isOpen says whether a message can be sent now (a network accepts replies only for a while after the contact's last message — 24 hours on Instagram and Messenger), canPrivateReply whether the one private reply to a comment is still available. Needs the organization's "Let AI assistants answer comments and messages" setting (owner-only; without it the api answers MCP_INBOX_DISABLED) and a connection authorized with the comments/chat permissions — one authorized before they existed must reconnect, and a client that kept its own registration from before then must remove PostRite and add it again.
list_discord_channels
ChatGPTList the text and announcement channels of the server a Discord bot connection is in, with whether the bot can post in each (canPost, and the reason when it cannot). A post to a bot connection needs metadata.discord.channels[platformConnectionId] set to one of these channel ids. Webhook connections post to a fixed channel and need none.
list_media
ChatGPTList the organization's media library, newest first. It holds images and videos, which posts publish, and audio files and PDF documents, which are there for chat (inbox replies and flow steps) and which a post refuses. Check each file's mimetype, and use the id of an image or a video as a mediaId when creating or updating a post.
list_organizations
ChatGPTList the organizations this connection may act in, with each one's id, name, timezone, your role in it, and whether deleting through the assistant is allowed there. When there is more than one, pass the chosen id as organizationId to every other tool. To reach an organization that is not listed, the user must reconnect and select it on the consent screen.
list_pinterest_boards
ChatGPTList the boards of a connected Pinterest account. A Pinterest post needs metadata.pinterest.boardId set to one of these ids, unless the account has a default board.
list_platform_connections
ChatGPTList the organization's connected social accounts, including any that are out of service. Use the returned connection IDs as platformConnectionIds when creating or updating a post — but not where health is INACTIVE, DISCONNECTED or EXPIRED — those need the account owner to reconnect first and the api rejects a post targeting them. EXPIRING is fine to post to: it means the authorization lapses within a few days and cannot renew itself, so the account owner should reconnect soon. PostRite renews every other connection's authorization automatically — HEALTHY and DEGRADED need nothing from the user, so do not warn about token expiry unless health says EXPIRING or EXPIRED. Instagram and TikTok connections carry metadata.authMethod, the way the account was connected (Instagram: instagram_login or facebook_login; TikTok: login_kit, or business_api for TikTok Business, which an absent value also means as login_kit) — it decides what a post to that account may use, e.g. TikTok drafts and a separate cover image exist only on business_api. X connections carry metadata.subscriptionType, the account's X subscription as X reports it (absent until PostRite has read it): Basic, Premium, PremiumPlus let a post to that account run past 280 characters, up to 25000 (see the X long-post rule in create_post).
list_posts
ChatGPTList the organization's posts, newest scheduled time first unless sortBy/sortOrder say otherwise. Use this to find a post's ID before getting, updating, rescheduling, cancelling, or retrying it. Filter by status or a scheduled-time window. Returns compact post summaries (draft posts have scheduledAt: null and sort last in either direction; use get_post for full detail).
list_saved_replies
ChatGPTThe organization's saved replies — the texts the team uses to answer comments and messages. Prefer them over new wording when one fits, and pass its id as savedReplyId. {{name}} and {{firstName}} are filled with the person's name by the app; when you send one, fill them yourself. Read-only: creating or editing them is done in the app. Needs the organization's "Let AI assistants answer comments and messages" setting (owner-only; without it the api answers MCP_INBOX_DISABLED) and a connection authorized with the comments/chat permissions — one authorized before they existed must reconnect, and a client that kept its own registration from before then must remove PostRite and add it again.
list_templates
ChatGPTList the organization's reusable content templates. Use this to find a template ID.
reschedule_post
ChatGPTMove a scheduled post to a new time. Only works on SCHEDULED posts. WARNING: a new time that is in the past, or less than about 2 minutes from now, does not wait — the post is published immediately to every connected platform, and that cannot be undone. The scheduledAt must include the UTC offset (e.g. 2026-10-20T09:00:00-03:00); the timezone parameter is stored for display and does not shift it.
resend_approval
ChatGPTRe-send the external approval email for a post to its approver(s) — works while it is PENDING_APPROVAL, or after the link expired (mints a fresh link). To list posts awaiting approval, use list_posts with status PENDING_APPROVAL.
retry_post
ChatGPTRetry publishing a FAILED or PARTIALLY_PUBLISHED post to the platforms that did not succeed. Runs now and replaces any automatic retry the post had scheduled. Refused with a 409 (code PUBLISH_RUN_IN_PROGRESS) while a publish run for the post is still going: wait for it to finish, then retry if the post is still not published. Refused with a 409 (code PUBLISH_RUN_CHECK_FAILED) when the queue could not be checked: nothing was changed, try again.
send_message
ChatGPTSend a text message (up to 1000 characters) in a conversation, as the connected account. Only while the conversation's window is open (window.isOpen in list_conversations); outside it the api refuses and says the contact has to write first. A conversation an automation opened from a comment can take its one private reply instead (window.canPrivateReply), once. A send the platform refuses comes back as an error with its reason, never as a success. Needs the organization's "Let AI assistants answer comments and messages" setting (owner-only; without it the api answers MCP_INBOX_DISABLED) and a connection authorized with the comments/chat permissions — one authorized before they existed must reconnect, and a client that kept its own registration from before then must remove PostRite and add it again.
suggest_posting_times
ChatGPTConcrete upcoming times to publish, from the organization's own best-performing slots over the next 14 days (the slot's midpoint hour, in the organization's timezone), skipping slots that already hold a scheduled post for the same account (or platform, or organization). Pass a suggestion's scheduledAt straight to create_post or reschedule_post. Each suggestion carries the slot's average engagement and sample count; dayOfWeek is 0 = Sunday … 6 = Saturday and slot n covers hours [n×4, (n+1)×4) — e.g. slot 2 is 8:00–12:00 — both in the organization's timezone. An empty list names its reason (NOT_ENOUGH_DATA, NO_RELIABLE_SLOTS, ALL_SLOTS_OCCUPIED: too little history, no slot with 3+ samples, or every slot in the horizon already taken) and no time is invented: tell the user rather than guessing.
update_conversation
ChatGPTMark a conversation read, close or reopen it, snooze it, or pause its automations — PostRite's inbox state, nothing is sent to the contact. Needs the organization's "Let AI assistants answer comments and messages" setting (owner-only; without it the api answers MCP_INBOX_DISABLED) and a connection authorized with the comments/chat permissions — one authorized before they existed must reconnect, and a client that kept its own registration from before then must remove PostRite and add it again.
update_media
ChatGPTSet or clear the alternative text of a library image or video. It belongs to the file, not to a post: every post and platform that publishes this file sends the same text (where the network supports alt text). Use list_media to see which files have none.
update_post
ChatGPTUpdate a draft or scheduled post's content, targets, media (prefer mediaIds; an empty mediaIds array leaves the media untouched — removing all media is done in the app), schedule/intent (submissionIntent; scheduledAt needs a UTC offset), platform-specific options (metadata), per-platform text/media overrides, or approval settings. platformContents / platformMediaUrls sent without platformConnectionIds change only the platforms named: a string or array replaces that platform's override, "" or [] removes it so the shared text or media applies, and a platform the post does not publish to is refused (PLATFORM_OVERRIDE_NOT_TARGETED). Sending platformConnectionIds rebuilds every platform from the payload, so include every override you want to keep. Draft saves return advisory validationWarnings instead of blocking. Use validate_post to pre-check a payload. Platform rules (enforced by the API — validate_post checks all of them): - Facebook: ≤63206 chars, ≤10 images, ≤1 videos, video 1–14400s, supports first comment - Instagram: ≤2200 chars, media REQUIRED, ≤10 images, ≤1 videos, video 3–900s, supports first comment - Threads: ≤500 chars, ≤10 images, ≤1 videos, video 0–300s, supports first comment - X (Twitter): ≤280 chars (25000 with a long-post subscription), ≤4 images, ≤1 videos, supports first comment - LinkedIn: ≤3000 chars, ≤9 images, ≤1 videos, video 3–1800s - TikTok: ≤2200 chars, media REQUIRED, ≤35 images, ≤1 videos, video 3–600s, supports first comment (TikTok Business connections only) - YouTube: ≤5000 chars, VIDEO REQUIRED, ≤1 images, ≤1 videos - Telegram: ≤4096 chars (≤1024 with media), ≤10 images, ≤1 videos - WhatsApp: ≤4096 chars (≤1024 with media), ≤1 images, ≤1 videos - Pinterest: ≤500 chars, media REQUIRED, ≤5 images, ≤1 videos, video 4–900s - Google Business: ≤1500 chars, ≤10 images, ≤1 videos - Discord: ≤2000 chars, ≤10 images, ≤1 videos - Bluesky: ≤300 chars, ≤4 images, ≤1 videos, video 0–180s - Mastodon: ≤500 chars, ≤4 images, ≤1 videos - Images and a video in the same post are refused on Facebook, LinkedIn, Pinterest, X (Twitter), Bluesky, Mastodon, TikTok — attach one kind per post (or per platform override) - X counts weighted length, not characters: every URL counts 23, CJK characters count 2, each emoji counts 2; the ≤280 limit applies to that count - X long posts: an X connection whose metadata.subscriptionType (list_platform_connections) is Basic, Premium, PremiumPlus may post up to 25000; every X connection the post targets must have one, or the whole post is held to 280. The first comment stays ≤280. A subscription bought after connecting counts once an owner or admin presses Refresh on the X connection in PostRite - Bluesky counts graphemes (what a reader sees as one character, so an emoji is 1), not UTF-16 units; the ≤300 limit applies to that count - Pinterest: requires metadata.pinterest.boardId (from list_pinterest_boards) unless the account has a default board - Discord bot connections: require metadata.discord.channels (map of platformConnectionId -> channelId, from list_discord_channels) - WhatsApp: requires metadata.whatsappRecipient (phone number) - TikTok: requires metadata.tiktokOptions.privacyLevel, one of the account's privacy_level_options from get_tiktok_creator_info - TikTok connection method (metadata.authMethod on list_platform_connections: "business_api" is TikTok Business, absent or "login_kit" is Login Kit): a TikTok Business VIDEO publishes public only — metadata.tiktokOptions.privacyLevel must be PUBLIC_TO_EVERYONE — and is capped at 1 GB (Login Kit: 4 GB); photo posts keep the privacy_level_options from get_tiktok_creator_info on both - TikTok Business only (Login Kit refuses both): metadata.tiktokOptions.uploadAsDraft: true sends the video to the creator's TikTok drafts instead of publishing it — TikTok then ignores everything but the caption, though privacyLevel must still be set — and metadata.tiktokOptions.coverMediaId (a library image) sets a separate video cover, which makes TikTok ignore videoCoverTimestampMs - TikTok first comment: metadata.tiktokOptions.firstCommen…
update_template
ChatGPTUpdate a template's name, description, shared content or media, targeted networks, per-network overrides (platformContent), network options (metadata), or Instagram contentType. Only the fields you pass change. Pass platformContent as null to clear every per-network override, or metadata as null to clear the network options. Platform rules (enforced by the API — validate_post checks all of them): - Facebook: ≤63206 chars, ≤10 images, ≤1 videos, video 1–14400s, supports first comment - Instagram: ≤2200 chars, media REQUIRED, ≤10 images, ≤1 videos, video 3–900s, supports first comment - Threads: ≤500 chars, ≤10 images, ≤1 videos, video 0–300s, supports first comment - X (Twitter): ≤280 chars (25000 with a long-post subscription), ≤4 images, ≤1 videos, supports first comment - LinkedIn: ≤3000 chars, ≤9 images, ≤1 videos, video 3–1800s - TikTok: ≤2200 chars, media REQUIRED, ≤35 images, ≤1 videos, video 3–600s, supports first comment (TikTok Business connections only) - YouTube: ≤5000 chars, VIDEO REQUIRED, ≤1 images, ≤1 videos - Telegram: ≤4096 chars (≤1024 with media), ≤10 images, ≤1 videos - WhatsApp: ≤4096 chars (≤1024 with media), ≤1 images, ≤1 videos - Pinterest: ≤500 chars, media REQUIRED, ≤5 images, ≤1 videos, video 4–900s - Google Business: ≤1500 chars, ≤10 images, ≤1 videos - Discord: ≤2000 chars, ≤10 images, ≤1 videos - Bluesky: ≤300 chars, ≤4 images, ≤1 videos, video 0–180s - Mastodon: ≤500 chars, ≤4 images, ≤1 videos - Images and a video in the same post are refused on Facebook, LinkedIn, Pinterest, X (Twitter), Bluesky, Mastodon, TikTok — attach one kind per post (or per platform override) - X counts weighted length, not characters: every URL counts 23, CJK characters count 2, each emoji counts 2; the ≤280 limit applies to that count - X long posts: an X connection whose metadata.subscriptionType (list_platform_connections) is Basic, Premium, PremiumPlus may post up to 25000; every X connection the post targets must have one, or the whole post is held to 280. The first comment stays ≤280. A subscription bought after connecting counts once an owner or admin presses Refresh on the X connection in PostRite - Bluesky counts graphemes (what a reader sees as one character, so an emoji is 1), not UTF-16 units; the ≤300 limit applies to that count - Pinterest: requires metadata.pinterest.boardId (from list_pinterest_boards) unless the account has a default board - Discord bot connections: require metadata.discord.channels (map of platformConnectionId -> channelId, from list_discord_channels) - WhatsApp: requires metadata.whatsappRecipient (phone number) - TikTok: requires metadata.tiktokOptions.privacyLevel, one of the account's privacy_level_options from get_tiktok_creator_info - TikTok connection method (metadata.authMethod on list_platform_connections: "business_api" is TikTok Business, absent or "login_kit" is Login Kit): a TikTok Business VIDEO publishes public only — metadata.tiktokOptions.privacyLevel must be PUBLIC_TO_EVERYONE — and is capped at 1 GB (Login Kit: 4 GB); photo posts keep the privacy_level_options from get_tiktok_creator_info on both - TikTok Business only (Login Kit refuses both): metadata.tiktokOptions.uploadAsDraft: true sends the video to the creator's TikTok drafts instead of publishing it — TikTok then ignores everything but the caption, though privacyLevel must still be set — and metadata.tiktokOptions.coverMediaId (a library image) sets a separate video cover, which makes TikTok ignore videoCoverTimestampMs - TikTok first comment: metadata.tiktokOptions.firstComment (≤1200 chars) is posted only on a TikTok Business connection and never on an uploadAsDraft post; on Login Kit the post still publishes but the comment is not posted (validate_post warns with validation.tiktokFirstCommentBusinessOnly) - TikTok photo carousels: metadata.tiktokOptions.photoTitle is an optional headline of ≤90 chars (derived from the caption's first line when omitted); the caption itself is sent as the description (≤4000) - Instagram contentType REEL: exactly 1 video, 3–900s - Instagram contentType STORY: exactly 1 …
validate_post
ChatGPTRun every validation create_post would run — platform rules, media checks, scheduling, connections, metadata shape — without saving anything. Takes the exact same input as create_post and returns { valid, submissionIntent, errors, warnings }; each entry has field/message/errorKey/platform. Call this first when unsure a payload is publishable: you get the full problem list in one call instead of leaving broken drafts behind. Platform rules (enforced by the API — validate_post checks all of them): - Facebook: ≤63206 chars, ≤10 images, ≤1 videos, video 1–14400s, supports first comment - Instagram: ≤2200 chars, media REQUIRED, ≤10 images, ≤1 videos, video 3–900s, supports first comment - Threads: ≤500 chars, ≤10 images, ≤1 videos, video 0–300s, supports first comment - X (Twitter): ≤280 chars (25000 with a long-post subscription), ≤4 images, ≤1 videos, supports first comment - LinkedIn: ≤3000 chars, ≤9 images, ≤1 videos, video 3–1800s - TikTok: ≤2200 chars, media REQUIRED, ≤35 images, ≤1 videos, video 3–600s, supports first comment (TikTok Business connections only) - YouTube: ≤5000 chars, VIDEO REQUIRED, ≤1 images, ≤1 videos - Telegram: ≤4096 chars (≤1024 with media), ≤10 images, ≤1 videos - WhatsApp: ≤4096 chars (≤1024 with media), ≤1 images, ≤1 videos - Pinterest: ≤500 chars, media REQUIRED, ≤5 images, ≤1 videos, video 4–900s - Google Business: ≤1500 chars, ≤10 images, ≤1 videos - Discord: ≤2000 chars, ≤10 images, ≤1 videos - Bluesky: ≤300 chars, ≤4 images, ≤1 videos, video 0–180s - Mastodon: ≤500 chars, ≤4 images, ≤1 videos - Images and a video in the same post are refused on Facebook, LinkedIn, Pinterest, X (Twitter), Bluesky, Mastodon, TikTok — attach one kind per post (or per platform override) - X counts weighted length, not characters: every URL counts 23, CJK characters count 2, each emoji counts 2; the ≤280 limit applies to that count - X long posts: an X connection whose metadata.subscriptionType (list_platform_connections) is Basic, Premium, PremiumPlus may post up to 25000; every X connection the post targets must have one, or the whole post is held to 280. The first comment stays ≤280. A subscription bought after connecting counts once an owner or admin presses Refresh on the X connection in PostRite - Bluesky counts graphemes (what a reader sees as one character, so an emoji is 1), not UTF-16 units; the ≤300 limit applies to that count - Pinterest: requires metadata.pinterest.boardId (from list_pinterest_boards) unless the account has a default board - Discord bot connections: require metadata.discord.channels (map of platformConnectionId -> channelId, from list_discord_channels) - WhatsApp: requires metadata.whatsappRecipient (phone number) - TikTok: requires metadata.tiktokOptions.privacyLevel, one of the account's privacy_level_options from get_tiktok_creator_info - TikTok connection method (metadata.authMethod on list_platform_connections: "business_api" is TikTok Business, absent or "login_kit" is Login Kit): a TikTok Business VIDEO publishes public only — metadata.tiktokOptions.privacyLevel must be PUBLIC_TO_EVERYONE — and is capped at 1 GB (Login Kit: 4 GB); photo posts keep the privacy_level_options from get_tiktok_creator_info on both - TikTok Business only (Login Kit refuses both): metadata.tiktokOptions.uploadAsDraft: true sends the video to the creator's TikTok drafts instead of publishing it — TikTok then ignores everything but the caption, though privacyLevel must still be set — and metadata.tiktokOptions.coverMediaId (a library image) sets a separate video cover, which makes TikTok ignore videoCoverTimestampMs - TikTok first comment: metadata.tiktokOptions.firstComment (≤1200 chars) is posted only on a TikTok Business connection and never on an uploadAsDraft post; on Login Kit the post still publishes but the comment is not posted (validate_post warns with validation.tiktokFirstCommentBusinessOnly) - TikTok photo carousels: metadata.tiktokOptions.photoTitle is an optional headline of ≤90 chars (derived from the caption's first line when omitted); the caption itself is sent as the description (≤…
cancel_post
Claudecreate_post
Claudecreate_template
Claudedelete_media
Claudedelete_post
Claudedelete_template
Claudeget_account_insights
Claudeget_analytics_insights
Claudeget_analytics_summary
Claudeget_approval_events
Claudeget_billing_status
Claudeget_competitor_snapshots
Claudeget_conversation_messages
Claudeget_media_usage
Claudeget_platform_availability
Claudeget_post
Claudeget_post_analytics
Claudeget_template
Claudeget_tiktok_creator_info
Claudeget_top_posts
Claudeimport_media_from_url
Claudelist_conversations
Claudelist_discord_channels
Claudelist_media
Claudelist_organizations
Claudelist_pinterest_boards
Claudelist_platform_connections
Claudelist_posts
Claudelist_saved_replies
Claudelist_templates
Claudereschedule_post
Clauderesend_approval
Clauderetry_post
Claudesend_message
Claudesuggest_posting_times
Claudeupdate_conversation
Claudeupdate_media
Claudeupdate_post
Claudeupdate_template
Claudevalidate_post
Claude