---
title: "Changes to Create a folder, or find or make the folders a path names"
method: POST
path: "/vaults/{id}/folders"
---

# Changes to Create a folder, or find or make the folders a path names

`POST /vaults/{id}/folders`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 30 revisions.

- **2026-10-28** `a9a10e328ba5`: 6 breaking, 1 warning, 17 info
- **2026-10-28** `56d7c265a77a`: 4 breaking
- **2026-10-28** `8b5a64ac5f57`: 1 breaking, 5 info

## Changes

- **2026-10-28** `a9a10e328ba5`: 6 breaking, 1 warning, 17 info
  - the `data` response's property type changed from `object` to no type for status `200`
  - removed the required property `data/created_at` from the response with the `200` status
  - removed the required property `data/folder_id` from the response with the `200` status
  - removed the required property `data/name` from the response with the `200` status
  - removed the required property `data/parent_id` from the response with the `200` status
  - removed the required property `data/pinned` from the response with the `200` status
  - removed the optional property `data/created` from the response with the `200` status
  - added `#/components/schemas/Folder, subschema #2` to the `data` response property `allOf` list for the response status `200`
  - the response property `error/details` became required for the status `400`
  - the response property `error/details` became required for the status `403`
  - the response property `error/details` became required for the status `404`
  - the response property `error/details` became required for the status `409`
  - the response property `meta` became required for the status `400`
  - the response property `meta` became required for the status `403`
  - the response property `meta` became required for the status `404`
  - the response property `meta` became required for the status `409`
  - the response property `meta/api_version` became required for the status `400`
  - the response property `meta/api_version` became required for the status `403`
  - the response property `meta/api_version` became required for the status `404`
  - the response property `meta/api_version` became required for the status `409`
  - added the required property `meta/request_id` to the response with the `400` status
  - added the required property `meta/request_id` to the response with the `403` status
  - added the required property `meta/request_id` to the response with the `404` status
  - added the required property `meta/request_id` to the response with the `409` status
- **2026-10-28** `56d7c265a77a`: 4 breaking
  - the response property `error/details` became nullable for the status `400`
  - the response property `error/details` became nullable for the status `403`
  - the response property `error/details` became nullable for the status `404`
  - the response property `error/details` became nullable for the status `409`
- **2026-10-28** `8b5a64ac5f57`: 1 breaking, 5 info
  - added required request body
  - added the non-success response with the status `400`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the non-success response with the status `409`
  - added the success response with the status `200`

---

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