What you can ask for
Build
“Make a countdown to our launch on March 3, in our brand green.” The assistant starts the build and shows you the preview as it comes together.
Change
“Make the numbers bigger and add a title.” Changes that need new code are rebuilt, and the new version replaces the one your embeds show (ask for a draft to try it first); texts, images, colors, fonts and sizes of a published widget change at once.
Publish and embed
“Give me the React component for it.” A finished widget is already published, so its embed code is ready: plain HTML, an iframe, or React, Vue, Svelte and Angular code. To look at a widget before it goes live, ask the assistant to keep it as a draft; publishing it later is a separate step.
Find, reuse and manage
“Show my drafts.” “Save these logos to my media library and use the first one.” “Go back to the previous version.” “Copy this widget for the pricing page.” The assistant can also rename or delete a widget (deleting asks you to confirm its title) and tell you how many credits you have left.
Plan a page or a workflow
“I want a landing page for my basketball team. Which widgets would work?” The assistant suggests the widgets that fit (a scoreboard, a schedule, a gallery, cards for the players), asks a few questions if it needs them, and starts the ones you choose together, each in its own canvas.
How it works
1
Describe the widget
The assistant calls
create_widget with your description. The build starts and returns at once, usually finishing within a few minutes.2
Watch and review
show_widget displays the build progress and then the live preview (as a card in assistants that can show one, as text otherwise). Ask for changes with revise_widget.3
Publish, or keep a draft
A finished build is published for you, unless your plan does not include publishing, you approved the connection without the permission to publish, or you asked to keep it as a draft.
publish_widget makes a kept draft live, or brings an earlier version back. It is only called after you agree, because it replaces what existing embeds show.4
Customize and embed
update_widget_customization changes the texts, images, colors, fonts and sizes of a published widget without rebuilding it. get_embed_code returns the code and a share link.What it costs
- Creating and revising a widget uses 1 credit per call, charged when the build starts. Starting several at once uses 1 credit per widget, charged as each build starts, and the assistant tells you the total before it starts them.
- Everything else (suggesting which widgets to build, previews, listing, versions, copies, renaming, deleting, customization, embed code, workflows, A/B tests, translations, the media library, checking your usage) uses no credits. Saved files count against your storage allowance.
- Publishing needs a plan that includes it and a connection approved with the publish permission. If either is missing, builds stay drafts and the assistant tells you.
What you need
- A Widgetic account whose plan includes API access. Without it the connection is refused with a message saying so.
- New widgets are made in the workspace you are signed in to on widgetic.com, your own or a team’s. In a team your role has to allow making widgets there, the credit is still your own, and the team’s Brand Kit applies. See Where a new widget goes.
- To chain widgets into workflows, a plan that includes workflows, and the workspace you are signed in to on widgetic.com (your own or a team’s) is the one they are made in.
- For A/B tests and translations, a plan that includes those features (Teams, or a partner agreement), in the same workspace.
- An assistant that supports remote MCP servers. See Connect your assistant for ChatGPT, Codex, Cursor, Claude Code and VS Code.
Good to know
Widgets that keep what visitors send
Widgets that keep what visitors send
When your request needs it (a vote, a rating, a comment, an RSVP or a sign-up), the assistant can build a widget that keeps what its visitors send. Widgetic stores those entries in the widget’s own database in your account, and the widget can show the results (a poll’s tally, an average rating). You can ask the assistant for them whenever you like: counts per option by default, and the entries themselves only when you ask. A visitor can send more than once, and entries are not emailed or forwarded anywhere. The entries are yours: you can export or delete them through the REST API or the CLI (the assistant itself only reads them), and they are deleted with the widget. Orders, payments and logins are not built. A widget made from a pasted widget link keeps nothing, and neither does one you did not ask to keep entries (a quiz, a countdown, a gallery, a chart or a calculator only displays information).
Retrying a build
Retrying a build
Each
create_widget call starts a separate widget and charges credits. A repeat of the same title within two minutes returns the widget already started and charges nothing, so a retry after a lost answer does not build twice; the same goes for each widget of a batch started with create_widget_batch. If a call times out, ask the assistant to check your widget list before it tries again.Deleting a widget
Deleting a widget
delete_widget removes a widget for good, with all its versions and published copies; embeds already placed on websites stop working, and it cannot be undone. The assistant has to pass the exact title you confirmed, and a widget that is still being built cannot be deleted. Going back to an earlier version never deletes anything: list_widget_versions and publish_widget do that.Deleting a file
Deleting a file
delete_media_file removes one file from your media library for good and gives its space back to your storage allowance. A widget that loads the file stops showing it, so the assistant is told which widgets use it and the file is refused until you say you still want it gone. Widgetic cannot see inside widgets built before it kept a record of which file went into which widget, so it never says that a file is unused. The assistant has to pass the exact file name you confirmed. Renaming or moving a file with manage_media_library is safe for your widgets: the file’s address does not change.Files you attach or link
Files you attach or link
Images (PNG, JPEG, WebP, GIF, HEIC, SVG), videos (MP4, WebM, MOV), audio (MP3, WAV, OGG, M4A), PDFs and data files (CSV, JSON, Excel
.xlsx) can be saved to your media library from attached files or HTTPS links, up to 250 MB each (an SVG up to 2 MB, JSON and Excel files up to 10 MB). An SVG is cleaned of scripts and other active content before it is saved. A JSON or Excel file is read before it is saved and kept only if it holds a table; an Excel file is read from its first sheet, as the values it stores. FLAC and AAC audio and the old .xls Excel format cannot be saved.Designs and documents to build from
Designs and documents to build from
Besides a description, a build can start from up to 5 attached files (images, videos, PDFs, data files such as CSV, JSON or Excel, and Markdown or text files) and up to 3 Figma links. Figma links are read with your own connected Figma account, which you connect once from the Design page. See what a build can start from.
Your prompts are screened
Your prompts are screened
Requests to create or revise a widget are checked with a content moderation service before they are acted on, and so are the words you use to ask which widgets to build. Those words are also sent to a language model, which writes the suggestions. See the privacy policy for what is sent and why.
Connect your assistant
One snippet per client.
Tools reference
Every tool, what it costs and what it needs.
Authentication
Sign-in, API keys and revoking access.