alm_search
Execute HPQL search across ALM entities such as defects, tests, and requirements. Apply filters and specify return fields.
Instructions
Generic HPQL search across any ALM entity collection.
Use this for advanced queries not covered by the specific tools above.
Args: entity_type: ALM entity collection — e.g. 'defects', 'tests', 'requirements', 'test-sets', 'test-instances', 'runs', 'test-folders'. query: HPQL filter string (without braces). Examples: "status[Open];severity[4-Very High]" "name[login]" "owner[jsmith];creation-time[> '2026-01-01']" "owner[u1197976];parent-id[2400]" ← filter tests by folder + owner Leave empty to return all entities up to page_size. NOTE: For 'tests', use 'parent-id' to filter by folder — there is no 'subject' field. Combining 'parent-id' with multiple OR values (e.g. parent-id[1|2|3]) may cause HTTP 500 on some ALM servers; query each folder separately in that case. fields: Comma-separated ALM field names to include in the response. Example: 'id,name,status,owner,creation-time' For 'tests': valid fields include id,name,status,owner,parent-id, creation-time,subtype-id,description. 'subject' is NOT a valid field. page_size: Maximum records to return (default 100).
Returns: {"entity_type", "results": [...], "count": }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| entity_type | Yes | ||
| query | No | ||
| fields | No | id,name | |
| page_size | No |