add_post_note
ChatGPTWrites a note on a post for the team, or a reply in a thread (parentId). Only the team sees it unless shared is true, which shows it to the client on their approval link; a reply in a thread the client can see is shown to them whatever shared says. Say what the note will say before writing it.
analytics_summary
ChatGPTTotals across a recent period: how many posts went out, and what they earned.
audience
ChatGPTFollowers on each channel whose network reports them, as daily readings over a period, with the change across it. scopeMissing means the network has the figure but this connection may not read it — reconnecting fixes that.
complete_media_upload
ChatGPTConfirms the bytes are in, after the PUTs from create_media_upload. For a multipart upload pass every part with the ETag its PUT returned. Answers with the file, as get_media does.
create_media_upload
ChatGPTStarts uploading a video, image or document (PDF, PPT, PPTX, DOC, DOCX up to 100 MB, for LinkedIn only). The file never passes through this server: the answer carries signed URLs to PUT the bytes to (one URL, or one per part for files over 16 MB). After the PUTs, call complete_media_upload, then get_media until status is ready. Alternatively pass sourceUrl and the server fetches a public URL itself.
create_pinterest_board
ChatGPTCreates a board on a Pinterest channel, for a pin to go to. Public boards show on the profile at once; secret ones only to the account. A board of the same name that already exists is returned instead of making a second, so calling again after a timeout is safe. The first board a channel gets becomes where pins go when pinterest.boardId is left out.
create_post
ChatGPTCreates a real post on any mix of networks: scheduled (scheduledAt), into the queue, published now (publishNow + confirmPublishNow) or saved as a draft. Unlike draft_post this publishes. Takes files, and per-network settings such as youtube.title, youtube.tags or tiktok.privacy (required for TikTok). idempotencyKey is required: calling again with the same key returns the first post instead of publishing twice, so reuse it when retrying after a timeout. Run validate_post first. A refusal for the plan's allowance carries limit and upgradeTo.
create_youtube_playlist
ChatGPTCreates a playlist on a YouTube channel, visible there at once unless made private. A playlist of the same name that already exists is returned instead of making a second, so calling again after a timeout is safe.
delete_post
ChatGPTDeletes a post from Preflight: a draft, or a scheduled post that then never goes out (this is how a post is cancelled; a YouTube video already waiting on YouTube for its time is deleted there too). On a post that has already gone out it removes only Preflight's record — what is live stays on the networks; run delete_published_post on each channel first to take it down there. Cannot be undone: needs confirmDelete after the person has agreed.
delete_published_post
ChatGPTDeletes a post that has gone out from the network itself — the video, pin or status disappears there. Only where the network allows it (canDeleteRemote in get_post). Preflight keeps the record, marked as deleted. Cannot be undone: needs confirmDelete after the person has agreed.
draft_post
ChatGPTWrites a text-only draft into the composer for a person to review, choose a time for and publish. It does not publish and it does not schedule. For a draft with files and network settings use create_post with saveAsDraft. Send an idempotencyKey so a retry after a timeout does not leave two drafts.
edit_published_post
ChatGPTChanges the text (and, where the network has one, the title) of a post that has already gone out, on that network itself. Only where the network allows it: canEditRemote in get_post says so. Changes what people see, so it needs posts:publish.
get_media
ChatGPTA file and where it is: awaiting_upload, ingesting (being fetched), processing, ready, failed (with error) or deleted. A post can use it once it is ready.
get_post
ChatGPTOne post and what happened on every channel: status, link, the network's id (videoId for YouTube), any error with its errorCode and whether it is permanent, when it will be tried again, each channel's stored settings, and any warning — a refused thumbnail, say, which does not fail the video.
get_usage
ChatGPTThe workspace's plan and this month's allowance: publishes used and left (each channel a post goes to is one), channels connected and paused, bytes sent to networks, the largest file, AI rewrites and reviews, when it all resets, and, where the app allows it, the plans above with what they allow. Check it before a batch: a refusal for the allowance stops the batch at the line.
list_channels
ChatGPTThe social accounts this workspace can publish to: the network each belongs to, whether it needs reconnecting, whether the plan has paused it, its time zone, and whether posts on it can be deleted from the network. channelId is what every other tool takes.
list_pinterest_boards
ChatGPTThe boards of a Pinterest channel. Every pin needs one: pass its id as pinterest.boardId.
list_posts
ChatGPTPosts, most recent first by when they went out (still-to-come posts are always included). Filter by status, channel, network, tag, a from/to window, or failedOnly for posts with a channel that failed. Each channel's status, link, error, errorCode and whether it is permanent. Page with cursor: pass back nextCursor until it is absent — a page can hold fewer than limit after filtering. get_post gives one post in full.
list_youtube_playlists
ChatGPTA YouTube channel's playlists. Pass one's id as youtube.playlistId to add the video to it.
next_queue_times
ChatGPTWhen the queue would next reach each channel, from its posting schedule. at is null for a channel with no slots set up — create_post with queue: true refuses those.
post_insights
ChatGPTOne channel's copy of a published post: its current figures (views, likes, comments, shares, saves, reach, watch time — whichever the network reports), how they grew reading by reading, and on YouTube the retention curve and where the views came from. post_performance gives the same as a short summary.
post_notes
ChatGPTThe team's and the client's notes on a post before it goes out, oldest first: each thread's first note (with the words of the post it quotes, if any) followed by its replies. Not the network's comments; those are list_comments. shared notes are the ones the client sees on their approval link; fromClient ones the client wrote.
post_performance
ChatGPTOne published post's figures on one network: views, likes, comments, and where it can be measured, how much of the video was watched, the retention curve and where the views came from. Takes a targetId from list_posts.
retry_post
ChatGPTSends a post again to the channels where it failed, straight away; channels where it went out are left alone. Check errorPermanent and errorCode in get_post first: a permanent failure (a refused file, a lost connection) fails again until it is fixed.
tiktok_creator_info
ChatGPTWhat TikTok allows this account right now: the privacy levels it may post with (tiktok.privacy must be one of them — ask the person which), whether the creator has switched off comments, duets or stitches, and the longest video it takes. TikTok asks for this before every post.
update_post
ChatGPTChanges a post that has not gone out yet: caption, link, files, channels, network settings (merged into what each channel has; null removes a setting) and when it goes — scheduledAt, queue, or publishNow with confirmPublishNow. Giving a draft a time schedules it for real. Only the fields you send change. With posts:write alone it can edit drafts; anything that changes what will be published — a scheduled post, or scheduling a draft — needs posts:publish. A refusal for the plan's allowance carries limit and upgradeTo.
validate_post
ChatGPTA dry run of create_post with the same arguments: checks every channel, file, time and network limit, the plan's monthly allowance and paused channels, and says what the server would do. Nothing is created. Run it before create_post.