---
title: "Create a folder"
method: POST
path: "/api/folders"
---

# Create a folder

`POST /api/folders`

Creates a new folder. Order is auto-assigned if omitted.

## Request body

- object
  - `name` string — Folder name
  - `parentFolderId` string, nullable — Parent folder ID, or null for root-level
  - `order` integer — Sort order among siblings. Auto-assigned if omitted.

## Response `200`

The created folder ID

- object
  - `id` string, required — ID of the created folder

## Other responses

- `400` — Invalid request body
- `401` — Missing or invalid bearer token
- `403` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.net/eraser/apis/render.md) · [All operations](https://skmtc.net/eraser/apis/render/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eraser/render/versions/c31350b435dc/schema)