ktm tests list

List tests, optionally filtered by operator and product

Usage

ktm tests list [flags]

Examples

# List all tests for a product
ktm tests list --operator my-operator --product my-operator~my-product

# Search by name substring
ktm tests list --operator my-operator --name login

# Include archived tests
ktm tests list --operator my-operator --archived true

# Filter by tags
ktm tests list --operator my-operator --tags smoke,regression

# Paginate through results
ktm tests list --operator my-operator --page 2 --page-size 50

Flags

Flag	Type	Description
`--archived`	string	Include archived tests: true, false (default: false = non-archived only)
`--fields`	string	Restrict JSON response to these fields (comma-separated whitelist)
`--name`	string	Filter by test name (substring match, case-insensitive)
`--operator`	string	Operator slug (from 'operators list') to scope results
`--ordering`	string	Sort by field: name, created, modified (prefix with - for descending)
`--page`	string	Page number to fetch (default: 1)
`--page-size`	string	Number of results per page (default: 20; pass a larger value to fetch more)
`--product`	string	Product slug (from 'products list', format: operator~product) to scope results
`--tags`	string[]	Comma-separated list of tags to filter by (e.g., --tags smoke,regression)

Details

List test scenarios defined on the platform.

Tests belong to a product (which belongs to an operator). Use --operator and --product to narrow results. Non-archived tests are returned by default.

The test "id" can be used in CI config files to trigger execution via "ci run".

JSON output fields: id, name, product, owner, tags, archived, is_valid, status, kind, created, modified Table columns: ID, NAME, PRODUCT, STATUS, KIND, ARCHIVED

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.