For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Resources
Get started
ReferenceGuidesExamplesChangelog
ReferenceGuidesExamplesChangelog
  • Data API
    • Introduction
  • Token
    • GETGet Authorization User Info
    • GETGet Authorization Info
  • Sites
    • GETList Sites
    • GETGet Site
    • GETGet Custom Domains
    • POSTPublish Site
  • Pages and Components
  • CMS
        • GETList Items
        • GETGet Item
        • POSTCreate Items
        • PATCHUpdate Items
        • DELDelete Items
        • POSTPublish Items
  • Forms
  • Custom Code
  • Assets
  • Custom fonts
  • Comments
    • GETList Comment Threads
    • GETGet Comment Thread
    • GETList Comment Replies
  • Ecommerce
  • Webhooks
    • GETList Webhooks
    • GETGet Webhook
    • POSTCreate Webhook
    • DELRemove Webhook
  • Site Configuration
  • Enterprise
LogoLogo
Resources
Get started
CMSCollection ItemsStaged Items

Update Items

PATCH
https://api.webflow.com/v2/collections/:collection_id/items
PATCH
/v2/collections/:collection_id/items
$curl -X PATCH "https://api.webflow.com/v2/collections/580e63fc8c9a982ac9b8b745/items?skipInvalidFiles=true" \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "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
>      }
>    }
>  ]
>}'
1{
2  "id": "580e64008c9a982ac9b8b754",
3  "lastPublished": "2023-03-17T18:47:35.560Z",
4  "lastUpdated": "2023-03-17T18:47:35.560Z",
5  "createdOn": "2023-03-17T18:47:35.560Z",
6  "fieldData": {
7    "name": "My new item",
8    "slug": "my-new-item",
9    "date": "2022-11-18T00:00:00.000Z",
10    "featured": false,
11    "color": "#db4b68"
12  },
13  "items": [
14    {
15      "id": "66f6ed9576ddacf3149d5ea6",
16      "lastPublished": "2024-09-27T17:38:29.066Z",
17      "lastUpdated": "2024-09-27T17:38:29.066Z",
18      "createdOn": "2024-09-27T17:38:29.066Z",
19      "cmsLocaleId": "66f6e966c9e1dc700a857ca5",
20      "isArchived": false,
21      "isDraft": false,
22      "fieldData": {
23        "name": "Ne Paniquez Pas",
24        "slug": "ne-paniquez-pas",
25        "featured": false
26      }
27    },
28    {
29      "id": "66f6ed9576ddacf3149d5ea6",
30      "lastPublished": "2024-09-27T17:38:29.066Z",
31      "lastUpdated": "2024-09-27T17:38:29.066Z",
32      "createdOn": "2024-09-27T17:38:29.066Z",
33      "cmsLocaleId": "66f6e966c9e1dc700a857ca4",
34      "isArchived": false,
35      "isDraft": false,
36      "fieldData": {
37        "name": "No Entrar en Pánico",
38        "slug": "no-entrar-en-panico",
39        "featured": false
40      }
41    },
42    {
43      "id": "66f6ed9576ddacf3149d5eaa",
44      "lastPublished": "2024-09-27T17:38:29.066Z",
45      "lastUpdated": "2024-09-27T17:38:29.066Z",
46      "createdOn": "2024-09-27T17:38:29.066Z",
47      "cmsLocaleId": "66f6e966c9e1dc700a857ca5",
48      "isArchived": false,
49      "isDraft": false,
50      "fieldData": {
51        "name": "Au Revoir et Merci pour Tous les Poissons",
52        "slug": "au-revoir-et-merci",
53        "featured": false
54      }
55    },
56    {
57      "id": "66f6ed9576ddacf3149d5eaa",
58      "lastPublished": "2024-09-27T17:38:29.066Z",
59      "lastUpdated": "2024-09-27T17:38:29.066Z",
60      "createdOn": "2024-09-27T17:38:29.066Z",
61      "cmsLocaleId": "66f6e966c9e1dc700a857ca4",
62      "isArchived": false,
63      "isDraft": false,
64      "fieldData": {
65        "name": "Hasta Luego y Gracias por Todo el Pescado",
66        "slug": "hasta-luego-y-gracias",
67        "featured": false
68      }
69    }
70  ],
71  "pagination": {
72    "limit": 25,
73    "offset": 0,
74    "total": 4
75  }
76}
Update a single item or multiple items in a Collection. The limit for this endpoint is 100 items. <Tip title="Localization Tip">Items will only be updated in the primary locale, unless a `cmsLocaleId` is included in the request.</Tip> Required scope | `CMS:write`
Was this page helpful?
Previous

Delete Items

Next
Built with

Update a single item or multiple items in a Collection.

The limit for this endpoint is 100 items.

Localization Tip
Items will only be updated in the primary locale, unless a cmsLocaleId is included in the request.

Required scope | CMS:write

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

collection_idstringRequiredformat: "objectid"
Unique identifier for a Collection

Query parameters

skipInvalidFilesbooleanOptionalDefaults to true
When true, invalid files are skipped and processing continues. When false, the entire request fails if any file is invalid.

Request

Details of the item to update
itemslist of objectsOptional

Response

Request was successful
Collection Itemobject

A Collection Item represents a single entry in your collection. Each item includes:

  • System metadata - Automatically managed fields like IDs and timestamp
  • Status flags - Controls for managing content state: isDraft, isArchived
  • Content fields - Stored in fieldData. Each item needs a name and slug, and may include additional fields matching your collection’s schema definition.
OR
Collection Item Listobject
Results from collection items list

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error