query_work_items
Search and retrieve work items in Azure DevOps using Work Item Query Language (WIQL). Filter tasks, bugs, or issues by criteria, team members, or project attributes for dynamic reporting and efficient tracking.
Instructions
Searches for work items using Work Item Query Language (WIQL).
Use this tool when you need to:
- Find work items matching specific criteria
- Search across projects for related tasks or bugs
- Create dynamic reports based on work item attributes
- Identify work items assigned to specific team members
IMPORTANT: WIQL syntax is similar to SQL and allows you to query
work items based on their fields. The query must follow Azure DevOps
WIQL syntax rules, with proper SELECT, FROM, and WHERE clauses.
Args:
query: The WIQL query string (e.g., "SELECT * FROM workitems
WHERE [System.State] = 'Active'")
top: Maximum number of results to return (default: 30)
Returns:
Formatted string containing detailed information for each matching
work item, with all fields and values formatted as markdown
Input Schema
Name | Required | Description | Default |
---|---|---|---|
query | Yes | ||
top | No |
Input Schema (JSON Schema)
{
"properties": {
"query": {
"title": "Query",
"type": "string"
},
"top": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Top"
}
},
"required": [
"query"
],
"title": "query_work_itemsArguments",
"type": "object"
}