Use this tool to reposition or reorganize a board, folder, or overview within monday.com. You can move an object into a different folder, to a different workspace, or to a specific position relative to another object. This tool is the primary way to restructure your workspace layout without modifying the content of the objects themselves.

Note: To move an object into a folder, provide parentFolderId. To move it to a workspace root, omit parentFolderId. To move it to a different workspace entirely, provide workspaceId. Positioning parameters (position_object_id and position_object_type) must always be provided together.

Parameters

Parameter	Type	Required	Description
objectType	`string`	Yes	The type of object to move. One of: `Board`, `Folder`, `Overview`.
id	`string`	Yes	The ID of the object to move.
parentFolderId	`string`	No	The ID of the destination folder. Provide this to move the object into a specific folder.
workspaceId	`string`	No	The ID of the destination workspace. Provide this when moving the object to a different workspace.
accountProductId	`string`	No	The ID of the destination account product. Provide this when moving to a different account product context.
position_object_id	`string`	No	The ID of a reference object to position this object relative to. Must be paired with `position_object_type`.
position_object_type	`string`	No	The type of the reference object for positioning. One of: `Board`, `Folder`, `Overview`. Must be paired with `position_object_id`.
position_is_after	`boolean`	No	If `true`, places this object after the reference object. If `false`, places it before.

Example

Move folder 20393953 into parent folder 19175809:

{
  "objectType": "Folder",
  "id": "20393953",
  "parentFolderId": "19175809"
}

When tested, this returned: Object moved with object_id: 20393953. The folder appeared nested inside folder 19175809 immediately after the operation.

To instead position a board after another board in the same folder:

{
  "objectType": "Board",
  "id": "18394529013",
  "position_object_id": "18406574366",
  "position_object_type": "Board",
  "position_is_after": true
}

Programmatic equivalent

Use the GraphQL API to achieve the same result. For moving a board to a folder:

mutation {
  move_to_folder(
    board_id: 20393953
    folder_id: 19175809
  ) {
    id
  }
}

For moving a board between workspaces, use update_board:

mutation {
  update_board(
    board_id: 18394529013
    board_attribute: workspace_id
    new_value: "12406666"
  )
}

For full documentation, see Folders.