# cut

> Stop a folder inheriting access from the folders above it

*Changes something.*

Stop a folder inheriting access from the folders above it.

Expects nothing, for the reason grant expects nothing, and a file is refused with
not_folder. Beneath a cut folder a person who reached it only from above holds nothing —
at most the folder's own row, and not even that it has children. Cutting does turn the
folder's own revision, because how a folder arranges access is the folder's own
arrangement, exactly as its name is.

This change takes a key you choose, fresh for this change. If its result never reaches
you, call again with the same key and the same arguments, or ask the status tool with
that key: the same key and the same input is one change, made once.

## Arguments

| Argument | Type | Required | Meaning |
| --- | --- | --- | --- |
| `folder_id` | text | yes | The folder to cut |
| `key` | text | yes | A key you choose for this change, fresh each time; repeat it to settle a lost result |

## On the command line

```sh
flie agent cut FOLDER_ID [--key OPERATION_KEY]
```

```sh
flie --json agent cut FOLDER_ID             # stop it inheriting access from above
```
