---
title: "ktm collections"
description: "Manage the ktm collections command to organize tests and dashboards into a hierarchical tree using create, move, rename, and search subcommands."
sidebarTitle: "collections"
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 */}

Collections — hierarchical tree of tests and dashboards

## Usage

```bash
ktm collections [flags]
```

## Subcommands

<Columns cols={2}>
  <Card title="can-edit" icon="angle-right" href="/cli/commands/collections/can-edit">
    Check whether the current user can edit a collection
  </Card>
  <Card title="create" icon="angle-right" href="/cli/commands/collections/create">
    Create a new sub-collection under --parent
  </Card>
  <Card title="delete" icon="angle-right" href="/cli/commands/collections/delete">
    Move a collection to the organisation's trash (soft-delete)
  </Card>
  <Card title="get" icon="angle-right" href="/cli/commands/collections/get">
    Fetch a single collection with its breadcrumb path
  </Card>
  <Card title="items" icon="angle-right" href="/cli/commands/collections/items">
    List items (tests + dashboards) inside a collection
  </Card>
  <Card title="list" icon="angle-right" href="/cli/commands/collections/list">
    List sub-collections under a parent UID
  </Card>
  <Card title="move" icon="angle-right" href="/cli/commands/collections/move">
    Reparent a collection under a new parent UID
  </Card>
  <Card title="move-items" icon="angle-right" href="/cli/commands/collections/move-items">
    Move tests/dashboards into a target collection
  </Card>
  <Card title="rename" icon="angle-right" href="/cli/commands/collections/rename">
    Rename a collection
  </Card>
  <Card title="search" icon="angle-right" href="/cli/commands/collections/search">
    Search collections and items in a collection sub-tree
  </Card>
</Columns>

<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>