search_work_items
Search for work items across Azure DevOps projects using filters, sorting, and faceting for precise results.
Instructions
Search for work items across projects in Azure DevOps
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filters | No | Optional filters to narrow search results | |
| includeFacets | No | Whether to include faceting in results (default: true) | |
| orderBy | No | Options for sorting search results | |
| projectId | Yes | The ID or name of the project to search in | |
| searchText | Yes | The text to search for in work items | |
| skip | No | Number of results to skip for pagination (default: 0) | |
| top | No | Number of results to return (default: 100, max: 1000) |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"filters": {
"additionalProperties": false,
"description": "Optional filters to narrow search results",
"properties": {
"System.AreaPath": {
"description": "Filter by area paths",
"items": {
"type": "string"
},
"type": "array"
},
"System.AssignedTo": {
"description": "Filter by assigned users",
"items": {
"type": "string"
},
"type": "array"
},
"System.State": {
"description": "Filter by work item states (New, Active, Closed, etc.)",
"items": {
"type": "string"
},
"type": "array"
},
"System.TeamProject": {
"description": "Filter by project names",
"items": {
"type": "string"
},
"type": "array"
},
"System.WorkItemType": {
"description": "Filter by work item types (Bug, Task, User Story, etc.)",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"includeFacets": {
"default": true,
"description": "Whether to include faceting in results (default: true)",
"type": "boolean"
},
"orderBy": {
"description": "Options for sorting search results",
"items": {
"additionalProperties": false,
"properties": {
"field": {
"description": "Field to sort by",
"type": "string"
},
"sortOrder": {
"description": "Sort order (ASC/DESC)",
"enum": [
"ASC",
"DESC"
],
"type": "string"
}
},
"required": [
"field",
"sortOrder"
],
"type": "object"
},
"type": "array"
},
"projectId": {
"description": "The ID or name of the project to search in",
"type": "string"
},
"searchText": {
"description": "The text to search for in work items",
"type": "string"
},
"skip": {
"default": 0,
"description": "Number of results to skip for pagination (default: 0)",
"minimum": 0,
"type": "integer"
},
"top": {
"default": 100,
"description": "Number of results to return (default: 100, max: 1000)",
"maximum": 1000,
"minimum": 1,
"type": "integer"
}
},
"required": [
"searchText",
"projectId"
],
"type": "object"
}