---
title: "Update Folder"
method: PATCH
path: "/v1/folders/{id}"
tags: ["Folders"]
---

# Update Folder

`PATCH /v1/folders/{id}`

Allows the requester to modify certain fields on a folder.

When updating the parent field, the folder moves to the new parent location while its contents remain intact. The requesting user must have both edit and share access to both the old and new parent folders, or the entire update will fail.

It is not permitted to update the parent field on Team Folders. Moving folders into or out of Team Folders may encounter permission-related errors, but once a folder is within a Team Folder, reorganization among descendants within that Team Folder can proceed without permission issues.

## Path parameters

- `id` number, required

## Request body

- object
  - `name` string — New name for the folder being updated.
  - `parent` number, nullable — New parent for the folder being updated. Causes the folder to be moved into another folder if an ID is provided or into the user's root folder ("My Documents") if `null` is provided. If the parent field is not included in the request, the folder will not be moved. Cannot be provided for Team Folders.

## Response `200`

OK with a Folder resource containing information about the updated folder.

- Folder — A standard representation of a folder.
  - `id` number, required — Unique ID of the folder
  - `type` 'folder' | 'team', required — * folder - Folders can live in other folders, team folders, or the root of a user’s folder manager ("My Documents"). A folder in "My Documents" will have a null parent field. * team - Team folders can never live in another folder and are always located in the "Team Folders" section of a user's folder manager. Team folders will not have a parent field. Learn more
  - `name` string, required — Name of the folder
  - `parent` number, nullable — ID of the parent folder.
  - `created` string, date-time, required — Date and time of when the folder was created
  - `trashed` string, date-time — Date and time of when the folder was trashed
  - `attributes` FolderAttribute[] — An array of attributes assigned to the folder. Can be null or empty.
    - `name` string — Name of the attribute
    - `value` string — Value of the attribute. Can be any type, but attributes with the same name will always have the same type.

## Other responses

- `400` — Bad Request if the parent field is included in a request for a team folder, or if invalid input types are provided for id, name, or parent.
- `403` — Forbidden if the app making the request does not have permission to the folder, the folder has been deleted or does not exist, or the request was not authorized to move the folder.

---

[API](https://skmtc.net/lucid/apis/lucid-rest-api.md) · [All operations](https://skmtc.net/lucid/apis/lucid-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lucid/lucid-rest-api/versions/6a32cb9e1aa7/schema)