---
title: "Update a folder"
method: PUT
path: "/v1/assets/folders/{id}"
tags: ["Assets"]
---

# Update a folder

`PUT /v1/assets/folders/{id}`

Updates the name and/or parent folder of an existing folder. At least one of `name` or `parent_folder_id` must be provided. Moving a folder into itself or one of its descendants is not allowed (cycle detection).

## Path parameters

- `id` integer, required

## Request body

- object
  - `name` string — New display name for the folder. Cannot be blank after trimming.
  - `parent_folder_id` integer, nullable — The ID of the new parent folder. Set to `null` to move the folder to the root level. Cannot be the folder itself or one of its descendants.

## Response `204`

Folder updated successfully.

## Other responses

- `400` — Bad request
- `401` — Unauthorized - missing or invalid API key
- `404` — Resource not found
- `409` — Conflict - linked resource or other constraint violation

---

[API](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference.md) · [All operations](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/customer/customer-io-journeys-api-reference/revisions/4b391af7cb06/schema)