Switch Package Rules

The switch package process lets you move versions from one source package to a target package.

The following rules apply to the switch package process:

You can switch versions only to a package located in the same state as the source package.
All or some of the package versions can be switched to another package. For example, Package A has item1 (version 1), item2 (version 2), and you can switch item1 (version1) to a different package but still retain item2 (version2).
You can switch a branch version to a target package only if the target package does not contain any existing versions of the items being switched.
If you want to switch a trunk version, the target package cannot have a branch version of the same item.
Both the branch and the trunk versions must be switched together if the trunk version is a result of a merge from the branch.
If the target package has branch versions associated with it (even if those branch versions have been merged), the switch package will fail.
The target package cannot contain the parent path of a version being switched.