---
title: "Changes to Creates or updates the folder specified by the `folderPath`.\n\nIf the folder's ancestors do not exist, they will be created automatically (with empty FolderSettings).\n\nNote: you don't need to create folders before uploading files to them.\n\nRequires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth."
method: PUT
path: "/v2/accounts/{accountId}/folders"
---

# Changes to Creates or updates the folder specified by the `folderPath`.

If the folder's ancestors do not exist, they will be created automatically (with empty FolderSettings).

Note: you don't need to create folders before uploading files to them.

Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.

`PUT /v2/accounts/{accountId}/folders`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-09-01** `d63ecdd9ae9c`: 2 breaking, 5 info

## Changes

- **2026-09-01** `d63ecdd9ae9c`: 2 breaking, 5 info
  - the response property `settingsInherited/publicPermissions` became optional for the status `200`
  - the response property `settingsInherited/storageLayer` became optional for the status `200`
  - the request property `folderSettings/description` became optional
  - the request property `folderSettings/publicPermissions` became optional
  - the request property `folderSettings/storageLayer` became optional
  - removed `#/components/schemas/PublicPermissionsInherited` from the `settingsInherited/publicPermissions` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/StorageLayerInherited` from the `settingsInherited/storageLayer` response property `allOf` list for the response status `200`

---

[Operation](https://skmtc.dev/bytescale/apis/bytescale-api/docs/v2/accounts/:accountId/folders/put.md) - [API](https://skmtc.dev/bytescale/apis/bytescale-api.md) - [Page](https://skmtc.dev/bytescale/apis/bytescale-api/changes/v2/accounts/:accountId/folders/put)