---
title: "Update an entity collection"
method: PATCH
path: "/entity-collections/{entity_collection_id}"
tags: ["entityCollections"]
---

# Update an entity collection

`PATCH /entity-collections/{entity_collection_id}`

This method updates the specified entity collection.

## Path parameters

- `entity_collection_id` string, required

## Headers

- `x-api-key` string, required

## Request body

- object
  - `name` string — The updated name of the entity collection.
  - `description` string — The updated description of the entity collection.

## Response `200`

The entity collection has been successfully updated.

- EntityCollection — An object that represents a collection of related entities.
  - `_id` string — The unique identifier of the entity collection.
  - `name` string — The name of the entity collection.
  - `description` string — The description of the entity collection.
  - `created_at` string, date-time — The date and time, in RFC 3339 format (“YYYY-MM-DDTHH:mm:ssZ”), when the entity collection was created.
  - `updated_at` string, date-time — The date and time, in RFC 3339 format (“YYYY-MM-DDTHH:mm:ssZ”), when the entity collection was last updated.

## Other responses

- `400` — The request has failed.

## Changes

- **2026-07-31** `5dbd6e8473c9` — 1 warning
  - removed the optional property `docs_url` from the response with the `400` status

[Change history](https://skmtc.dev/twelvelabs/apis/twelvelabs-api/changes/entity-collections/:entity_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/0d3587e9a7c8/schema)