Update a folder

Renames and/or reparents a folder. Supply name to rename (kept unique among siblings at the resulting level) and/or parentFolderId to move — null moves the folder to the top level, a UUID moves it under that top-level folder. Reparenting under a subfolder, or moving a folder that itself contains subfolders under another folder, is rejected (FOLDER_MAX_DEPTH_EXCEEDED). Projects filed in the folder travel with it.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Unique identifier (UUID) for the folder.

Body Params
string

New folder name (unique among siblings at the resulting level). Omit to keep the current name.

string

Reparent the folder. Omit to keep the current parent; null moves the folder to the top level; a UUID moves it under that top-level folder. Reparenting under a subfolder is rejected (FOLDER_MAX_DEPTH_EXCEEDED).

Responses

400

FOLDER_MAX_DEPTH_EXCEEDED: The requested parent is already a subfolder, or the folder being moved itself contains subfolders; only one subfolder level is supported. Also returned when no update fields are supplied.

404

FOLDER_NOT_FOUND: The folder was not found. FOLDER_PARENT_NOT_FOUND: The requested parent folder was not found.

409

FOLDER_NAME_NOT_UNIQUE: A folder with the same name already exists at the target level.

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json