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

# ekso file

> File attachments on items and annotations.

## Overview

File attachments on items and annotations.

## Verbs

| Verb       | Description                                                                                         |
| ---------- | --------------------------------------------------------------------------------------------------- |
| `list`     | List files on an entity (--item or --annotation, exactly one).                                      |
| `get`      | Fetch a single file's metadata by id.                                                               |
| `upload`   | Upload a file (positional path; --item or --annotation). Returns the new DataFile.                  |
| `download` | Download a file by id (default: ./\<original-filename>; --output - for stdout; --force overwrites). |
| `delete`   | Delete a file (DB record + blob; no recovery).                                                      |

## Detailed help

Run `ekso` directly to see flags and arguments — `--help` reflects the binary you have installed.

```bash theme={null}
ekso file --help
ekso file list --help
```

## See also

* [CLI overview](/cli/overview)
* [Authentication](/cli/authentication)
* [Configuration](/cli/configuration)
* [API Reference](/api-reference/introduction) — the underlying HTTP routes.