# mkdir

> New folder in a folder

*Changes something.*

New folder in a folder.

Expects nothing: a name may repeat among siblings, so creating can never replace
anything and needs no revision. The result carries the new folder's ID and revision. A
refused change writes nothing at all. name_conflict does not exist: a name is never a
reason to refuse anything.

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 create it in |
| `name` | text | yes | What to call it |
| `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 mkdir FOLDER_ID NAME [--key OPERATION_KEY]
```

```sh
flie --json agent mkdir FOLDER_ID "research notes"
```
