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

# Create a knowledge store item collection

`POST /knowledge-stores/{knowledge_store_id}/item-collections`

Creates an item collection in the specified knowledge store. An item collection is a named collection of items. Use item collections to organize and reference subsets of items together.

## Path parameters

- `knowledge_store_id` string, required

## Headers

- `x-api-key` string, required

## Request body

- object
  - `name` string, required — 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. Both keys and values must be strings.

## Response `201`

The item collection has been successfully created.

- 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.
  - `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.

---

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