---
title: "Update existing items in a Collection"
method: PUT
path: "/v3/collections/items"
tags: ["Collections"]
---

# Update existing items in a Collection

`PUT /v3/collections/items`

## Request body

- UpdateCollectionItemsRequestV3 — Request to update existing items in a collection
  - `collectionName` string, required — The name/path of the collection. Must use only letters, digits, underscores, and dots. Each segment must start with a letter or underscore.
  - `items` CollectionItemUpdateV3[], required — Array of items to update (maximum 100 items per request)
    - `collectionItemID` string, required — Unique identifier for the item to update
    - `data` union, required — The updated data to be embedded and stored (string or JSON object)
      - string
      - object

## Response `200`

The request has succeeded.

- UpdateCollectionItemsResponseV3 — Response after queuing items for async update
  - `status` 'pending', required — Processing status
  - `message` string, required — Status message
  - `eventID` string, required — Event ID for tracking this operation. Use this to correlate with webhook notifications.
  - `updatedCount` integer — Number of items updated (only present in synchronous mode, deprecated)
  - `items` CollectionItemV3[] — Array of items that were updated (only present in synchronous mode, deprecated)
    - `collectionItemID` string, required — Unique identifier for the item
    - `data` union, required — The data stored in this item
      - string
      - object
    - `createdAt` string, date-time, required — When the item was created
    - `updatedAt` string, date-time, required — When the item was last updated

## Other responses

- `400` — The server could not understand the request due to invalid syntax.
- `404` — The server cannot find the requested resource.
- `500` — Server error

---

[API](https://skmtc.dev/bem-team/apis/bem-api.md) · [All operations](https://skmtc.dev/bem-team/apis/bem-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bem-team/bem-api/revisions/a6e4624117c6/schema)