attach_media
ChatGPTAttach media (Velocity media URLs from upload_media, or any public URL) to an existing scheduled or failed post, keeping its current media. Keep internal IDs and storage paths out of ordinary replies; identify accounts by @handle and posts by caption, platform and local time. Use returned IDs only for follow-up tool calls.
cancel_post
ChatGPTCancel (delete) a scheduled post that has not been published yet. Keep internal IDs and storage paths out of ordinary replies; identify accounts by @handle and posts by caption, platform and local time. Use returned IDs only for follow-up tool calls.
create_post
ChatGPTCreate and schedule a post on one connected account, or publish it now. Pass social_connection_id from list_connected_accounts. Give scheduled_at as ISO 8601 (with offset) or as a local time plus timezone. Media must be public URLs (use upload_media first). Keep internal IDs and storage paths out of ordinary replies; identify accounts by @handle and posts by caption, platform and local time. Use returned IDs only for follow-up tool calls.
fetch
ChatGPTFetch one post by id (same as get_post; provided for ChatGPT connector compatibility). Keep internal IDs and storage paths out of ordinary replies; identify accounts by @handle and posts by caption, platform and local time. Use returned IDs only for follow-up tool calls.
get_analytics
ChatGPTRead the available analytics (Pro Max and Pro Max + Agency plans): per-account engagement snapshots (followers, reach, engagement) and brand health metrics with best time to post. Keep internal IDs and storage paths out of ordinary replies; identify accounts by @handle and posts by caption, platform and local time. Use returned IDs only for follow-up tool calls.
get_calendar
ChatGPTRead the content calendar: every post scheduled, published or failed between two dates, grouped by day. Defaults to the next 7 days. Keep internal IDs and storage paths out of ordinary replies; identify accounts by @handle and posts by caption, platform and local time. Use returned IDs only for follow-up tool calls.
get_post
ChatGPTGet one post with its full status, scheduled time, platform post id and publishing error, if any. Keep internal IDs and storage paths out of ordinary replies; identify accounts by @handle and posts by caption, platform and local time. Use returned IDs only for follow-up tool calls.
get_tiktok_publish_options
ChatGPTRead the current privacy choices, interaction restrictions and duration limit for one connected TikTok account before asking the user to choose publishing settings. Does not publish a post. Keep internal IDs and storage paths out of ordinary replies; identify accounts by @handle and posts by caption, platform and local time. Use returned IDs only for follow-up tool calls.
list_brands
ChatGPTList the brands in this Velocity workspace. Posts, accounts and analytics are grouped by brand. Keep internal IDs and storage paths out of ordinary replies; identify accounts by @handle and posts by caption, platform and local time. Use returned IDs only for follow-up tool calls.
list_connected_accounts
ChatGPTList the connected social accounts (Instagram, Facebook, LinkedIn, X, TikTok, YouTube, Bluesky) with their handle, status and account id. Use the account id as social_connection_id when creating posts. Keep internal IDs and storage paths out of ordinary replies; identify accounts by @handle and posts by caption, platform and local time. Use returned IDs only for follow-up tool calls.
list_posts
ChatGPTList posts from the queue: scheduled (pending), processing, published (posted), failed or cancelled. Filter by status, platform, brand and time window. Each post carries its status, error message and platform post id. Keep internal IDs and storage paths out of ordinary replies; identify accounts by @handle and posts by caption, platform and local time. Use returned IDs only for follow-up tool calls.
prepare_media_upload
ChatGPTFor an original file accessible in your code-execution environment: calculate its byte size and SHA-256 programmatically, then request a short-lived upload URL. Use code execution to HTTP PUT the original binary bytes to that exact URL with the returned Content-Type header. The successful PUT response contains media_url for create_post or attach_media. Do not transcribe base64 or upload to a third party. Keep the upload URL out of user-facing replies. If file or source_url is already available, use upload_media instead. Keep internal IDs and storage paths out of ordinary replies; identify accounts by @handle and posts by caption, platform and local time. Use returned IDs only for follow-up tool calls.
reschedule_post
ChatGPTMove a scheduled (pending) post to a new time. Keep internal IDs and storage paths out of ordinary replies; identify accounts by @handle and posts by caption, platform and local time. Use returned IDs only for follow-up tool calls.
retry_failed_post
ChatGPTRetry a failed post: publish it now, or reschedule it to an exact time. Optionally retarget it to another account of the same platform. Keep internal IDs and storage paths out of ordinary replies; identify accounts by @handle and posts by caption, platform and local time. Use returned IDs only for follow-up tool calls.
search
ChatGPTSearch this account's posts by caption text. Returns matching posts with ids for use with fetch or get_post. Keep internal IDs and storage paths out of ordinary replies; identify accounts by @handle and posts by caption, platform and local time. Use returned IDs only for follow-up tool calls.
update_post
ChatGPTEdit a scheduled (pending) or failed post: change the caption, the media, or the YouTube title/tags. Use reschedule_post to change the time. Keep internal IDs and storage paths out of ordinary replies; identify accounts by @handle and posts by caption, platform and local time. Use returned IDs only for follow-up tool calls.
upload_media
ChatGPTUpload a user-attached image or video using file, or copy a public source_url or base64 data, into Velocity's media library. For a chat attachment, pass the actual host file reference; never invent bytes or substitute another image. Returns a Velocity media URL for creating or editing a post. Keep internal IDs and storage paths out of ordinary replies; identify accounts by @handle and posts by caption, platform and local time. Use returned IDs only for follow-up tool calls.
