---
title: "ktm collections move-items"
description: "Learn how to use the ktm collections move-items command to atomically relocate tests or dashboards into a target collection via the CLI."
sidebarTitle: "move-items"
lastUpdated: "2026-09-23"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

{/* GENERATED FILE: do not edit by hand. Regenerate with: node scripts/generate.mjs */}

Move tests/dashboards into a target collection

## Usage

```bash
ktm collections move-items [flags]
```

## Examples

```bash
# 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 &lt;src_uid&gt;' to discover the UIDs). Every listed item
is moved into --target atomically.

## Related

- [`ktm collections`](/cli/commands/collections)
- [`ktm collections items`](/cli/commands/collections/items)

<Note>
  Global flags (`--output`, `--debug`, `--host`, …) apply to every command. See the [command reference overview](/cli/commands/overview).
</Note>

## What's next?

<Columns cols={2}>
  <Card title="All commands" icon="terminal" href="/cli/commands/overview">
    Browse the full CLI reference.
  </Card>
  <Card title="Get started" icon="rocket" href="/cli/getting-started">
    Install the CLI and authenticate.
  </Card>
</Columns>