---
title: "Create a folder"
method: POST
path: "/folders/"
tags: ["Folders"]
---

# Create a folder

`POST /folders/`

Creates a new folder for organizing templates. Folders can be nested within other folders
by providing a `parent_folder_id`. Folder names must be unique within the same parent.

## Request body

- object
  - `folder` object, required
    - `name` string, required
    - `parent_folder_id` string

## Response `200`

folder created inside another folder

- Folder
  - `id` string, nullable, required
  - `name` string, nullable, required
  - `path` string, nullable, required
  - `parent_folder_id` string, nullable, required

## Other responses

- `401` — authentication failed
- `404` — parent folder doesn't exist
- `422` — name already exist

---

[API](https://skmtc.dev/docspring/apis/docspring-api.md) · [All operations](https://skmtc.dev/docspring/apis/docspring-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/docspring/docspring-api/revisions/5726657b9432/schema)