---
title: "Changes to Create folder"
method: POST
path: "/folders"
---

# Changes to Create folder

`POST /folders`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `c4d5303fa5c3`: 5 warning, 8 info

## Changes

- **2026-11-03** `c4d5303fa5c3`: 5 warning, 8 info
  - added the new `unprocessable_entity` enum value to the `code` response property for the response status `400`
  - added the new `unprocessable_entity` enum value to the `code` response property for the response status `403`
  - added the new `unprocessable_entity` enum value to the `code` response property for the response status `404`
  - added the new `unprocessable_entity` enum value to the `code` response property for the response status `409`
  - added the new `unprocessable_entity` enum value to the `code` response property for the response status `default`
  - added the optional property `allOf[subschema #2]/collections` to the response with the `201` status
  - added `subschema #1, subschema #2` to the `allOf[subschema #2]/permissions` response property `allOf` list for the response status `201`
  - added `subschema #1, subschema #2, subschema #3` to the `allOf[subschema #1: Folder]/allOf[subschema #2]/item_collection/allOf[subschema #1: Items]/` response property `allOf` list for the response status `201`
  - added `subschema #2, subschema #3` to the `allOf[subschema #2]/metadata/allOf[subschema #1: Item metadata instances]/additionalProperties/additionalProperties/` response property `allOf` list for the response status `201`
  - removed `subschema #1, subschema #2` from the `allOf[subschema #2]/permissions` response property `allOf` list for the response status `201`
  - removed `subschema #1, subschema #2, subschema #3` from the `allOf[subschema #1: Folder]/allOf[subschema #2]/item_collection/allOf[subschema #1: Items]/` response property `allOf` list for the response status `201`
  - removed `subschema #2, subschema #3` from the `allOf[subschema #2]/metadata/allOf[subschema #1: Item metadata instances]/additionalProperties/additionalProperties/` response property `allOf` list for the response status `201`
  - added the required property `allOf[subschema #1: Folder]/allOf[subschema #2]/shared_link/allOf[subschema #1: Shared link]/one_time_passcode` to the response with the `201` status

---

[Operation](https://skmtc.dev/box/apis/platform-api/docs/folders/post.md) - [API](https://skmtc.dev/box/apis/platform-api.md) - [Page](https://skmtc.dev/box/apis/platform-api/changes/folders/post)
