cancel_scheduled_post
ChatGPTAtomically cancel one owned scheduled post before Postminion claims it for publishing. Requires posts:cancel and is repeat-safe for an already-cancelled post.
complete_media_upload
ChatGPTVerify uploaded objects for the given assetIds (size, Content-Type, and real media type), convert PNG and WebP static images to JPEG, scale images larger than TikTok's 1080x1920 envelope down to fit, and mark the assets usable. Call after every curl upload finished; verified assets can then be referenced as media[].assetId in validate_post and the mutation tools. Requires media:write; repeat-safe for already verified assets.
create_draft
ChatGPTCreate exactly one owned Postminion draft with durable requestId replay protection. Requires posts:draft; it does not schedule or publish.
create_media_upload
ChatGPTReserve direct-to-storage uploads for local files (up to 35 per call). Returns, per file, an assetId, a presigned PUT URL valid for one hour, the exact headers, and a ready-to-run curl command. Requires media:write and a client that can run shell commands with open network access; use the url form of media entries for files already on the public web, import_attached_media for files attached in ChatGPT, and otherwise create_draft and its editUrl so the user adds the files in the Postminion editor. PNG and WebP static images are converted to JPEG (transparency flattened onto white) and images larger than TikTok's 1080x1920 envelope are scaled down to fit when the upload is completed, so upload them as is.
get_post
ChatGPTGet revision-bearing editable detail and per-account publishing state for one owned Postminion post. Each account's status updates as that platform finishes; the top-level status is reconciled shortly after, so a post can read queued while every account already reads published. Poll until the top-level status leaves queued. Requires posts:read and does not disclose provider credentials.
import_attached_media
ChatGPTChatGPT only: import the images or videos the user attached in this conversation into the Postminion media library. ChatGPT fills files from the attachments automatically; never ask the user for a path or link. Returns one assetId per file to use as media[].assetId in validate_post and the posting tools. Requires media:write. Use this instead of create_media_upload for files attached in ChatGPT.
list_pinterest_boards
ChatGPTList the boards available to one owned Pinterest connection so a Pin destination can be selected. Requires accounts:read and never returns social credentials.
list_posts
ChatGPTList owned Postminion posts in stable newest-first cursor order with bounded filters and safe summaries. Requires posts:read.
list_social_accounts
ChatGPTList every current social account in the workspace the user authorized, including safe publishing capabilities, required settings, and accepted setting values (for example TikTok privacyLevels). Requires accounts:read and never returns social credentials.
publish_post_now
ChatGPTAccept one publish-ready post into Postminion's asynchronous publishing pipeline. Requires the separately granted posts:publish scope and does not claim downstream publication is complete: poll get_post until the top-level status leaves queued, which usually takes under a minute. Rejected with connection_not_ready when a selected account needs reauthorization; ask the user to reconnect it in Postminion first. Pinterest posts cannot be published by agents; save them with create_draft for the user to publish.
schedule_post
ChatGPTCreate and schedule one new publish-ready post at an explicit local wall-clock time and IANA timezone. Requires posts:schedule and returns scheduled, never already published. A connection_not_ready warning means an account needs reauthorization: tell the user to reconnect it in Postminion before the scheduled time, or the post fails for that account. Pinterest posts cannot be scheduled by agents; save them with create_draft for the user to publish.
update_post
ChatGPTRevision-safely update an owned draft or unclaimed scheduled post. Requires posts:update; moving a draft to scheduled additionally requires posts:schedule. A post with a Pinterest account must stay a draft.
validate_post
ChatGPTValidate a prospective post through Postminion's shared publishing rules without creating content or downloading remote media. Requires accounts:read and an explicit draft or publish_ready mode. A connection_not_ready warning means an account needs reauthorization: drafts and later schedules are still accepted, but publish_post_now is rejected until the user reconnects it.