<!--
  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/list_folders

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


# list_folders

**List immut folders**

List folders in a workspace so you can file a document in the right place. Omit parentFolder for top-level; pass a folder id for its children, or "all" for every folder at all depths. Read-only.

- Access: read-only
- Calls: `/api/v1/folders`

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `workspace` | string | **yes** | Workspace id |
| `parentFolder` | string | no | Parent folder id, or "all" for every folder |

## Tool contract

```json
{
  "name": "list_folders",
  "title": "List immut folders",
  "description": "List folders in a workspace so you can file a document in the right place. Omit parentFolder for top-level; pass a folder id for its children, or \"all\" for every folder at all depths. Read-only.",
  "access": "read",
  "destructive": false,
  "hostedOnProduction": true,
  "restEndpoint": "/api/v1/folders",
  "arguments": {
    "workspace": {
      "type": "string",
      "required": true,
      "description": "Workspace id"
    },
    "parentFolder": {
      "type": "string",
      "required": false,
      "description": "Parent folder id, or \"all\" for every folder"
    }
  }
}
```