Reorder the folders
reorder_folders
Sets the order the folders of a workspace appear in on the dashboard.
Scopesites:writeMakes changes
Send every folder id in the order you want them. Each id you send takes its position from the list, while a folder you leave out keeps its old position and can end up tied with one you sent. Ids that do not belong to the workspace are ignored and the call still reports success, so call list_folders afterwards to confirm.
It needs the Edit folders permission in that workspace, and being a folder's creator is not enough. The built-in Archive is not a folder: it is not in list_folders and keeps its place in the sidebar. See Folders.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
workspaceId |
string | Yes | The workspace whose folders are being ordered. |
folderIds |
array of strings | Yes | Every folder id, in the order they should appear. An empty list is refused. |