Write with an XcutAI agent
xcut_write_contentUse this when the user wants XcutAI's agents to write for their brand: Reels, TikTok and Shorts scripts, YouTube scripts, Facebook posts, Meta ad copy, hooks, captions or plans, using their brand memory, imported posts and XcutAI's library of formats that performed. The conversation is saved to their canvas. Pick agent for the platform, or auto. Token-billed (typically 10-40 credits). Longer turns return a job_id. Do not use for writing unrelated to the user's social media or marketing content.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent | No | Which XcutAI writer to use: auto (picks from the request), instagram, tiktok, youtube_script, youtube_shorts, facebook, meta_ad or general. Default auto. | auto |
| request | Yes | What to write, as the user would ask in the canvas chat. | |
| item_ids | No | Only use these canvas items (default: the whole canvas). | |
| canvas_id | No | Optional. Leave it out unless the user names a canvas: XcutAI then uses their "From AI apps" canvas, where imports also land. Ids come from xcut_list_canvases. |