# leave

> Give up the user's own access to something shared with them

*Changes something. Undoing it takes another act.*

Give up the user's own access to something shared with them.

Expects nothing, for the reason grant expects nothing. It ends the user's own direct
grant on the item and nothing else: access that reaches them through a folder above is
left by whoever gave it, and holding no direct grant at all is not_found. Afterwards the
item may answer with the access none, or refuse the user outright with access_denied at
none. It is an act on the user's own access, so it takes the user's instruction like
every other sharing act.

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 |
| --- | --- | --- | --- |
| `id` | text | yes | The folder or file to stop having access to |
| `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 leave ID [--key OPERATION_KEY]
```

```sh
flie --json agent leave ID                  # give up the user's own access to it
```
