---
title: "Remove assets from an entity"
method: DELETE
path: "/entity-collections/{entity_collection_id}/entities/{entity_id}/assets"
tags: ["entityCollections > entities"]
---

# Remove assets from an entity

`DELETE /entity-collections/{entity_collection_id}/entities/{entity_id}/assets`

## Request

- Base URL: `https://api.twelvelabs.io/v1.3`
- URL: `https://api.twelvelabs.io/v1.3/entity-collections/{entity_collection_id}/entities/{entity_id}/assets`
- Auth: API key in header `x-api-key`

This method removes from the specified entity. Assets are used to identify the entity in media content, and removing assets may impact the accuracy of entity recognition in searches if too few assets remain.

When assets are removed, the entity may temporarily enter a "processing" state while the system updates the necessary data. Once processing is complete, the entity status will return to "ready."

<Note title="Notes">
  - This operation only removes the association between the entity and the specified assets; it does not delete the assets themselves.
  - An entity must always have at least one asset associated with it. You can't remove the last asset from an entity.
</Note>

## Path parameters

- `entity_collection_id` string, required
- `entity_id` string, required

## Request body

- object
  - `asset_ids` string[], required: An array of asset IDs to remove from the entity.

## Response `200`

The assets have been successfully removed from the entity.

- Entity: An object that represents an entity with associated assets.
  - `_id` string: The unique identifier of the entity.
  - `entity_collection_id` string: The unique identifier of the entity collection this entity belongs to.
  - `name` string: The name of the entity.
  - `description` string: A description of the entity.
  - `metadata` EntityMetadata: Custom metadata for the entity.
  - `asset_ids` string[]: An array of asset IDs associated with the entity.
  - `status` 'processing' | 'ready': The current status of the entity creation process. **Values**: - `processing`: The entity is being processed and is not yet ready for use in searches. - `ready`: The entity is fully processed and can be used in search queries.
  - `created_at` string, date-time: The date and time, in RFC 3339 format (“YYYY-MM-DDTHH:mm:ssZ”), when the entity was created.
  - `updated_at` string, date-time: The date and time, in RFC 3339 format (“YYYY-MM-DDTHH:mm:ssZ”), when the entity was last updated.

## Other responses

- `400`: The request has failed.

## Changes

- **2026-09-17** `b8591e05c0ba`: 1 warning, 1 info
  - deleted the `header` request parameter `x-api-key`
  - the endpoint scheme security `x-api-key` was added to the API
- **2026-09-12** `6205c7327cde`: 1 info
  - api operation id `delete-assets` removed and replaced with `entityCollections_entities_deleteAssets`
- **2026-07-31** `5dbd6e8473c9`: 1 warning
  - removed the optional property `docs_url` from the response with the `400` status

[Operation history](https://skmtc.dev/twelvelabs/apis/twelvelabs-api/changes/entity-collections/:entity_collection_id/entities/:entity_id/assets/delete.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.dev/twelvelabs/apis/twelvelabs-api/revisions/c23c6e18fdd1?raw)