cancel_post
ChatGPTCancel a scheduled or paused post before it publishes. Only after the user confirms.
connect_account
ChatGPTStart connecting a social account. Returns a url the user must open in their browser to log in to the platform. When they are done, call sync_accounts.
create_workspace
ChatGPTCreate a workspace (Scale plan). It does not become active automatically.
disconnect_account
ChatGPTDisconnect a social account from PostWing. Only when the user asks. Scheduled posts stop publishing to it.
get_me
ChatGPTThe user’s timezone and active workspace. Call before turning relative times into scheduled_at.
get_post
ChatGPTOne post with its caption, media, and each account’s status, options, published url, and error.
get_posts_summary
ChatGPTCounts by platform, account, status, and day across the whole schedule in one call. Use for how much / how often / which accounts questions; then list_posts for individual posts.
import_media
ChatGPTCopy images or a video from public HTTPS URLs (including PostWing upload-page links) into PostWing. Returns media items for schedule_post. Prefer request_media_upload when the user has files on their device.
list_accounts
ChatGPTConnected social accounts. Use each id in schedule_post accounts. Filter with platform to find, say, the Instagram accounts. status reauth_required means the user must reconnect it in PostWing.
list_pinterest_boards
ChatGPTBoards for a Pinterest account. Pinterest posts need one as options.board_id.
list_posts
ChatGPTPosts soonest first; only upcoming ones unless include_past or from is set. Paginated: keep calling with offset = next_offset while has_more is true before describing the whole schedule. For counts, use get_posts_summary.
list_workspaces
ChatGPTWorkspaces the user owns or was invited to. is_active marks the default.
prepare_media_upload
ChatGPTCreate a short-lived signed upload URL for the in-chat media uploader widget. Widget only; models should call request_media_upload.
request_media_upload
ChatGPTOpen an in-chat upload widget so the user can upload images or a video for the post. Prefer this whenever the user wants media and does not already have a public HTTPS URL. When they finish, the widget returns media items to pass into schedule_post as media. If the host cannot render the widget, share fallback_upload_page.
schedule_post
ChatGPTSchedule a post. Only call after showing the user the caption, each account, any media, and the time in their timezone, and getting a clear yes. Returns the Post.
set_active_workspace
ChatGPTSet the default workspace for tools called without workspace_id, and where newly connected accounts go.
sync_accounts
ChatGPTImport accounts the user just authorized with connect_account into the active workspace.
update_post
ChatGPTChange one scheduled post. Send only what changes; the rest stays. accounts replaces the whole list, so include caption and options for every account you keep. media: [] removes media. Show the user the change and get a yes first.
upload_media_bytes
ChatGPTUpload a small image or video from base64 for the in-chat media uploader widget. Widget only; models should call request_media_upload.