---
title: "bird assets delete"
description: "Remove an asset from the media library"
canonical: "https://bird.com/docs/cli/reference/assets-delete"
---

# `bird assets delete`

## Usage

```bash
bird assets delete <asset-id> [flags]
```

## Description

Removes the library entry while its public URL continues serving existing content. Repeating deletion is safe. This operation does not revoke access to the file.

This is destructive and cannot be undone; pass --yes to confirm.

## Examples

```bash
bird assets delete <id> --yes
```

## Options

#### Safety

| Name                | Description                                                  |
| ------------------- | ------------------------------------------------------------ |
| `--idempotency-key` | Deduplication key; a retry with the same key won't act twice |
| `--yes`             | Confirm the action (required; the CLI never prompts)         |

## Related

| Name                                                      | Description                               |
| --------------------------------------------------------- | ----------------------------------------- |
| [`bird assets get`](/docs/cli/reference/assets-get)       | Get a media-library asset by ID           |
| [`bird assets list`](/docs/cli/reference/assets-list)     | List workspace media-library assets       |
| [`bird assets update`](/docs/cli/reference/assets-update) | Update asset metadata or folder placement |
| [`bird assets upload`](/docs/cli/reference/assets-upload) | Create a media-library asset              |

## Related resources

- [Should I use a Bird SDK or call the API directly?](/explained/platform/should-i-use-an-sdk-or-call-the-api-directly) (answer)
- [Build your first integration](/learn/paths/integration) (course)
- [Send your first email](/docs/get-started/send-your-first-email) (docs)

[Get an implementation brief](/learn/workspace?topic=api-basics)