manage_search

Search Azure DevOps using WIQL queries, code search, work item text search, wiki search, or saved queries.

Actions

Action	Description	Required Params	Optional Params	Write
wiql	Execute a WIQL query and return full work items	query	project_key, fields, top	No
code	Search code across repositories	query	project_key, top	No
work_items	Search work items by text	query	project_key, top	No
wiki	Search wiki content	query	project_key, top	No
get_query	Get a saved query definition by ID or path	query_id	project_key	No
run_query	Run a saved query and return results	query_id	project_key, top	No

Parameters

Parameter	Type	Description
action	string	Required. The action to perform: wiql, code, work_items, wiki, get_query, run_query
query	string	WIQL query string (for wiql) or search text (for code, work_items, wiki)
query_id	string	Saved query ID or path (for get_query, run_query)
project_key	string	Project name (optional, scopes the search)
top	integer	Max results to return (default 25)
fields	string[]	Fields to return for WIQL results

Examples

WIQL query

{
  "action": "wiql",
  "query": "SELECT [System.Id], [System.Title], [System.State] FROM WorkItems WHERE [System.State] = 'Active' AND [System.WorkItemType] = 'Bug' ORDER BY [System.ChangedDate] DESC",
  "project_key": "MyProject",
  "top": 10
}

Code search

{
  "action": "code",
  "query": "func handleAuth",
  "project_key": "MyProject",
  "top": 25
}

Work item text search

{
  "action": "work_items",
  "query": "login redirect bug",
  "project_key": "MyProject"
}

Wiki search

{
  "action": "wiki",
  "query": "architecture diagram",
  "project_key": "MyProject"
}

Get a saved query definition

{
  "action": "get_query",
  "query_id": "My Saved Queries/Active Bugs",
  "project_key": "MyProject"
}

Run a saved query

{
  "action": "run_query",
  "query_id": "My Saved Queries/Active Bugs",
  "project_key": "MyProject",
  "top": 50
}