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

FlagTypeDefaultDescription
--itemsstringComma-separated item UIDs (required)
--operatorstringOperator slug (required)
--targetstringDestination 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.

Global flags (--output, --debug, --host, …) apply to every command. See the command reference overview.

What's next?

All commands

Browse the full CLI reference.

Get started

Install the CLI and authenticate.

Last updated on