move_folder
Relocate a folder to a new parent folder or to the workspace root. Pass a folder_id for a new parent or workspace_id for the root.
Instructions
Move a folder into another folder, or up to a workspace root.
USE WHEN: Relocating a folder. Pass folder_id for a new parent folder, or workspace_id to move it to the workspace root — one or the other, not both.
USE INSTEAD: update_folder_name to rename in place. move_message_to_folder for a single message rather than a folder.
FIRST: id comes from get_root_folders (field results[].id) — call it first if you don't have one.
EXAMPLE: {"id":"folder-abc","folder_id":"folder-parent"}
RETURNS: The moved folder, same shape as get_folder.
ERROR BAD_REQUEST: Both folder_id and workspace_id were given, or neither, or the move would nest a folder inside itself. — Pass exactly one destination.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| folder_id | No | Folder ID | |
| workspace_id | No | Workspace ID |