search_workitems
Searches work items using advanced query expressions with complex filters.
Purpose
This tool performs advanced searches across work items in Engineering Workflow Management using complex filter expressions. Before using this tool, you must read the resource ccm://docs/search/guide to understand the required workflow, filter structure, and syntax. The tool supports filtering by attributes, states, owners, categories, releases, and custom fields using schema-based IDs.
Tags: CCM | Read | Advanced
Input parameters
| Parameter | Type | Required | Description | Default | Example |
|---|---|---|---|---|---|
| project_area_item_id | string | Yes | Project area item ID | - | _Apg8AERbEfGwZtG2EQx8cA |
| filter | string | Yes | JSON string with query expression using schema IDs | - | {"operator":"AND","attributeExpressions":[{"attributeId":"summary","operator":"contains","values":["login"],"variables":[]}],"termExpressions":[],"similarityExpressions":[]} |
| attributes | string | No | Comma-separated attributes to return | workItemType, id, summary, owner, internalState, internalPriority, internalSeverity, modified | id,summary,owner,internalState |
Output schema
| Field | Type | Description |
| totalCount | number | Total number of work items matching the query |
| resultCount | number | Number of work items returned in this response (max 100) |
| columns | array | Array of column names corresponding to requested attributes |
| workItems | array | Array of matching work items, where each inner array contains values matching the columns order |
Common use cases
- Finding work items by status or priority
- Searching for work items assigned to specific users
- Filtering work items by category or release
- Building custom work item reports
- Finding the work items planned for a particular iteration, in order to help with understanding the sprint progress and sprint accomplishments
- Release quality metrics by analyzing the defects found in a particular release