List Test Cases
coval test-cases list [OPTIONS]
| Option | Type | Default | Description |
|---|
--filter | string | — | Filter expression |
--test-set-id | string | — | Filter by test set ID |
--page-size | number | 50 | Results per page |
--order-by | string | — | Sort order |
# List all test cases
coval test-cases list
# Filter by test set
coval test-cases list --test-set-id ts_abc123
Get Test Case
coval test-cases get <test_case_id>
| Argument | Type | Required | Description |
|---|
test_case_id | string | Yes | The test case ID |
coval test-cases get tc_abc123
Create Test Case
Create a single test case or bulk import from stdin.
coval test-cases create [OPTIONS]
| Option | Type | Required | Description |
|---|
--test-set-id | string | Yes | Test set to add the case to |
--input | string | No | Test case input text |
--expected | string | No | Expected output |
--description | string | No | Test case description |
--stdin | flag | No | Read test cases from stdin (JSON) |
You must provide exactly one of --input or --stdin. They are mutually exclusive — supplying both or neither will result in an error.
Single Test Case
coval test-cases create \
--test-set-id ts_abc123 \
--input "I need help with my order" \
--expected "Order assistance provided" \
--description "Basic order help request"
Bulk Import from Stdin
Pass --stdin to read one JSON object per line:
echo '{"input_str": "I need a refund", "expected_output_str": "Refund processed", "description": "Refund request"}
{"input_str": "Where is my order?", "expected_output_str": "Order status provided", "description": "Order tracking"}' \
| coval test-cases create --test-set-id ts_abc123 --stdin
cat test_cases.jsonl | coval test-cases create --test-set-id ts_abc123 --stdin
| Field | Type | Required | Description |
|---|
input_str | string | Yes | Input text |
expected_output_str | string | No | Expected output |
description | string | No | Description |
Update Test Case
coval test-cases update <test_case_id> [OPTIONS]
| Argument | Type | Required | Description |
|---|
test_case_id | string | Yes | The test case ID to update |
| Option | Type | Description |
|---|
--input | string | New input text |
--expected | string | New expected output |
--description | string | New description |
coval test-cases update tc_abc123 --input "Updated input text"
Delete Test Case
coval test-cases delete <test_case_id>
| Argument | Type | Required | Description |
|---|
test_case_id | string | Yes | The test case ID to delete |
