---
title: "POST /api/v1/folders"
method: POST
path: "/api/v1/folders"
---

# POST /api/v1/folders

`POST /api/v1/folders`

Creates a folder with the specified name and parent folder.

## Headers

- `Authentication` string, password

## Request body

- object
  - `Name` string, password — The name of the new folder.
  - `ParentFolderId` string, required — The ID of the parent folder.

## Response `201`

Success

- CreateFolderResponse
  - `Metadata` object — The metadata of the folder.
    - `Id` string — The ID of the folder.
    - `Name` string, password — The name of the folder.
    - `CreatorId` string — The ID of the creator.
    - `ParentFolderId` string — The ID of the parent folder.
    - `CreatedTimestamp` string, date-time — The time when the folder was created.
    - `ModifiedTimestamp` string, date-time — The time when the folder was updated.
    - `ResourceState` 'ACTIVE' | 'RESTORING' | 'RECYCLING' | 'RECYCLED' — The resource state of the folder.
    - `Signature` string — The unique identifier created from the subfolders and documents of the folder.
    - `Labels` SharedLabel[] — List of labels on the folder.
    - `Size` integer — The size of the folder metadata.
    - `LatestVersionSize` integer — The size of the latest version of the folder metadata.

## Other responses

- `480` — EntityNotExistsException
- `481` — EntityAlreadyExistsException
- `482` — ProhibitedStateException
- `483` — ConflictingOperationException
- `484` — ConcurrentModificationException
- `485` — LimitExceededException
- `486` — UnauthorizedOperationException
- `487` — UnauthorizedResourceAccessException
- `488` — FailedDependencyException
- `489` — ServiceUnavailableException

---

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