---
title: "bird assets uploads cancel"
description: "Cancel a media-library upload"
canonical: "https://bird.com/docs/cli/reference/assets-uploads-cancel"
---

# `bird assets uploads cancel`

## Usage

```bash
bird assets uploads cancel <upload-id> [flags]
```

## Description

Prevents an unfinished session from publishing. Already completed sessions return their saved result. Cancellation does not recall an asset or immediately revoke an upload URL.

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

## Examples

```bash
bird assets uploads cancel <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)         |

#### Options

| Name                | Description                                      |
| ------------------- | ------------------------------------------------ |
| `--response-schema` | Print the fields this command returns, then exit |

## Related

| Name                                                                          | Description                                |
| ----------------------------------------------------------------------------- | ------------------------------------------ |
| [`bird assets uploads complete`](/docs/cli/reference/assets-uploads-complete) | Complete a media-library upload            |
| [`bird assets uploads create`](/docs/cli/reference/assets-uploads-create)     | Create a media-library upload session      |
| [`bird assets uploads get`](/docs/cli/reference/assets-uploads-get)           | Get a media-library upload session         |
| [`bird assets uploads prepare`](/docs/cli/reference/assets-uploads-prepare)   | Refresh a media-library upload instruction |

## 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)