Search artifacts (qTest Query Language)
qtest_searchSearch artifacts in a qTest project by artifact type using qTest Query Language (QQL) for precise filtering.
Instructions
Search a project's artifacts using qTest Query Language (QQL). Example queries: "Name ~ 'login'", "Status = 'Approved'", "'Automation' = 'Yes' and Priority = 'High'". Specify the artifact type to search.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>",
"objectType": "<objectType>",
"query": "<query>"
},
"name": "qtest_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | qTest Query Language (QQL) expression. | |
| fields | No | Fields to return. Defaults to ['*'] (all). | |
| maxItems | No | Maximum results to return (default 100). | |
| projectId | Yes | Numeric project ID. | |
| objectType | Yes | Artifact type to search. |