get_cases
Read-onlyIdempotent
Retrieve test cases for a project with filters by section, priority, type, or custom fields. Returns case IDs, titles, and any requested fields.
Instructions
Get all test cases for a project. Filter by section, API params (priority, type), or any field including custom fields via 'where'. Returns case IDs, titles, and any additional requested fields.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | The ID of the project. Use get_projects to find available projects | |
| section | No | Section filter configuration. Use get_sections to find available sections | |
| filter | No | Optional API-side filters (more efficient for large datasets). Supported: priority_id, type_id, created_by, updated_by, milestone_id, refs, created_after, created_before, updated_after, updated_before. Use comma-separated values for IDs. Example: {"priority_id": "1,2", "type_id": "3"} | |
| where | No | Optional client-side filter for any field including custom fields (filters after fetching all cases). Supports exact value matching. Example: {"custom_automation_status": 1, "priority_id": 2} | |
| fields | No | Additional fields to include in response beyond id, title, and suite_id. Use get_case_fields to see available fields. Example: ["priority_id", "type_id", "custom_automation_status"] | |
| output_file | No | Absolute file path to save the JSON response to. Use this for large datasets to avoid blowing up context limits. |