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

# Create folder

`POST /api/users/folders`

## Request

- Base URL: `https://localhost:8080`
- URL: `https://localhost:8080/api/users/folders`
- Auth: `bearer` (a scheme the document does not define)

Create a new folder for organizing files

## Request body

- CreateFolderDto
  - `name` string, required: Folder name
  - `description` string: Optional description

## Response `201`

- FolderResponseDto
  - `id` string, required
  - `userId` string, required
  - `name` string, required
  - `description` object
  - `documentCount` number, required
  - `totalSizeBytes` number, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400`: Validation error
- `401`: Unauthorized

---

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