---
title: "Update a knowledge store item collection"
method: PATCH
path: "/knowledge-stores/{knowledge_store_id}/item-collections/{collection_id}"
tags: ["knowledgeStoreItemCollections"]
---

# Update a knowledge store item collection

`PATCH /knowledge-stores/{knowledge_store_id}/item-collections/{collection_id}`

Updates the `name`, `description`, and `metadata` fields of the specified item collection.

## Path parameters

- `knowledge_store_id` string, required
- `collection_id` string, required

## Headers

- `x-api-key` string, required

## Request body

- object
  - `name` string — The name of the item collection. Must be unique within the knowledge store.
  - `description` string — An optional description of the item collection.
  - `metadata` object — Custom metadata for the item collection, as user-defined key-value pairs. Up to 10 pairs, keys up to 128 characters, string values up to 2048 characters. Keys are strings. Each value is a string, a number, a boolean, or an array of strings; a nested object, an array holding anything but strings, and a null value are rejected. An integer must fit in 53 bits (-9007199254740991 to 9007199254740991); send a wider value, and any identifier you want preserved verbatim, as a string. The provided object replaces the existing metadata in full, so include every key you want to keep, and drop a key by omitting it. To clear all metadata, set this field to an empty object (`{}`).

## Response `200`

The item collection has been successfully updated.

- KnowledgeStoreItemCollection — A named collection of items within a knowledge store. Use item collections to organize and reference subsets of items together. The items themselves are not affected.
  - `_id` string — The unique identifier of the item collection.
  - `knowledge_store_id` string — The unique identifier of the knowledge store this collection belongs to.
  - `name` string — The name of the item collection.
  - `description` string — The description of the item collection.
  - `metadata` object — Custom metadata for the item collection. Keys are strings; each value is a string, a number, a boolean, or an array of strings.
  - `member_count` integer — The number of items in the collection.
  - `created_at` string, date-time — The date and time when the item collection was created, in the RFC 3339 format.
  - `updated_at` string, date-time — The date and time when the item collection was last updated, in the RFC 3339 format.

## Other responses

- `400` — The request has failed.

## Changes

- **2026-09-02** `335e364dd9b5` — 1 breaking, 1 info
  - response property `metadata/additionalProperties/` list-of-types was widened by adding types `array, boolean, integer and number` to media type `application/json` of response `200`
  - request property `metadata/additionalProperties/` list-of-types was widened by adding types `array, boolean, integer and number` to media type `application/json`
- **2026-08-22** `fd9d80e384a8` — 1 breaking, 2 warning
  - the `name` request property's minLength was increased from `0` to `1`
  - the `description` request property's maxLength was set to `2000`
  - the `name` request property's maxLength was set to `255`
- **2026-07-31** `5dbd6e8473c9` — 1 warning
  - removed the optional property `docs_url` from the response with the `400` status
- **2026-07-26** `c0926990c662` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/twelvelabs/apis/twelvelabs-api/changes/knowledge-stores/:knowledge_store_id/item-collections/:collection_id/patch.md)

---

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