---
title: "ktm test-campaigns"
description: "Manage ktm test-campaigns from the CLI to create, list, update, delete, and fetch saved test packs before running them."
sidebarTitle: "test-campaigns"
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 */}

Tests campaigns — named ordered packs of tests

## Usage

```bash
ktm test-campaigns [flags]
```

## Subcommands

<Columns cols={2}>
  <Card title="create" icon="angle-right" href="/cli/commands/test-campaigns/create">
    Create a new Tests campaign
  </Card>
  <Card title="creators" icon="angle-right" href="/cli/commands/test-campaigns/creators">
    List distinct Tests campaign creators (for filtering list)
  </Card>
  <Card title="delete" icon="angle-right" href="/cli/commands/test-campaigns/delete">
    Delete a Tests campaign (hard delete, no trash)
  </Card>
  <Card title="get" icon="angle-right" href="/cli/commands/test-campaigns/get">
    Fetch a single Tests campaign with its full test_list
  </Card>
  <Card title="list" icon="angle-right" href="/cli/commands/test-campaigns/list">
    List Tests campaigns
  </Card>
  <Card title="update" icon="angle-right" href="/cli/commands/test-campaigns/update">
    Partial-update a Tests campaign (PATCH)
  </Card>
</Columns>

## Details

Tests campaigns are persistent, named, ordered packs of tests scoped to a
single product (the entity the product UI calls a "Tests campaign").

A Tests campaign is the SAVED object you CRUD here. To RUN one, build a campaign
from it and pipe it to the runner:
  ktm ci build --test-campaign &lt;id&gt; [--variant "Group:Variant"] | ktm ci run --stdin

## Related

- [`ktm ci build`](/cli/commands/ci/build)
- [`ktm ci run`](/cli/commands/ci/run)

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