---
title: "create folder"
method: POST
path: "/w/{workspace}/folders/create"
tags: ["folder"]
---

# create folder

`POST /w/{workspace}/folders/create`

## Path parameters

- `workspace` string, required

## Request body

- object
  - `name` string, required
  - `summary` string
  - `owners` string[]
  - `extra_perms` unknown
  - `default_permissioned_as` object[] — Ordered list of rules applied at create-time when admins or `wm_deployers` members deploy items in this folder. The first rule whose `path_glob` matches the item path (relative to the folder root) wins, and its `permissioned_as` is used as the default.
    - `path_glob` string, required — Glob pattern evaluated against the item path *relative* to the folder root (e.g. "jobs/**" matches every item whose full path is `f/<folder>/jobs/...`). Supports `*`, `**`, `?`, `[abc]`, `{a,b}`.
    - `permissioned_as` string, required — Target identity the matched item should be permissioned as. Must be `u/<username>`, `g/<groupname>`, or an email that exists in this workspace.
  - `labels` string[]

## Response `200`

folder created

---

[API](https://skmtc.net/windmill/apis/windmill-api.md) · [All operations](https://skmtc.net/windmill/apis/windmill-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/windmill/windmill-api/revisions/db0e7e036e34/schema)