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

# Assets

> Manage the project's files (media)

Every command also takes the [global options](https://docs.nohead.io/cli/commands/global-options.md), such as `--json`.

## `nohead assets list`

List assets, newest first.

```bash theme={null}
nohead assets list [options]
```

| Option | |
| - | - |
| `--deleted` | List deleted assets instead. |
| `--search <words>` | Only assets whose filename or alt text has every word. |
| `--kind <kinds>` | Only assets of a kind, or several: image, video, audio, document, other (comma-separated) |
| `--limit <n>` | Page size (1-100, default 100) |
| `--cursor <cursor>` | Continue from a previous page's next\_cursor. |
| `--all` | Follow cursors and return every asset. |

## `nohead assets upload`

Upload files; prints their asset IDs for use in records.

```bash theme={null}
nohead assets upload [options] <files...>
```

| Argument | |
| - | - |
| `<files...>` | Files to upload. |

| Option | |
| - | - |
| `--content-type <type>` | Override the type guessed from the extension. |

## `nohead assets get`

Show an asset.

```bash theme={null}
nohead assets get [options] <id>
```

| Argument | |
| - | - |
| `<id>` | Asset ID (ast\_...) |

## `nohead assets update`

Rename an asset or set its alt text.

```bash theme={null}
nohead assets update [options] <id>
```

| Argument | |
| - | - |
| `<id>` | Asset ID (ast\_...) |

| Option | |
| - | - |
| `--filename <name>` | New filename (downloads use it) |
| `--alt <text>` | Alt text: what the image shows, the default wherever it is used ("" clears it) |

## `nohead assets url`

Print an image's URL, resized, cropped or converted.

```bash theme={null}
nohead assets url [options] <id>
```

| Argument | |
| - | - |
| `<id>` | Asset ID (ast\_...) |

| Option | |
| - | - |
| `--width <px>` | Width in pixels. |
| `--height <px>` | Height in pixels. |
| `--fit <fit>` | How the image fills width and height. One of `contain`, `cover`, `fill`. Default: `contain`. |
| `--format <format>` | The image format. One of `original`, `webp`, `avif`, `jpeg`, `png`. Default: `original`. |
| `--quality <n>` | 1-100. |

## `nohead assets download`

Download the original file.

```bash theme={null}
nohead assets download [options] <id>
```

| Argument | |
| - | - |
| `<id>` | Asset ID (ast\_...) |

| Option | |
| - | - |
| `--output <file>` | Where to save it (default: its filename) |
| `--force` | Replace the file if it exists. |

## `nohead assets delete`

Delete an asset (kept for 30 days; restore brings it back)

```bash theme={null}
nohead assets delete [options] <id>
```

| Argument | |
| - | - |
| `<id>` | Asset ID (ast\_...) |

## `nohead assets restore`

Restore a deleted asset.

```bash theme={null}
nohead assets restore [options] <id>
```

| Argument | |
| - | - |
| `<id>` | Asset ID (ast\_...) |


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