---
title: "ktm collections items"
description: "Learn how to use the ktm collections items command to list paginated tests and dashboards inside a specified collection."
sidebarTitle: "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 */}

List items (tests + dashboards) inside a collection

## Usage

```bash
ktm collections items <uid> [flags]
```

## Examples

```bash
ktm collections items --operator my-op 8294de2a-ecd9-4202-9169-7d55d1328e22
ktm collections items --operator my-op <uid> -o json | jq '.[].meta.name'
ktm collections items --operator my-op <uid> --page-size 10 --page 2
```

## Arguments

| Argument | Required |
| --- | --- |
| `uid` | Yes |

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--operator` | string |  | Operator slug (required) |
| `--page` | int |  | Page number |
| `--page-size` | int |  | Items per page (default: 25) |

## Details

Paginated list of items directly inside the collection (sub-collections
are NOT included — use 'ktm collections list' for those). Items are tests,
reusable_tests, or dashboards; human-readable name / status come from each
item's meta blob.

The platform defaults sort_by=updated_at order=desc when the
client doesn't specify; this matches the web UI.

## Related

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

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