Update a folder

Use this endpoint to update a folder name or move it to a different folder within a customer 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.

Path parameters

managed_user_idstringRequired

Embedded customer ID (external ID). The External ID must be URL encoded and prefixed with an E. For example, EA2300.

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