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

# Create a folder

`POST /api/folders`

## Request

- Base URL: `https://api.engram.page`
- URL: `https://api.engram.page/api/folders`
- Auth: HTTP bearer

Creates an explicit folder marker so the folder can exist while empty. Returns 201 with the folder (count 0). An empty or root folder path is rejected with 422.

## Request body

- CreateFolderRequest
  - `folder` string, required

## Response `201`

Created

- FolderResponse
  - `folder` Folder, required
    - `count` integer
    - `id` string, uuid, nullable
    - `name` string, required
    - `parent_id` string, uuid, nullable

## Other responses

- `422`: Empty/root folder rejected

---

[API](https://skmtc.dev/engram/apis/engram-api.md) · [All operations](https://skmtc.dev/engram/apis/engram-api/llms.txt) · [OpenAPI document](https://skmtc.dev/engram/apis/engram-api/revisions/8c4c2eec29dc?raw)