cancel_scheduled_post
ChatGPTCancel a post that has not been published yet. Cancelling is permanent: the post can't be restored, and posting it later means scheduling a new post (with its media imported or uploaded again). Posts already on X, TikTok or YouTube cannot be recalled here.
complete_media_upload
ChatGPTFinish a media upload after every part was PUT. Waits up to a minute for it to be ready (state "promoted"). If a part's size or checksum, or the file's type, fails verification, the upload is marked failed and must be started again; if parts are missing, PUT them and call this again.
create_media_upload
ChatGPTStart uploading a video or image to Hogmatix's private storage, from a client that can PUT file bytes itself. For a file the user attached in the chat, use import_attached_file instead. Returns an uploadId, partSize and partCount. For each part (numbered from 1), call get_upload_part_url with the part's SHA-256 (base64), PUT exactly those bytes to the returned URL with the returned headers, then call complete_media_upload. Use purpose x-media for X images or video, tiktok-video for TikTok, youtube-video for YouTube. Each upload holds one of the account's upload slots until it is scheduled; an unfinished upload expires after about 2 hours without activity, and a finished one that is never scheduled is cleared about a day later.
get_import_status
ChatGPTCheck an import started by import_attached_file. Waits up to about 20 seconds while it is still "downloading" or "uploading". When state is "ready", schedule with uploadId; durationSec is the video's length in seconds for schedule_tiktok_video. A "failed" import says why in error.
get_plan
ChatGPTShow the signed-in user's Hogmatix plan and posting allowance. This tool does not offer subscriptions or change billing.
get_tiktok_creator_info
ChatGPTRead a connected TikTok account's current creator settings live from TikTok: who it posts as, the privacy levels it may post with, its maximum video length and interactions the creator disabled, plus the declaration TikTok requires the creator to see before posting. Call before schedule_tiktok_video and let the user choose from these options.
get_upload_part_url
ChatGPTRegister one part of a media upload and get a short-lived signed URL for it. This records the part's SHA-256 checksum on the upload, marks the upload as uploading and counts toward the upload's part-URL limit. PUT exactly expectedSize bytes to url with the returned headers. If a PUT fails, call again with the same checksum for a fresh URL; a different checksum for the same part is refused.
get_upload_status
ChatGPTCheck a media upload's state. It is ready to schedule once the state is "promoted".
import_attached_file
ChatGPTImport a video or image the user attached in this chat into Hogmatix's private storage so it can be scheduled. ChatGPT passes the attachment in file automatically; nothing else is fetched. Use purpose x-media for X, tiktok-video for TikTok or youtube-video for YouTube: each platform needs its own import of the attachment. Each import holds one of the account's upload slots until it is scheduled, so import only for platforms the user chose, and schedule each platform's post before importing for the next. Waits up to about 40 seconds. When state is "ready", pass uploadId to schedule_x_post, schedule_tiktok_video (with durationSec, the video's length in seconds; if it is null, ask the user) or schedule_youtube_video. If it is still "downloading" or "uploading", call get_import_status with importId. Calling again with the same attachment and purpose returns the same import until its upload has been scheduled, then imports it afresh. When the account's upload slots are full, the import fails and asks the user to schedule pending files first; it never deletes other files to make room.
list_accounts
ChatGPTList the X, TikTok and YouTube accounts connected to the user's Hogmatix. Call this first: the scheduling tools need an account's profile, openId or channelId. When the request is about one platform, pass platform to list only that platform's accounts.
list_scheduled_posts
ChatGPTList scheduled and recent posts for one platform, with their status. X needs the profile from list_accounts.
schedule_tiktok_video
ChatGPTSchedule an uploaded video (purpose tiktok-video) on a connected TikTok account. At the scheduled time Hogmatix publishes it on TikTok; Hogmatix can't remove a published video, and until then cancel_scheduled_post can cancel it. Every choice is explicit, as TikTok's Direct Post rules require: privacy (one of the account's creator-info options), the AI-generated label, commercial disclosure (yourBrand = promoting the creator's own business; brandedContent = paid promotion of a third party, only with public or friends visibility) and each interaction. Hogmatix re-checks the creator's settings and its posting-density rules. Before calling, show the user: Posting as creator_nickname (@creator_username) from get_tiktok_creator_info; the caption and time; the chosen privacy option; the comment, Duet and Stitch settings; the disclosure and AI-generated choices; and the declaration "By posting, you agree to TikTok's Music Usage Confirmation." (with brandedContent: "By posting, you agree to TikTok's Branded Content Policy and Music Usage Confirmation."). Then get the user's explicit go-ahead, even when the request states every choice.
schedule_x_post
ChatGPTSchedule a post, thread or long post on a connected X account. At the scheduled time Hogmatix publishes it on X, where it is public; Hogmatix never deletes published posts from X, and until then cancel_scheduled_post can cancel it. For a thread, separate the posts with a blank line. Optionally attach media uploaded with purpose x-media. Confirm the account, the exact text and the time with the user first.
schedule_youtube_video
ChatGPTSchedule an uploaded video (purpose youtube-video) on a connected YouTube channel. At the scheduled time Hogmatix uploads it to YouTube; Hogmatix can't remove an uploaded video, and until then cancel_scheduled_post can cancel it. Confirm the channel, the title, the privacy and the time with the user first.