<!--
  immut documentation, machine-readable.

  Everything in one file:  https://www.immut.io/llms-full.txt
    What immut is, which integration path to choose, authentication and scopes, and the COMPLETE
    API reference: every endpoint with parameters, responses and a runnable curl. Fetch this first
    if you intend to call the API.

  Index of all pages:      https://www.immut.io/llms.txt
  OpenAPI contract:        https://www.immut.io/docs/openapi.json
  This page as HTML:       https://www.immut.io/docs/mcp/create_folder

  Any page on this site is available as raw markdown by appending .md to its URL.
-->


# create_folder

**Create an immut folder**

Create a folder in a workspace (optionally under a parent) so documents are organised, e.g. "Contracts" or "Intellectual property". Returns the folder id to pass to protect_path/protect_file.

- Access: write
- Calls: `/api/v1/folders`

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `name` | string | **yes** |  |
| `workspace` | string | **yes** |  |
| `parentFolder` | string | no |  |

## Tool contract

```json
{
  "name": "create_folder",
  "title": "Create an immut folder",
  "description": "Create a folder in a workspace (optionally under a parent) so documents are organised, e.g. \"Contracts\" or \"Intellectual property\". Returns the folder id to pass to protect_path/protect_file.",
  "access": "write",
  "destructive": false,
  "hostedOnProduction": true,
  "restEndpoint": "/api/v1/folders",
  "arguments": {
    "name": {
      "type": "string",
      "required": true,
      "description": ""
    },
    "workspace": {
      "type": "string",
      "required": true,
      "description": ""
    },
    "parentFolder": {
      "type": "string",
      "required": false,
      "description": ""
    }
  }
}
```