ktm collections move-items
Learn how to use the ktm collections move-items command to atomically relocate tests or dashboards into a target collection via the CLI.
Move tests/dashboards into a target collection
Usage
ktm collections move-items [flags]
Examples
# Discover item UIDs under the source collection, then move one into another.
ktm collections items --operator my-op <src_uid> -o json | jq -r '.[0].uid'
ktm collections move-items --operator my-op --target <dst_uid> --items "<item_uid>"
# Batch move
ktm collections move-items --operator my-op --target <dst_uid> --items "<uid1>,<uid2>,<uid3>"
Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--items | string | Comma-separated item UIDs (required) | |
--operator | string | Operator slug (required) | |
--target | string | Destination collection UID (required) |
Details
Relocate items between collections in a single call. --items takes a comma-separated list of collection item UIDs (NOT the numeric test id; use 'ktm collections items <src_uid>' to discover the UIDs). Every listed item is moved into --target atomically.
Related
Global flags (--output, --debug, --host, …) apply to every command. See the command reference overview.
What's next?
Last updated on