Developer APIResourcesFolders

Update folder

Use this endpoint to update a folder name or move it to a different folder within your workspace. You can change the folder’s name and update its parent_id if the folder is not a project. If the folder is a project, you can only change the project name using this endpoint. NOTE: The folder name cannot include the forward or back slash characters.

Refer to the Update a project endpoint documentation for additional options in the request payload for projects.

NOTE: You can’t use this endpoint to convert a folder into a project or a project into a folder.

Path parameters

idstringRequired
The ID of the folder you plan to update.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
namestringOptional
Folder name.
parent_idintegerOptional
Parent folder ID.

Response

Success reply
idinteger or null
The unique identifier of the folder.
namestring or null
The name of the folder.
parent_idinteger or null
The unique identifier of the parent folder.
created_atstring or null
The timestamp when the folder was created.
updated_atstring or null
The timestamp when the folder was last updated.

Errors