---
title: "Update existing folder"
method: PUT
path: "/api/v1/assets/folders"
tags: ["Web Assets"]
---

# Update existing folder

`PUT /api/v1/assets/folders`

## Request

- Base URL: `https://docs.anzworldline-solutions.com.au`
- URL: `https://docs.anzworldline-solutions.com.au/api/v1/assets/folders`
- Auth: none declared
- TypeScript: <https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api/docs/api/v1/assets/folders/put.ts> (a function with typed inputs; its response is checked against the schema)

Update an existing folder's configuration details and optionally rename it

## Request body

- UpdateFolderForm
  - `assetPath` string, required: Full path where the folder should be created or updated including site and folder structure. Must end with '/'
  - `data` UpdateFolderDetail, required: Folder configuration details
    - `title` string, required: Display title for the folder
    - `sortOrder` integer: Sort order for the folder within its parent directory
    - `showOnMenu` boolean: Whether the folder should be visible in navigation menus
    - `fileMasks` string[]: List of file patterns that are allowed in this folder (e.g., *.jpg, *.pdf)
    - `defaultAssetType` string: Default asset type for files uploaded to this folder
    - `defaultBaseType` string: Content Drive upload-mode preference for this folder, recorded as a base content type name (DOTASSET or FILEASSET; case-insensitive, also accepts the alternate names DotAsset/File and stored canonically in uppercase). Omit or set to null for no preference ("ask each time"); on update, omitting/null clears any previously set preference. This is orthogonal to defaultAssetType and does not change FileAsset behavior.
    - `name` string, required: New name for the folder. If provided, the folder will be renamed. The name is derived from the path if not specified

## Response `200`

Folder updated successfully

- ResponseEntityView
  - `errors` ErrorEntity[]
    - `errorCode` string
    - `message` string
    - `fieldName` string
  - `entity` object
  - `messages` MessageEntity[]
    - `message` string
  - `i18nMessagesMap` object
  - `permissions` string[]
  - `pagination` Pagination
    - `currentPage` integer
    - `perPage` integer
    - `totalEntries` integer

## Other responses

- `400`: Invalid request data or folder path
- `401`: Unauthorized access
- `403`: Insufficient permissions to update folder
- `404`: Folder not found at the specified path

## Changes

- **2026-10-30** `4fd8e917d458`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api/changes/api/v1/assets/folders/put.md)

---

[API](https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api.md) - [All operations](https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api/revisions/4fd8e917d458?raw)