{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"\n Rich Text field values may contain Webflow component instances as `` markup. On read they appear inline in the field's HTML; on write, the same markup creates or updates the instance.\n\n Scalar props are `prop-=\"…\"` attributes on the ``. Text and rich-text props are nested `\" type=\"text|richtext\">…` children.\n\n A write is rejected with a `400` if a component can't be resolved, contains a Collection List, populates a Slot (a component with an unpopulated Slot is allowed), includes an unknown prop, or creates a new instance in a secondary locale.\n\n `component-id` and each `prop-` are specific to your site's component definition — obtain them by listing your site's components (`GET /v2/sites/{site_id}/components`, plus `/components/{component_id}/properties` for prop IDs) or by reading an item that already contains the component and reusing the returned markup. Omit `data-w-id` when creating an instance (the server assigns it); keep it when updating one.\n\n\nUpdate a single item or multiple items in a Collection.\n\nThe limit for this endpoint is 100 items.\n\nItems will only be updated in the primary locale, unless a `cmsLocaleId` is included in the request.\n\n\n `isDraft: true` doesn't unpublish an item. The resulting status depends on whether the item has been published before:\n\n - **Item that has never been published:** the item gets a `Draft` status.\n - **Already-published item:** the item gets a `Changes in draft` status. The live item stays published, and your changes are held back until you publish them.\n\n Setting `isDraft: false` queues the item to publish on the next site publish. To remove an item from the live site, use [Unpublish Live Collection Items](/data/reference/cms/collection-items/live-items/delete-items-live). For the full status mapping, see [Publishing with the CMS API](/data/docs/working-with-the-cms/publishing).\n\n\nRequired scope | `CMS:write`\n","properties":{"path":{"type":"object","properties":{"collection_id":{"type":"string","examples":["580e63fc8c9a982ac9b8b745"],"description":"Unique identifier for a Collection"}},"required":["collection_id"],"additionalProperties":false},"query":{"type":"object","properties":{"skipInvalidFiles":{"type":"boolean","default":true,"examples":[true],"description":"When true, invalid files are skipped and processing continues. When false, the entire request fails if any file is invalid."}},"required":[],"additionalProperties":false},"body":{"properties":{"items":{"type":"array","items":{"description":"The fields that define the schema for a given Item are based on the Collection that Item belongs to. Beyond the user defined fields, there are a handful of additional fields that are automatically created for all items\n","required":["id"],"properties":{"id":{"type":"string","description":"Unique identifier for the Item","examples":["580e64008c9a982ac9b8b754"]},"cmsLocaleId":{"type":"string","description":"Identifier for the locale of the CMS item","examples":["653ad57de882f528b32e810e"]},"isArchived":{"type":"boolean","description":"Boolean determining if the Item is set to archived"},"isDraft":{"type":"boolean","description":"Sets the item's draft state. The resulting status depends on whether the item has been published before:\n\n- **Item that has never been published:** `isDraft: true` results in a `Draft` status.\n- **Already-published item:** `isDraft: true` results in a `Changes in draft` status. The live item stays published, and your changes are held back until you publish them.\n\nSetting `isDraft: true` never unpublishes an item. To remove an item from the live site, use [Unpublish Live Collection Items](/data/reference/cms/collection-items/live-items/delete-items-live).\n"},"fieldData":{"type":"object","properties":{"name":{"type":"string","description":"Name of the Item"},"slug":{"type":"string","description":"URL structure of the Item in your site. Note: Updates to an item slug will break all links referencing the old slug."}},"additionalProperties":true,"examples":[{"date":"2022-11-18T00:00:00.000Z","featured":false,"name":"My new item","slug":"my-new-item","color":"#db4b68"}]}},"examples":[{"id":"42b720ef280c7a7a3be8cabe","cmsLocaleId":"653ad57de882f528b32e810e","lastPublished":"2022-11-29T16:22:43.159Z","lastUpdated":"2022-11-17T17:19:43.282Z","createdOn":"2022-11-17T17:11:57.148Z","isArchived":false,"isDraft":false,"fieldData":{"name":"The Hitchhiker's Guide to the Galaxy","slug":"hitchhikers-guide-to-the-galaxy","plain-text":"Don't Panic.","rich-text":"

A Guide to Interstellar Travel

A towel is about the most massively useful thing an interstellar hitchhiker can have. Don't forget yours!

","main-image":{"fileId":"62b720ef280c7a7a3be8cabe","url":"/files/62b720ef280c7a7a3be8cabe_image.png"},"image-gallery":[{"fileId":"62b720ef280c7a7a3be8cabd","url":"/files/62b720ef280c7a7a3be8cabd_image.png"},{"fileId":"62b720ef280c7a7a3be8cabe","url":"/files/62b720ef280c7a7a3be8cabe_image.png"}],"intro-video":"https://www.youtube.com/watch?v=aJ83KAggd-4","official-site":"https://hitchhikers.fandom.com/wiki/The_Hitchhiker%27s_Guide_to_the_Galaxy","contact-email":"zaphod.beeblebrox@heartofgold.gov","support-phone":"424-242-4242","answer-to-everything":42,"release-date":"1979-10-12T00:00:00.000Z","is-featured":true,"brand-color":"#000000","category":"62b720ef280c7a7a3be8cabf","author":"62b720ef280c7a7a3be8cab0","tags":["62b720ef280c7a7a3be8cab1","62b720ef280c7a7a3be8cab2"],"downloadable-asset":{"fileId":"62b720ef280c7a7a3be8cab3","url":"/files/62b720ef280c7a7a3be8cab3_document.pdf"}}}]}}},"examples":[{"items":[{"id":"66f6ed9576ddacf3149d5ea6","cmsLocaleId":"66f6e966c9e1dc700a857ca5","fieldData":{"name":"Ne Paniquez Pas","slug":"ne-paniquez-pas","featured":false}},{"id":"66f6ed9576ddacf3149d5ea6","cmsLocaleId":"66f6e966c9e1dc700a857ca4","fieldData":{"name":"No Entrar en Pánico","slug":"no-entrar-en-panico","featured":false}},{"id":"66f6ed9576ddacf3149d5eaa","cmsLocaleId":"66f6e966c9e1dc700a857ca5","fieldData":{"name":"Au Revoir et Merci pour Tous les Poissons","slug":"au-revoir-et-merci","featured":false}},{"id":"66f6ed9576ddacf3149d5eaa","cmsLocaleId":"66f6e966c9e1dc700a857ca4","fieldData":{"name":"Hasta Luego y Gracias por Todo el Pescado","slug":"hasta-luego-y-gracias","featured":false}}]}]}},"required":["path"],"additionalProperties":false},"name":"Update Collection Items","id":"webflow.update-items","example":{"path":{"collection_id":"580e63fc8c9a982ac9b8b745"}},"maxRequests":1,"summary":false}}