Search Test Cases
search_test_casesSearch for test cases using simple name/tag queries or advanced AQL filters to find matching test cases quickly.
Instructions
Search for test cases by name, tag, or AQL query.
Find test cases matching your search criteria. Supports simple name/tag search or advanced AQL (Allure Query Language) for complex filtering.
Simple Query Syntax (use 'query' parameter):
Plain text: Searches in test case names (case-insensitive)
tag:value: Filters by exact tag match
Combined: "login tag:smoke" finds test cases with "login" in name AND "smoke" tag
Important: see https://docs.qameta.io/allure-testops/advanced/aql/ for the full AQL syntax reference. AQL Syntax (use 'aql' parameter):
Operators: and, or, not
Precedence: and binds tighter than or; use parentheses to group
Strings are double-quoted; numbers are unquoted; booleans are true/false
Comparison operators: =, !=, ~= (contains), in, not in
Field examples: status, tag, name, createdBy, automated, layer
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| aql | No | Raw AQL (Allure Query Language) for complex searches. Important: see https://docs.qameta.io/allure-testops/advanced/aql/ for the full AQL syntax reference.Supports AND, OR, NOT operators, parentheses for grouping, and field filters. Strings must be double-quoted. Examples: - 'status="failed" and tag="regression"' - '(createdBy = "John" or createdBy = "Jane") and name ~= "test"' - 'tag in ["smoke", "e2e"] and automated = true' - 'not status = "Draft" and layer = "API"' | |
| page | No | Zero-based page index. | |
| size | No | Number of results per page (max 100). | |
| query | No | Simple search query. Examples: 'login flow', 'tag:smoke', 'tag:smoke tag:regression', 'authentication tag:security'. Ignored when 'aql' is provided. | |
| project_id | No | Allure TestOps project ID to list test cases from. | |
| output_format | No | Output format: 'json' (default) or 'plain'. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | Zero-based result page. | |
| size | Yes | Requested page size. | |
| items | Yes | Matching test cases. | |
| query | Yes | Query that produced these results. | |
| total | Yes | Total matching test cases. | |
| total_pages | Yes | Number of result pages. |