Wixel

Get the Wixel asset by ID.

getWixelAsset

Resolve the assets a Wixel reply delivered into previewable results. Call this once a reply event delivers assets, passing the assetIds and mediaUrls EXACTLY as returned by list_wixel_events (never invent ids — a turnId is NOT an asset id). In widget-capable clients this renders the result card (preview image/video with edit and download actions); otherwise present the returned asset links as text, always including the Edit in Wixel link.

get_wixel_asset_result

Check the status of an async Wixel job (logo generation, image creation, event invitation, etc.). Poll this until status is COMPLETED.

getWixelJobStatus

Get all assets for a Wixel project.

getWixelProjectAssets

Widget-internal: resolves curated (KB) style presets by ID so style options can render palette swatches. Not needed for normal conversation flows.

get_wixel_style_presets

Fetch the structured question the Wixel agent asked in its latest turn (outline review, style selection, confirmation, choices). Call this after a reply event whenever the reply asks the user something. In widget-capable clients this renders an interactive question widget the user can answer directly; otherwise present the returned questions as text and send the user's answer via send_wixel_message.

get_wixel_pending_question

Read durable turn events from a Wixel Agent session inbox. Pass the cursor returned by the previous call as "since" to only receive newer events. Event types: "reply" (the agent's answer), "failed" (the turn failed), and "user" (only with historyMode FULL). Poll until the awaited turnId gets a reply/failed event.

list_wixel_events

Mark a Wixel job as fulfilled.

markWixelJobAsFulfilled

Send a generation or refinement prompt to a Wixel session (started with start_wixel_session) — e.g. "create an image of a pirate dog", "a 10-slide pitch deck for my bakery", "make the logo blue". The turn runs asynchronously — a successful response only means the turn was ACCEPTED and returns a turnId. Obtain the agent's answer (including links to the generated assets) by polling list_wixel_events until a "reply" or "failed" event for that turnId appears. Send the user's request as THEY phrased it. Do NOT add creative direction they did not give — style, palette, mood, tone, audience, aspect ratio, slide count or slide topics. Wixel asks the user about those itself, and widget-capable clients render the question as an interactive widget (get_wixel_pending_question), so details you invent silently overwrite the choices the user was about to make. Rephrasing for clarity or translating is fine; filling in the blanks is not.

send_wixel_message

Start (or resume) a session with Wixel — Wix's AI creative studio that GENERATES visual assets from text prompts: images, logos, slide decks / presentations, videos, documents, and event invitations. Use this flow for any "create/generate an image / logo / slides / video" request. It is NOT a website builder. Call this ONCE per conversation and persist the returned handle + metaSiteId (Wixel's project identifiers) — they are required by send_wixel_message and list_wixel_events. Without arguments Wixel provisions a new project and session. Pass metaSiteId to reuse an existing project; pass sessionId + metaSiteId to resume a session created by this API.

start_wixel_session