# grants

> Who has access to an item, with the role and where it comes from

*Reads only.*

Who has access to an item, with the role and where it comes from.

Expects nothing and changes nothing. It answers the item, its owner — in a personal
space the person who made it, wherever it sits, and in an organization space the
organization — and every grant that reaches it: each with its own grt_… ID, the subject
— an address a login provider verified, or anyone for a public one — the role, who
granted it, and its source, which is direct or the folder above it is inherited from.
The listing walks the item and its ancestors up to and including the first folder that
cuts inheritance, because that is exactly the chain access is collected along, so a
grant above a cut is not listed: it does not reach. Read it before granting, so that a
grant already live is not made a second time.

## Arguments

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

## On the command line

```sh
flie agent grants ID
```

```sh
flie --json agent grants ID                 # who has access, with the role and the source
```
