---
title: "Delete an asset"
method: DELETE
path: "/assets/{asset_id}"
tags: ["assets"]
---

# Delete an asset

`DELETE /assets/{asset_id}`

This method deletes the specified asset. This action cannot be undone.

By default, the platform checks whether any indexed assets reference the asset. If references exist, the platform rejects the request with a `409 Conflict` error. To skip this check and delete the asset anyway, set the `force` query parameter to `true`. The platform unlinks any entity associations.

Before deleting, you can inspect existing references:
- [`GET`](/v1.3/api-reference/index-content/list-indexed-assets-by-asset) `/assets/{asset_id}/indexed-assets` returns a list of the indexed assets that will block deletion unless the `force` query parameter is set to `true`.
- [`GET`](/v1.3/api-reference/entities/list-entities-by-asset) `/assets/{asset_id}/entities` returns a list of the entities whose associations the platform will unlink.

## Path parameters

- `asset_id` string, required

## Query parameters

- `force` boolean

## Headers

- `x-api-key` string, required

## Response `200`

Successful response

## Other responses

- `400` — The request has failed.
- `409` — The platform cannot delete this asset because one or more indexed assets are referencing it. Set the `force` query parameter to `true` to override.

---

[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/versions/5dbd6e8473c9/schema)