Five new v4 endpoints let you create, read, update, and delete a site’s colors from the REST API.
Returns a site’s swatches, with cursor-based pagination through limit (1–100, default 20) and startingAfter.
Adds a swatch to a site. siteId, hue, saturation, and lightness are required; name is optional.
Returns a single swatch.
Changes a swatch’s name, hue, saturation, or lightness. Omitted fields keep their current values. Swatches are grouped by name prefix, so renaming White to Neutrals / White moves the swatch into the Neutrals group.
Removes a swatch.
Each swatch stores its color as HSL values: hue (0–360), saturation (0–100), and lightness (0–100).
The GET apis both provide id and referenceId for each swatch returned. All 5 endpoints above use id. referenceId is the value that appears as swatchId in a page’s element tree (GET /v6/pages/:id?expand=elements). Use it as a reference to find swatches in page content.
The swatch endpoints are part of the Resource APIs project, currently in Beta, and may change. Requests return 403 until the feature is enabled for your site or workspace. To opt-in, please contact support: support@makeswift.com.
For details, see List Swatches, Create Swatch, Get Swatch, Update Swatch, and Delete Swatch.
Thanks to user feedback, the page for connecting AI tools to the Makeswift docs is now Docs MCP Server, says up front what the server does, and clarifies the Claude Code setup instructions.
--scope user) commands shown side by side so you pick before you run.The Get Page endpoint now accepts expand=elements, returning the page’s full element tree alongside the page record.
expand and the response is unchanged. elements is included only when you request it, and expand accepts only elements (any other value returns a 400).locale and versionRef parameters as the endpoint. ?locale= returns the localized tree; ?versionRef=ref:live returns the published tree (default is ref:draft).type, a key (a UUID unique within the tree), and props. Nested elements live inside props, at any depth.For details, see the expand parameter on Get Page.
The Navigation Sidebar has been reorganized around a split pane that shows your pages and the Elements Panel at the same time, and you can now sort elements directly in the Elements Panel.
For details, see The basics.
Select an element in the Canvas or Elements Panel in the left sidebar and press an arrow key to move it within its parent, without dragging it.
Some resource changes affect more than one page. Resource References show all of the places a resource is used, so you can add, edit, and delete resources with confidence.
References are tracked through pages and regions, not through global components or text styles. A color that is used inside a global component that is used on 3 pages will report as being used on 3 pages. If that global component is not used on any pages or regions, the color will show no resource references.
For details, see Resource References.
The Copy diagnostics item in the Visual Builder Help menu has been replaced with Diagnostics, which opens a dialog where you can review diagnostic information before sharing it.
For details, see Diagnostics.
The documentation site now shows availability badges in the sidebar navigation, making it easier to spot the status of a page before you open it. This is a documentation-site improvement, not a change to Makeswift itself.
Apps are out of Early Access and available to everyone. You no longer need to enable an early access setting before creating an app to authenticate with the Makeswift REST API.
For details, see Authentication.
The IconRadioGroup control adds an icon-based radio group panel to the Makeswift builder, letting developers offer visual icon options for component properties like alignment, layout direction, or style variants.
"text-align-left", "arrow-right") or use the IconRadioGroup.Icon accessorvalue as a typed string to your componentFor full documentation, see the IconRadioGroup control reference.