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

# Create a Folder

`POST /folders`

Create a new folder.

## Query parameters

- `fields` string[]
- `meta` string

## Request body

- object
  - `name` string, required — Name of the folder.
  - `parent` integer — Unique identifier of the parent folder. This allows for nested folders.

## Response `200`

Successful request

- object
  - `data` Folders
    - `id` string — Unique identifier for the folder.
    - `name` string — Name of the folder.
    - `parent` union — Unique identifier of the parent folder. This allows for nested folders.
      - string
      - Folders — recursive

## Other responses

- `401` — Error: Unauthorized request
- `404` — Error: Not found.

---

[API](https://skmtc.dev/utomic-media/apis/dynamic-api-specification.md) · [All operations](https://skmtc.dev/utomic-media/apis/dynamic-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/utomic-media/dynamic-api-specification/revisions/4a0ccd34700e/schema)