list_test_cases
Fetch test cases from a TestCollab project using filters for priority, suite, title, and more. Supports sorting and pagination for efficient test management.
Instructions
List test cases from a TestCollab project with optional filtering, sorting, and pagination. Tip: Call get_project_context first to resolve suite/tag/custom field names to IDs. Note: list_test_cases may omit full step details; use get_test_case for a complete test case with steps.
Filter fields include:
id, title, description, steps, priority (0=Low, 1=Normal, 2=High)
suite (ID or title), created_by, reviewer, poster (user IDs)
created_at, updated_at, last_run_on (dates)
tags, requirements (arrays of IDs or names)
under_review, is_automated (0 or 1)
run_count, avg_execution_time, failure_rate
Filter types:
text: equals, notEqual, contains, notContains, startsWith, endsWith, isBlank
number: equals, notEqual, greaterThan, greaterThanOrEqual, lessThan, lessThanOrEqual, inRange
date: equals, notEqual, greaterThan, lessThan, inRange
Example filter: { "priority": { "filterType": "number", "type": "greaterThanOrEqual", "filter": 1 }, "title": { "filterType": "text", "type": "contains", "filter": "login" } }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | No | Project ID (optional if TC_DEFAULT_PROJECT env var is set) | |
| suite | No | Filter by suite ID or title | |
| filter | No | Filter conditions object | |
| sort | No | Sort specification array, e.g. [{ colId: 'updated_at', sort: 'desc' }] | |
| limit | No | Maximum results to return (1-100, default: 50) | |
| offset | No | Number of results to skip (default: 0) |