# stat

> One item: its name, kind, ID and the token a change to it must expect

*Reads only.*

One item: its name, kind, ID and the token a change to it must expect.

Expects nothing and changes nothing. It takes a folder ID or a file ID and answers the
item, its revision, the access you hold on it, whether it cuts inheritance, and — for a
folder — its subtree_revision, the token trashing that folder expects. It is the only
read besides link that answers that token, because computing it reads the whole subtree.
For a file it also answers the content head: size, sha256 and the current version.

## Arguments

| Argument | Type | Required | Meaning |
| --- | --- | --- | --- |
| `id` | text | yes | The folder or file to describe |

## On the command line

```sh
flie agent stat ID
```

```sh
flie --json agent stat ID           # one item: its name, kind, revision, and - for a
                              # folder - the subtree_revision trashing it expects
```
