attach_draft_video
ChatGPTSave one video to an existing YouTube-only draft that has no media. Use an exact video ID selected from iZop Library, or a supported attachment passed by ChatGPT. Requires explicit user intent and confirm: true. Returns the saved preview. Does not schedule or publish.
clear_brand_context
ChatGPTDelete all brand context fields immediately (product, audience, tone, reply examples). Use when the user asks to delete, remove, erase, or clear all brand context. Do not claim it was cleared unless you call this tool.
create_draft_post
ChatGPTSave a separate new Composer draft when requested, with an explicit postFormat. To edit an existing draft, use update_draft_post, or update_youtube_draft for YouTube title and description. Cached clients can use the save-draft command documented by list_workspace_actions.
cut_edit_project
ChatGPTApply up to 50 explicit edits to your personal project with expectedRevision from cut_read_project. Operations: rename(name), remove(clipId), trim(clipId,startFrame,durationFrames,sourceInFrame?), move(clipId,startFrame,trackId?), split(clipId,atFrame absolute timeline), text(clipId,text), transform(clipId,scale?,x?,y?,rotation?), audio(clipId,volume,muted?), transition(clipId,kind,durationFrames?), add_text(trackId,startFrame,durationFrames,text,fontSize?,color?), motion(clipId,preset,durationFrames?). Presets: fade_in, slide_up, punch_in. Existing media and captions remain unless explicitly edited. Does not publish or export. Ask user to Load latest in editor to preview. Re-read on conflicts.
cut_list_projects
ChatGPTFind your saved personal video edits. Returns names, IDs, revisions and durations without video bytes. Save online in the editor first.
cut_read_project
ChatGPTRead a page of clips, track IDs, media metadata and captions from your saved personal project. Frames use the returned frameRate. Read every relevant page before revising. No video analysis, transcription or rendering is performed.
cut_revert_project
ChatGPTRestore the immediately previous saved version of your personal video project when requested. Requires expectedRevision from a fresh read. Does not delete media or publish.
generate_media
ChatGPTGenerate after explicit quote approval OR quote autoApprove:true from the actor’s saved generation preferences. Pass exact quoteId, confirm:true and confirmedSparks. Idempotent; all results stay in Library. Keep completion replies clean, costs are in Sparks history. Poll queued video using get_media_job. No publishing or scheduling.
get_analytics_all_accounts
ChatGPTBrief cross-platform analytics summary (text only) for the active brand. Returns KPI numbers and buttons to open Console or Reports. Do NOT use for charts in chat; Console has full charts.
get_analytics_report_snapshot
ChatGPTBrief analytics summary for one platform (text only): followers, engagement, views, posts for the date range. Same data as Console; hand off to Console for charts and Reports for PDF. Do not expect in-chat chart cards.
get_analytics_summary
ChatGPTBrief one-platform analytics summary (text only) matching Dashboard numbers. Returns KPI text and Console/Reports handoff buttons. Required platform must match the user question.
get_billing_summary
ChatGPTLoad the signed-in user billing plan, renewal date, invoices, pending plan changes, and plan limits. Use for pricing, upgrade, downgrade, invoice, or subscription questions.
get_brand_context
ChatGPTShow the user's current brand context (product, audience, tone, examples) as a card in chat. Use when they ask what their brand context is or want to review it.
get_media_job
ChatGPTCheck an existing video without starting another generation. Saved output is reusable in drafts. Poll no more than once per 8 seconds.
get_posting_capabilities
ChatGPTList which connected platforms support text-only posts vs require media. Call before multi-platform caption variations.
get_recent_posts
ChatGPTList recent synced posts for one account. Infer platform from the user message.
get_saved_leads
ChatGPTPrefer open_workspace_page with page leads. Only use this if the user explicitly asks to show saved lead results inside chat. For find/scan/open leads, always use open_workspace_page instead.
get_scheduled_posts
ChatGPTAnswer questions about upcoming scheduled posts from the Calendar. Returns the count, scheduled times, platforms, and titles/content for the active workspace. Use this for questions like how many posts are scheduled, what is scheduled this week, or when the next post is. Keep the answer conversational; do not send the user to Calendar just to learn the numbers.
import_library_media
ChatGPTImport an accessible public HTTPS image or video into Library for reuse without AI generation. Never invent a file URL. For private chat attachments use upload_chat_media when available.
import_media_from_url
ChatGPTCopy media into iZop storage: public https URL, or pass chatMedia when the user attached a file in ChatGPT. Returns fileUrl for mediaUrls. JPEG, PNG, GIF, WebP, MP4, or WebM.
list_brand_workspaces
ChatGPTList brand workspaces (Account > Brands) and the social accounts connected to each. Use for workspace counts or to find a brand, account, or channel across workspaces.
list_connected_accounts
ChatGPTList current connected social accounts and saved profile-image URLs grouped by all authorized brands. Select a brand by ID or name, or use the returned account IDs to work across brands in this chat. Disconnected accounts are excluded.
list_draft_posts
ChatGPTFind existing Composer, Copilot, and connector drafts or revisions by title or caption. Omit brand selection to search across all authorized brands. Returns saved draft IDs, target accounts, and media counts. Use preview_draft_post on the correct match. If there are duplicates, use the requested channel and video attachment to distinguish them.
list_library_media
ChatGPTList saved image/video IDs, URLs and carousel generations. Reuse these without generating or spending Sparks.
list_media_models
ChatGPTList models, prices and saved personal preferences. Honor explicit choices first. With useDefaults enabled, omit model to let quote_media_generation match the task; otherwise ask. Generation approval is separate from model selection.
list_recent_inbox
ChatGPTShow recent comments from connected Inbox accounts with inline Reply in chat buttons. May refresh and save the account comment cache; does not send replies itself. Use for messages, comments, inbox, or replying without opening Inbox. When the user asks for Threads replies (not @mentions), pass platform THREADS and contentFilter replies_only. Use mentions_only only when they explicitly ask for @mentions or tags.
list_scheduled_posts
ChatGPTList upcoming scheduled posts from Calendar. Does not include drafts.
list_top_posts_for_repost
ChatGPTRead-only: list synced posts from connected accounts on the active brand ranked by engagement (default), views, or recent. Use for analytics questions only. Do not schedule or republish from this tool.
list_workspace_actions
ChatGPTList the actions this iZop connection supports, with example requests. Use when the user asks what they can do or is new to iZop. This does not access social data or change anything.
open_device_upload
ChatGPTGet the direct iZop upload link when the user asks to post a file the web chat cannot transfer. Wait for the user to upload it, then use the new Library file for their requested destination.
open_social_connection
ChatGPTGive the user a secure link to connect a social account inside their signed-in iZop workspace. Never request social passwords, OAuth codes, access tokens, or complete social authorization inside this chat. Owner/Admin only. Does not start OAuth or connect an account itself.
open_workspace_page
ChatGPTOpen a workspace page card in chat with a button. Use for Leads, Reports, Brand voice, Composer, Calendar, History, Inbox, Console, Team, or Support when the user asks for a feature that is not handled with in-chat tools.
preview_draft_post
ChatGPTShow an inline social post preview. Use chat-preview for content written or revised in chat without saving a draft, or pass a saved draft ID to preview it with optional copy overrides. The card can preview media selected from the device.
propose_brand_context_update
ChatGPTPropose changes to the user's brand context and show an editable Approve card in chat. ONLY pass fields the user explicitly asked to change: product/features ג†’ productDescription only; audience ג†’ targetAudience only; tone ג†’ toneOfVoice only. Never pass targetAudience or toneOfVoice when the user only mentions product or features. CRITICAL: copy the existing field text verbatim and make the smallest edit (remove one bullet, add one sentence). Do NOT rewrite, summarize, or rephrase unchanged sections. Nothing is saved until Approve.
publish_attached_media
ChatGPTPrimary tool when the user attached an image or video in ChatGPT and asked to post, upload, or publish (X/Twitter, Instagram, Facebook, etc). ChatGPT injects chatMedia/attachment/file automatically via fileParams. Requires confirm:true and platforms.
publish_draft
ChatGPTPublish an existing draft after final approval. For YouTube first show the saved preview, confirm thumbnail choice, visibility and AI disclosure, then ask the user to approve this exact version before passing youtubeSettings. Report the returned outcome and YouTube video link when present.
publish_post_now
ChatGPTCreate and publish immediately. Requires confirm: true. For chat attachments use publish_attached_media instead. Otherwise pass chatMedia or mediaUrls.
quote_media_generation
ChatGPTValidate requested media and return exact total Sparks, quoteId and autoApprove. No generation or charge. If autoApprove:true the actor enabled generation within their saved cost cap: call generate_media with this exact quote without asking again. Otherwise show cost and request approval. Never auto-publish or auto-schedule.
refine_media_prompt
ChatGPTAdd editable creative direction to a prompt without changing its brief. Uses 0 Sparks; does not generate media.
replace_carousel_slide
ChatGPTReplace one carousel slide with a Library image, keeping the original version. No AI generation, 0 Sparks. Slide index starts at 0.
reschedule_scheduled_posts
ChatGPTReschedule upcoming scheduled Calendar posts. mode=spread: redistribute across a day window (weekdays). mode=asap: move each calendar chip to the soonest 10-minute schedule slots starting from the next available time (use for nearest time, ASAP, get emails soon). Treats each platform card on the Calendar as its own slot. First call with confirm=false to preview. Apply only after the user clearly confirms (confirm=true). Never change POSTED, POSTING, or past posts. Do not also call open_workspace_page for calendar; the reply already includes Open Calendar: /calendar.
save_device_media
ChatGPTSave a device file to the workspace Library or apply a selected cover to a saved video draft from the iZop card.
scan_leads
ChatGPTScan connected social accounts for potential leads and replace the saved lead scan, including when no leads are found. Requires Starter or above. In Copilot, prefer opening the Leads page when the user only asks to view leads.
schedule_post
ChatGPTSchedule a post for auto-publish at a future time (Calendar auto delivery). Requires publish permission.
send_report_email
ChatGPTPrefer open_workspace_page with page reports. PDF reports live on the Reports page; do not email reports from Copilot unless the user explicitly insists after being offered the Reports page.
set_media_preferences
ChatGPTSave personal model/approval preferences ONLY when the user explicitly requests this settings change. Explain auto-generation spends workspace Sparks within maxAutoSparks per request; never enable it by inference from a generation request. Confirm their choice before saving. No generation or publishing.
set_scheduled_posts_delivery
ChatGPTChange how upcoming scheduled Calendar posts publish: auto (cron publishes at scheduled time) or email_links (Email me a link: at due time sends an email with a link per platform to open Instagram, X, LinkedIn, TikTok, etc., plus an all-platforms page with Publish now). Use when the user asks for email confirmation, manual publish on platforms, edit before posting, or to stop auto uploading. First call confirm=false to preview; apply with confirm=true after they agree. Does not change scheduled dates unless combined with reschedule_scheduled_posts.
start_guided_brand_setup
ChatGPTPreview guided brand context setup. Reads a website URL and/or connected social accounts when provided, then returns suggested fields for user review; this tool does not save the brand context. Auto-fills all connected accounts when autoFillFromAccounts is true and no accountIds given.
update_draft_post
ChatGPTSave requested edits to an existing unscheduled draft on any authorized platform. Omitted fields keep saved values. content replaces all platform captions; mediaUrls replaces all attachments. Targets never change. Never publishes or schedules. Returns the saved inline preview.
update_youtube_draft
ChatGPTSave the approved title and description to an existing YouTube-only draft. Keeps its video, thumbnail, settings and targets. Requires confirmation after the user asks to save these edits. Use preview_draft_post first to review the revised copy. This tool never publishes or creates a post.
upload_chat_media
ChatGPTCopy a ChatGPT chat attachment into iZop storage (Copilot paperclip parity). Returns fileUrl. Prefer publish_attached_media for one-step publish. Up to 100 MB video.