# history

> Content versions of a file, newest first

*Reads only.*

Content versions of a file, newest first.

Expects nothing and changes nothing. Each version carries its own ID, which the read
tool with version takes. A file's revision is its place in this history and turns only
when its bytes change.

## Arguments

| Argument | Type | Required | Meaning |
| --- | --- | --- | --- |
| `file_id` | text | yes | The file whose versions to list |

## On the command line

```sh
flie agent history FILE_ID
```

```sh
flie --json agent history FILE_ID                       # content versions, newest first
```
