---
title: "Delete asset entity"
method: DELETE
path: "/assets/entities/{entity_id}"
tags: ["Assets"]
---

# Delete asset entity

`DELETE /assets/entities/{entity_id}`

## Request

- Base URL: `https://api.fal.ai/v1`
- URL: `https://api.fal.ai/v1/assets/entities/{entity_id}`
- Auth: API key in header `Authorization`

Delete a saved entity from the authenticated account. Its reference assets are not deleted.

**Required permissions:** `assets:write`. Key presets that include them: `API`, `SERVERLESS`, `FULL`. See [key permissions](https://fal.ai/docs/documentation/model-apis/authentication/key-based#permissions).

## Path parameters

- `entity_id` string, required: Smart entity ID

## Headers

- `Idempotency-Key` string: Optional idempotency key for safe request retries

## Response `204`

Entity deleted

## Other responses

- `400`: Invalid request parameters
- `401`: Authentication required
- `403`: Access denied
- `404`: Resource not found
- `409`: Invalid request parameters
- `422`: Invalid request parameters
- `429`: Rate limit exceeded
- `500`: Internal server error
- `502`: Upstream asset service error

## Changes

- **2026-09-13** `51d8e07444e1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fal/apis/platform-apis/changes/assets/entities/:entity_id/delete.md)

---

[API](https://skmtc.dev/fal/apis/platform-apis.md) - [All operations](https://skmtc.dev/fal/apis/platform-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/fal/apis/platform-apis/revisions/3b3b61bedf06?raw)