# Move an asset to the bin, or purge it with ?purge=1

`DELETE /assets/{id}` · Rivier · files

Move an asset to the bin, or purge it with ?purge=1. An asset still in use is refused (409 with where it is used) unless ?force=1.

- Scope: files:write
- Mcp: rivier_assets_delete
- Graphql: Mutation.filesAssetDelete
- Sdk: files.asset.delete
- Cli: files asset delete
- Events: files.asset.deleted

## Parameters

- `id` (path, required), string
- `purge` (query), string
- `force` (query), string

## Responses

- `200`: Success
- `400`: The request was malformed
- `401`: No valid credential
- `403`: The credential lacks the scope, origin or address
- `429`: Over the key's rate limit; see Retry-After

## Example

```sh
curl -X DELETE 'https://api.rivier.ai/assets/{id}' \
  -H 'Authorization: Bearer $KEY'
```