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

# Update Folder

`PATCH /v2/folders/{id}`

## Request

- Base URL: `https://api.lucid.co`
- URL: `https://api.lucid.co/v2/folders/{id}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://lucid.app/oauth2/authorize`
    - Token URL: `https://api.lucid.co/oauth2/token` scopes: `folder`
- TypeScript: <https://skmtc.dev/lucid/apis/lucid-rest-api/docs/v2/folders/:id/patch.ts> (a function with typed inputs; its response is checked against the schema)

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` union: New parent for the folder being updated. Causes the folder to be moved into another folder if a numeric folder ID is provided, into the root of a Team if a `team_`-prefixed Team 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.
    - number, nullable: Numeric folder ID.
    - string: Team ID prefixed with `team_`.

## Response `200`

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

- FolderWithRepositoryV2: A standard representation of a folder. A folder at the root of a Team reports that Team as its parent.
  - `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` union: Where the folder lives: the numeric ID of the parent folder, or the `team_`-prefixed ID of the Team whose root contains it. Null for a folder at the root of the user's folder manager ("My Documents").
    - number, nullable
    - string
  - `created` string, date-time, required: Date and time of when the folder was created
  - `trashed` string, date-time, nullable: Date and time of when the folder was trashed. Null when the folder is not 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.
  - `repository` Repository
    - `repositoryId` string: the ID of the repository

## Other responses

- `400`: Bad Request if invalid input types are provided for id or name, if the parent is not a number (for folders) or a string prefixed with team_ (for Teams), or if a repository parent (a string prefixed with repo_) is provided, which this endpoint does not currently support.
- `403`: Forbidden if the app making the request does not have permission to the folder, the folder has been deleted or does not exist, the Team given as `parent` does not exist, the request was not authorized to move the folder, or the parent field is included in a request for a team folder.

## Changes

- **2026-11-03** `9c2c917ec59c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lucid/apis/lucid-rest-api/changes/v2/folders/:id/patch.md)

---

[API](https://skmtc.dev/lucid/apis/lucid-rest-api.md) - [All operations](https://skmtc.dev/lucid/apis/lucid-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lucid/apis/lucid-rest-api/revisions/9c2c917ec59c?raw)