These docs are for v1.0. Click to read the latest docs for v1.2.

Update Folder

Allows the requester to modify certain fields on a folder.

Updating the parent field will cause the folder to be moved into the new folder.
The requesting user must have edit and share access to the old and new parent folders or else the entire update will fail.
The contents of the folder will remain within it during the move. It is an error to update the parent field on a Team Folder.

Moving folders into or out of a Team Folder can fail for a variety of permission-related reasons.
Once within a Team Folder, a folder and all of its descendants can be reorganized within that Team Folder without causing any permission errors.

It supports only User token type.

Valid Access Token Types

User

Valid Access Scopes

folder


Path Params
number
required

ID of the folder to be updated.

Body Params
string

New name for the folder being updated.

number | null

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.

Headers
string
required
Defaults to 1

The API version used in the request.

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.

Language
Credentials