get_test_cases_advanced
Retrieve test cases from Zebrunner with advanced filtering options including automation state, date ranges, and suite hierarchy for precise test management.
Instructions
📊 Advanced test case retrieval with filtering and pagination (✨ Enhanced with automation state and date filtering) ⚠️ IMPORTANT: Use 'suite_id' for direct parent suites, 'root_suite_id' for root suites that contain sub-suites. 💡 TIP: Use 'get_test_cases_by_suite_smart' for automatic suite type detection!
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| automation_states | No | Filter by automation state(s). Can be: single name ('Not Automated'), single ID (10), array of names (['Not Automated', 'To Be Automated']), array of IDs ([10, 12]), or mixed array (['Not Automated', 12]) | |
| created_after | No | Filter test cases created after this date (ISO format: '2024-01-01' or '2024-01-01T10:00:00Z') | |
| created_before | No | Filter test cases created before this date (ISO format: '2024-12-31' or '2024-12-31T23:59:59Z') | |
| format | No | Output format | json |
| include_clickable_links | No | Include clickable links to Zebrunner web UI | |
| include_steps | No | Include detailed test steps | |
| modified_after | No | Filter test cases modified after this date (ISO format: '2024-01-01' or '2024-01-01T10:00:00Z') | |
| modified_before | No | Filter test cases modified before this date (ISO format: '2024-12-31' or '2024-12-31T23:59:59Z') | |
| page | No | Page number (0-based) | |
| project_key | Yes | Project key | |
| root_suite_id | No | Filter by root suite ID (includes all sub-suites) | |
| size | No | Page size (configurable via MAX_PAGE_SIZE env var) | |
| suite_id | No | Filter by direct parent suite ID (for child suites) |
Input Schema (JSON Schema)
{
"properties": {
"automation_states": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"items": {
"type": [
"string",
"number"
]
},
"type": "array"
}
],
"description": "Filter by automation state(s). Can be: single name ('Not Automated'), single ID (10), array of names (['Not Automated', 'To Be Automated']), array of IDs ([10, 12]), or mixed array (['Not Automated', 12])"
},
"created_after": {
"description": "Filter test cases created after this date (ISO format: '2024-01-01' or '2024-01-01T10:00:00Z')",
"type": "string"
},
"created_before": {
"description": "Filter test cases created before this date (ISO format: '2024-12-31' or '2024-12-31T23:59:59Z')",
"type": "string"
},
"format": {
"default": "json",
"description": "Output format",
"enum": [
"dto",
"json",
"string",
"markdown"
],
"type": "string"
},
"include_clickable_links": {
"default": false,
"description": "Include clickable links to Zebrunner web UI",
"type": "boolean"
},
"include_steps": {
"default": false,
"description": "Include detailed test steps",
"type": "boolean"
},
"modified_after": {
"description": "Filter test cases modified after this date (ISO format: '2024-01-01' or '2024-01-01T10:00:00Z')",
"type": "string"
},
"modified_before": {
"description": "Filter test cases modified before this date (ISO format: '2024-12-31' or '2024-12-31T23:59:59Z')",
"type": "string"
},
"page": {
"default": 0,
"description": "Page number (0-based)",
"minimum": 0,
"type": "integer"
},
"project_key": {
"description": "Project key",
"minLength": 1,
"type": "string"
},
"root_suite_id": {
"description": "Filter by root suite ID (includes all sub-suites)",
"exclusiveMinimum": 0,
"type": "integer"
},
"size": {
"default": 10,
"description": "Page size (configurable via MAX_PAGE_SIZE env var)",
"exclusiveMinimum": 0,
"maximum": 100,
"type": "integer"
},
"suite_id": {
"description": "Filter by direct parent suite ID (for child suites)",
"exclusiveMinimum": 0,
"type": "integer"
}
},
"required": [
"project_key"
],
"type": "object"
}