search_test_runs
Find test runs in Zephyr Scale by project key, folder path, or folder ID. Filter results with optional fields and max results.
Instructions
Search for test runs using a query. Supports filtering by projectKey and/or folder path. On Cloud, only returns cycles in the exact folder (not sub-folders). Use folder_id for direct numeric ID lookup (skips path resolution).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fields | No | Comma-separated list of fields to include in the response (optional, e.g., "key,name,status,folder"). If not set, all fields are returned. | |
| folder | No | Folder path to filter test runs by (e.g., "/MyFolder/SubFolder"). Resolved to a numeric folderId on Cloud. | |
| folder_id | No | Numeric folder ID to filter test runs by (optional). If provided, takes precedence over folder path and skips path resolution. Use this when you already know the folder ID. | |
| max_results | No | Maximum number of results to return (optional, default 200) | |
| project_key | No | Project key to filter by (e.g., "PROJ"). Can be a single key or omitted if using folder only. |