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

# files

> Upload, list, retrieve, and delete files

The `vlmrun files` command manages files on the VLM Run platform.

## Upload

```bash theme={"theme":{"light":"github-light","dark":"dark-plus"}}
vlmrun files upload photo.jpg
vlmrun files upload document.pdf --purpose vision
```

| Argument/Option | Description                                                                                |
| --------------- | ------------------------------------------------------------------------------------------ |
| `FILE`          | Path to the file to upload (required)                                                      |
| `--purpose`     | File purpose: `datasets`, `fine-tune`, `assistants`, `vision`, etc. (default: `fine-tune`) |

## List

```bash theme={"theme":{"light":"github-light","dark":"dark-plus"}}
vlmrun files list
```

## Get

```bash theme={"theme":{"light":"github-light","dark":"dark-plus"}}
# Get file info
vlmrun files get <file-id>

# Download to a specific path
vlmrun files get <file-id> --output ./downloaded-file.jpg
```

| Argument/Option | Description                           |
| --------------- | ------------------------------------- |
| `FILE_ID`       | ID of the file to retrieve (required) |
| `--output`      | Output file path                      |

## Delete

```bash theme={"theme":{"light":"github-light","dark":"dark-plus"}}
vlmrun files delete <file-id>
```

| Argument/Option | Description                         |
| --------------- | ----------------------------------- |
| `FILE_ID`       | ID of the file to delete (required) |