# Mkdirs

Launch stage: GA

`POST /api/2.0/workspace/mkdirs`

Creates the specified directory (and necessary parent directories if they do not exist).
 If there is an object (not a directory) at any prefix of the input path, this call returns
 an error `RESOURCE_ALREADY_EXISTS`.

 Note that if this operation fails it may have succeeded in creating some of the necessary parent directories.

API scopes: workspace

## Request body

- `path` (string, optional)
  The absolute path of the directory. If the parent directories do not exist, it will also create them.
   If the directory already exists, this command will do nothing and succeed.

## Response

```json
{}
```