Update Workspace Folder
PATCH/api/v1/workspaces/{workspaceId}/folders/{folderId}
Update a folder's properties including name, description, color, parent (move), starred status, or trash status. Requires EDITOR role or higher.
Headers
AuthorizationstringRequired
Bearer token for authentication
Content-TypestringRequired
application/json
Path Parameters
workspaceIdstringRequired
The unique identifier of the workspace
folderIdstringRequired
The unique identifier of the folder to update
Body
namestringOptional
New folder name (max 255 characters)
descriptionstringOptional
New folder description (null to clear)
colorstringOptional
New folder color (hex code, null to clear)
parentIdstringOptional
Move folder to new parent (null for root level)
isStarredbooleanOptional
Star or unstar the folder
isTrashedbooleanOptional
Move to trash (true) or restore from trash (false)
PATCH/api/v1/workspaces/{workspaceId}/folders/{folderId}
Response