CLI Reference > Workflows and Documents Commands > im movecontent
 
im movecontent
moves content to a new location
Synopsis
im movecontent [--parentID=value] [--insertLocation[=number|first|last|before:name|after:name] [--[no]recurse] [--quiet] [--user=name] [--hostname=server] [--password=password] [--port=number] [(-?|--usage)] [(-F file|--selectionFile=file)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=directory] [--forceConfirm=[yes|no]] [-g|--gui] [--settingsUI=[gui|default]] [--status=[none|gui|default]] issue id...
Description
im movecontent moves the selected issue(s) from their current parent and adds them to a new parent. You can specify where you want to move the content to in the new parent's structural relationship list. For example:
im movecontent --parentID=23 --insertLocation=first 15 242 590
moves issues 15, 242 and 590 and inserts them in that order at the beginning of the structural relationship list for segment 23.
Options
This command takes the universal options available to all im commands, as well as some general options. See the options reference page for descriptions.
--[no]recurse=value
indicates whether to move all the issues in the moved issue's structural relationship list, or just move the selected issues. If only the selected issues are moved, the child issues are moved up to the removed issue's parent.
--insertLocation[=number|first|last|before:name|after:name]
determines where the moved issue should go in the new parent issue's structural relationship list. The options are as follows
first inserts the content at the beginning of the list
last inserts the content at the end of the list
before:name inserts the content before the specified ID
after:name inserts the content after the specified ID
[0,...] inserts the content at the specified location. If a negative is specified, the content is inserted at the beginning of the list. If the number specified is too large, the content is inserted at the end of the list.
--parentID=value
the ID of the segment that the content will be moved to. This option is required.
issue id...
specifies the ID of the issue(s) being copied. Use a space separated list to specify more than one issue ID, for example, 240 241 242.
See Also
Commands: im copycontent, im removecontent
Miscellaneous: diagnostics, options, preferences