collections_items_update_items
Update multiple items in a Webflow collection by specifying item IDs, field data, and statuses like draft or archived. Use to maintain and modify structured content efficiently.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| collection_id | Yes | ||
| request | Yes |
Implementation Reference
- src/tools/cms.ts:322-342 (registration)Registration of the MCP tool 'collections_items_update_items' including the inline handler function that updates CMS collection items via Webflow API."collections_items_update_items", "Update existing items in a CMS collection as drafts.", { collection_id: z .string() .describe("Unique identifier for the Collection."), request: WebflowCollectionsItemsUpdateItemsRequestSchema, }, async ({ collection_id, request }) => { try { const response = await getClient().collections.items.updateItems( collection_id, request, requestOptions ); return formatResponse(response); } catch (error) { return formatErrorResponse(error); } } );
- src/tools/cms.ts:331-341 (handler)The async handler function executing the tool logic: calls Webflow client to update items and formats response/error.try { const response = await getClient().collections.items.updateItems( collection_id, request, requestOptions ); return formatResponse(response); } catch (error) { return formatErrorResponse(error); } }
- Zod schema for the tool's 'request' parameter: array of collection items to update.import { z } from "zod"; import { CollectionItemWithIdInputSchema } from "./CollectionItemWithIdInputSchema"; export const WebflowCollectionsItemsUpdateItemsRequestSchema = z.object({ items: z.array(CollectionItemWithIdInputSchema).optional(), });
- Supporting Zod schema defining the structure of each item in the update request (used by the main schema).import { z } from "zod"; export const CollectionItemWithIdInputSchema = z .object({ id: z.string().describe("Unique identifier for the item."), cmsLocaleId: z .string() .optional() .describe("Unique identifier for the locale of the CMS Item."), lastPublished: z .string() .optional() .describe("Date when the item was last published."), lastUpdated: z .string() .optional() .describe("Date when the item was last updated."), createdOn: z .string() .optional() .describe("Date when the item was created."), isArchived: z .boolean() .optional() .describe("Indicates if the item is archived."), isDraft: z .boolean() .optional() .describe("Indicates if the item is a draft."), fieldData: z.record(z.any()).and( z.object({ name: z.string().optional().describe("Name of the field."), slug: z .string() .optional() .describe( "URL structure of the Item in your site. Note: Updates to an item slug will break all links referencing the old slug." ), }) ), }) .describe("Collection item update request schema.");
- src/mcp.ts:49-49 (registration)Top-level call to registerCmsTools during MCP server setup, which includes registration of this tool.registerCmsTools(server, getClient);