This is an overview of the changes to the Webflow APIs and related tools. To filter the list, select one or more tags.
New: robots.txt Content API (beta)
The new robots.txt content endpoints read and write the exact text value of the robots.txt field under Site settings > SEO > Indexing. The text is sent and returned in a content field, and Webflow keeps comments, blank lines, and directives such as Crawl-delay.
- Get robots.txt Content returns the field’s text.
- Replace robots.txt Content replaces the field’s text. The text must be 512,000 bytes (500 KiB) or smaller.
- Delete robots.txt Content clears the field.
New: Sitemap Indexing API (beta)
The new Sitemap Indexing endpoints read and update whether CMS items and static pages are listed in a site’s sitemap.xml file. Each endpoint works with the includeInSitemap setting only, so you can change sitemap settings without sending item field data or page settings.
CMS items
- List Item Sitemap Settings lists the staged setting of each item in a collection.
- List Live Item Sitemap Settings lists the live setting of each item in a collection.
- Get Item Sitemap Setting returns the staged setting of one item.
- Get Live Item Sitemap Setting returns the live setting of one item.
- Update Item Sitemap Setting updates one item.
- Update Item Sitemap Settings updates up to 100 items in one request.
v2.15.0: Default SSR setting for code libraries, and valid names for installed skills
v2.15.0 lets code libraries turn server-side rendering off by default, fixes the names of installed skills, and updates a dependency.
Set a default for SSR in code libraries
Add "ssrDefault": false under library in your manifest file to set the default ssr value for all components in the library. A component’s own ssr option still overrides it.
New: Bulk Remove Workspace Members
The new Bulk Remove Workspace Members endpoint removes Members and cancels pending invites from an Enterprise workspace in one request. It is the only API endpoint that cancels an invite.
- Scope:
workspace_members:write - Limit: up to 100 Member and invite IDs combined, per request
- Partial success: the endpoint answers
200even when some items fail. Readsummaryandresultsto see which IDs were removed and which failed. A4xxresponse means Webflow refused the whole request and removed nothing.
v2.14.0: Session-based auth without .env tokens, and single-React library builds
v2.14.0 stops writing access tokens to .env, makes code library builds fail when more than one React copy would ship, and tightens deploy interrupt recovery, --json output, and resource id validation.
Session-based auth — no token in .env
webflow auth login and webflow apps init no longer write your access token to .env. The CLI uses your login session instead (apps init still writes WEBFLOW_SITE_ID).
New: Optimize API
The Optimize API lets you read your optimizations and their results. It works with Webflow sites that have the Optimize add-on, and with non-Webflow sites that use Optimize. See Working with Optimize to get started.
Optimize
- List Optimize IDs: the
optimizeIdvalues your token can access, and the resource each one comes from - List Optimizations: each optimization’s type, status, intervals, and current goals
- Get Optimization Results: each variation’s sessions, users, conversions, and conversion rate for one goal
- Get Audience Insights: the same results, split by the segments of one dimension
- Get Performance Over Time: the same results, by day or week
- List Optimization Goals: an interval’s goals and which are target goals, plus the optimization’s current goals
- List Dimensions: the dimensions you can group or filter reports by
- List Dimension Values: the values seen for a dimension, to use in filters
Marketplace app submissions: guideline checks and a required Preflight receipt now gate the form
The automated submission checks announced in August are live
MCP v2.2: AEO, Optimize, and Team Administration
MCP v2.2 gives agents the data to run an optimization loop. They can read Optimize results to see which variation is winning, track your AEO performance across answer engines and AI crawlers, and use new page-level Analyze reports (scroll depth, window height, page flow, and goals) to understand why. Together, that gives agents what they need to validate the tests you run and improve your AEO scores.
New: Analyze scroll depth, browser window height, page flow, and goals
The Analyze API now includes three new reports and two goals endpoints. They require the sites:read scope and a workspace with the Analyze add-on, like the existing Analyze reports.
Analyze
- Scroll depth: the scroll depth (in pixels) that 75%, 50%, and 25% of page views reached.
- Browser window height: average browser window height in CSS pixels over a time window.
- Page flow: pages visitors viewed immediately before or after a selected page, ranked by sessions, users, or page views.
- List goals: the goals configured for your site, including each goal’s type, whether it’s a site goal, and its integration source (HubSpot, Marketo, or Shopify).
- Goal performance: daily unique conversions for one goal, bucketed in the time zone you choose.
New: AEO Analytics API
The AEO Analytics API lets you read how AI bots visit your site, and how answer engines mention and cite you. AEO, or answer engine optimization, is the practice of improving how your content appears in AI-generated answers. It works with sites that have the AEO analytics entitlement.
Bot traffic
- Get Bot Traffic — total requests from the AI bots Webflow tracks, by provider or category
- Get Bot Traffic by Page — the pages and files bots requested most
Box element in the Designer API
The Designer API now includes a Box element preset. Box is a block element with a semantic HTML tag: div, section, header, footer, nav, main, article, aside, address, or figure.
Creating Box elements
Use webflow.elementPresets.Box to create a Box element:
Detect empty slots with isEmptySlot
This update lets code component authors detect empty slots and render fallback content. Webflow now reserves prop names that start with __wf_.
Packages:
@webflow/react2.7.0@webflow/data-types2.6.0
Check for empty slots
Update: AEO prompt executions no longer return competitorMentions
The List Prompt Executions and Get Prompt Execution endpoints no longer return competitorMentions. The field was always an empty array. Remove it from any code or types that expect it. All other fields stay the same.
To see competitor citations, use List Competitor Citations.
Update: Get Site Plan returns the Starter hosting plan and public plan names
The Get Site Plan endpoint now returns the site’s hosting plan consistently. This is a breaking change for any code that compares id or displayName against the previous values.
Starter sites
Sites without a paid hosting plan used to return the Starter workspace plan. They now return the Starter hosting plan.
New: List Workspaces endpoint
The new List Workspaces endpoint, GET /v2/workspaces, returns the id, name, and slug of each workspace your token can access. Use it to find the workspace ID that endpoints such as Workspace Members and Create Site require.
The endpoint requires the workspace:read scope and supports workspace API tokens and Data Client apps. The workspace:read scope is now available only to workspace API tokens and Data Client apps. New site API tokens can’t have it.
Update: Token introspection omits `application` for API tokens
The Get Authorization Info endpoint only returns the application object for tokens issued to an OAuth app. Tokens without an OAuth app, such as Site and Workspace API tokens (grantType: client_credentials), return authorization only, and the response omits application.
If your code reads application from the response, check that it’s present before using it.
New: AEO Analytics API (beta)
The AEO Analytics API (beta) lets you read how AI bots visit your site, and how answer engines mention and cite you. AEO, or answer engine optimization, is the practice of improving how your content appears in AI-generated answers. It works with sites that have the AEO analytics entitlement.
Bot traffic
- Get Bot Traffic — total requests from the AI bots Webflow tracks, by provider or category
- Get Bot Traffic by Page — the pages and files bots requested most
New: Analyze scroll depth, browser window height, page flow, and goals (beta)
The Analyze API (beta) now includes three new reports and two goals endpoints.
Analyze
- Scroll depth: the scroll depth (in pixels) that 75%, 50%, and 25% of page views reached.
- Browser window height: average browser window height in CSS pixels over a time window.
- Page flow: pages visitors viewed immediately before or after a selected page, ranked by sessions, users, or page views.
- List goals: the goals configured for your site, including each goal’s type, whether it’s a site goal, and its integration source (HubSpot, Marketo, or Shopify).
- Goal performance: daily unique conversions for one goal, bucketed in the time zone you choose.
New: Optimize API (beta)
The Optimize API (beta) lets you read your optimizations and their results. It works with Webflow sites that have the Optimize add-on, and with non-Webflow sites that use Optimize.
Optimize
- List Optimize IDs — the
optimizeIdvalues your token can access, and the resource each one comes from - List Optimizations — each optimization’s type, status, and intervals
- Get Optimization Results — each variation’s sessions, users, conversions, and conversion rate for one goal
- Get Audience Insights — the same results, split by the segments of one dimension
- Get Performance Over Time — the same results, by day or week
- List Optimization Goals — an interval’s goals, and which one is the target goal
- List Dimensions — the dimensions you can group or filter reports by
- List Dimension Values — the values seen for a dimension, to use in filters
New: Site Access and Workspace Members APIs
Two new endpoint groups let you manage who has access to a Site or Workspace directly through the API, for Enterprise workspaces.
Site Access
- List Site Members — everyone with access to a Site and the role they hold
- Grant Site Access — add a Workspace Member to a Site, by email or member ID
- Update Site Member Role — change a Member’s Site Role, by member ID or email
- Revoke Site Access — remove a Member’s access to a Site, by member ID or email