> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adside.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Assets

> The 15 adside commands for Assets.

See [Using commands](https://docs.adside.ai/cli/commands.md) for how flags, JSON input, paging and confirmations work. Run `adside assets --help` to see what your installed version has.

## assets

### assets archive

Archive an asset.

```bash theme={null}
adside assets archive --asset-id <id>
```

### assets batch

Look up assets in this workspace by ID.

```bash theme={null}
adside assets batch --ids '<json>'
```

### assets delete

Remove an asset and queue storage cleanup.

```bash theme={null}
adside assets delete --asset-id <id>
```

### assets download

Download an asset to a new local file.

```bash theme={null}
adside assets download --asset-id <id> --out <out>
```

| Flag | Value | What it does |
| - | - | - |
| `--asset-id` (required) | `<id>` | Asset to download |
| `--out` (required) | `<out>` | Destination file (must not exist) |

### assets get

Get an asset and its download URL.

```bash theme={null}
adside assets get --asset-id <id>
```

### assets import-url

Import a public image or video URL into the asset library.

```bash theme={null}
adside assets import-url --url <url> [flags]
```

| Flag | Value |
| - | - |
| `--url` (required) | `<url>` |
| `--name` | `<name>` |
| `--tags` | `'<json>'` |

### assets list

List the workspace's assets, with filters and cursor pagination.

```bash theme={null}
adside assets list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--search` | `<search>` | |
| `--source-type` | `'<json>'` | |
| `--category` | `'<json>'` | |
| `--tags` | `'<json>'` | |
| `--media-type` | `'<json>'` | |
| `--date-added-from` | `<date-added-from>` | |
| `--date-added-to` | `<date-added-to>` | |
| `--min-size-bytes` | `<min 0>` | |
| `--max-size-bytes` | `<number>` | |
| `--status` | `PENDING\|PROCESSING\|READY\|FAILED\|ARCHIVED\|PENDING_DELETION` | |
| `--limit` | `<1-100>=50` | |
| `--cursor` | `<next>` | The next page, from the previous output. |
| `--sort-by` | `createdAt\|name\|fileSize=createdAt` | |
| `--sort-order` | `asc\|desc=desc` | |

### assets status

Check asset processing and upload readiness.

```bash theme={null}
adside assets status --ids '<json>'
```

### assets transcription

Request or read a video transcription.

```bash theme={null}
adside assets transcription --asset-id <id>
```

### assets update

Update asset metadata.

```bash theme={null}
adside assets update --asset-id <id> [flags]
```

| Flag | Value |
| - | - |
| `--asset-id` (required) | `<id>` |
| `--name` | `<name>` |
| `--description` | `<description>` |
| `--category` | `UNKNOWN\|LOGO\|PRODUCT\|LIFESTYLE\|BANNER\|ICON\|BACKGROUND\|SCREENSHOT\|AD_CREATIVE\|OTHER` |
| `--tags` | `'<json>'` |

### assets upload

Upload a local media file and publish it in the asset library.

```bash theme={null}
adside assets upload --file <file> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--file` (required) | `<file>` | Local media or tabular file |
| `--purpose` | `library\|attachment=library` | library or attachment (CSV/XLSX audience input) |
| `--content-type` | `<content-type>` | Media MIME type (inferred from extension by default) |

## assets tags

### assets tags list

List the workspace's most-used asset tags.

```bash theme={null}
adside assets tags list
```

### assets tags update

Add or remove asset tags.

```bash theme={null}
adside assets tags update --asset-id <id> [flags]
```

| Flag | Value |
| - | - |
| `--asset-id` (required) | `<id>` |
| `--add` | `'<json>'` |
| `--remove` | `'<json>'` |

## assets uploads

### assets uploads complete

Publish an uploaded asset (safe to repeat).

```bash theme={null}
adside assets uploads complete --asset-id <id>
```

### assets uploads create

Reserve a media upload and return a single-file upload ticket.

```bash theme={null}
adside assets uploads create --filename <filename> --content-type <content-type> --size-bytes <number> [flags]
```

| Flag | Value |
| - | - |
| `--filename` (required) | `<filename>` |
| `--content-type` (required) | `<content-type>` |
| `--size-bytes` (required) | `<number>` |
| `--purpose` | `library\|attachment=library` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.