Azure DevOps

Instructions d'utilisation

Integrate Azure DevOps into your workflow. List and inspect pipelines and builds, query and manage work items, and add or read comments.

Outils

`azure_devops_list_pipelines`

List all pipelines in an Azure DevOps project. Returns pipeline ID, name, folder, revision, and URL.

Entrée

Paramètre	Type	Obligatoire	Description
`organization`	string	Oui	Azure DevOps organization name
`project`	string	Oui	Azure DevOps project name
`orderBy`	string	Non	Field to sort results by (e.g. "name")
`top`	number	Non	Maximum number of pipelines to return
`continuationToken`	string	Non	Continuation token for paginating results

Sortie

Paramètre	Type	Description
`content`	string	Human-readable summary of pipelines
`metadata`	object	Pipelines metadata
↳ `count`	number	Total number of pipelines returned
↳ `pipelines`	array	Array of pipeline objects
↳ `id`	number	Pipeline ID
↳ `name`	string	Pipeline name
↳ `folder`	string	Folder path (e.g. "\\")
↳ `revision`	number	Pipeline revision number
↳ `url`	string	Pipeline API URL

`azure_devops_get_pipeline`

Get details for a specific pipeline in an Azure DevOps project, including configuration and repository info.

Entrée

Paramètre	Type	Obligatoire	Description
`organization`	string	Oui	Azure DevOps organization name
`project`	string	Oui	Azure DevOps project name
`pipelineId`	number	Oui	ID of the pipeline to retrieve
`pipelineVersion`	number	Non	Specific revision of the pipeline to retrieve (defaults to latest)

Sortie

Paramètre	Type	Description
`content`	string	Human-readable summary of the pipeline
`metadata`	object	Pipeline detail metadata
↳ `pipeline`	object	Full pipeline detail object
↳ `id`	number	Pipeline ID
↳ `name`	string	Pipeline name
↳ `folder`	string	Folder path
↳ `revision`	number	Pipeline revision number
↳ `url`	string	Pipeline API URL
↳ `configuration`	object	Pipeline configuration
↳ `type`	string	Configuration type (e.g. "yaml")
↳ `path`	string	YAML file path in the repository
↳ `repository`	object	Source repository info
↳ `id`	string	Repository ID
↳ `type`	string	Repository type (e.g. "azureReposGit")
↳ `links`	object	Hypermedia links
↳ `self`	string	API self-link
↳ `web`	string	Browser URL for the pipeline

`azure_devops_list_pipeline_runs`

List runs for a specific pipeline in an Azure DevOps project. Returns run ID, name, state, result, and timestamps.

Entrée

Paramètre	Type	Obligatoire	Description
`organization`	string	Oui	Azure DevOps organization name
`project`	string	Oui	Azure DevOps project name
`pipelineId`	number	Oui	ID of the pipeline whose runs to list

Sortie

Paramètre	Type	Description
`content`	string	Human-readable summary of pipeline runs
`metadata`	object	Pipeline runs metadata
↳ `count`	number	Total number of runs returned
↳ `runs`	array	Array of pipeline run objects
↳ `id`	number	Run ID
↳ `name`	string	Run name (e.g. "20210601.1")
↳ `state`	string	Run state (e.g. "completed", "inProgress")
↳ `result`	string	Run result (e.g. "succeeded", "failed") — absent if still running
↳ `createdDate`	string	ISO 8601 creation timestamp
↳ `finishedDate`	string	ISO 8601 finish timestamp — absent if still running
↳ `url`	string	Run API URL
↳ `webUrl`	string	Browser URL for the run

`azure_devops_get_pipeline_run`

Get details for a specific pipeline run in an Azure DevOps project. Returns run state, result, timestamps, and the pipeline reference.

Entrée

Paramètre	Type	Obligatoire	Description
`organization`	string	Oui	Azure DevOps organization name
`project`	string	Oui	Azure DevOps project name
`pipelineId`	number	Oui	ID of the pipeline
`runId`	number	Oui	ID of the run to retrieve

Sortie

Paramètre	Type	Description
`content`	string	Human-readable summary of the pipeline run
`metadata`	object	Pipeline run metadata
↳ `run`	object	Full pipeline run detail object
↳ `id`	number	Run ID
↳ `name`	string	Run name (e.g. "20210601.1")
↳ `state`	string	Run state (e.g. "completed", "inProgress")
↳ `result`	string	Run result (e.g. "succeeded", "failed") — absent if still running
↳ `createdDate`	string	ISO 8601 creation timestamp
↳ `finishedDate`	string	ISO 8601 finish timestamp — absent if still running
↳ `url`	string	Run API URL
↳ `webUrl`	string	Browser URL for the run
↳ `pipeline`	object	Pipeline reference
↳ `id`	number	Pipeline ID
↳ `name`	string	Pipeline name
↳ `folder`	string	Pipeline folder
↳ `revision`	number	Pipeline revision number
↳ `url`	string	Pipeline API URL

`azure_devops_list_builds`

List builds in an Azure DevOps project. Optionally filter by pipeline definition, status, result, or branch.

Entrée

Paramètre	Type	Obligatoire	Description
`organization`	string	Oui	Azure DevOps organization name
`project`	string	Oui	Azure DevOps project name
`definitionIds`	string	Non	Comma-separated pipeline definition IDs to filter by (e.g. "1,2,3")
`top`	number	Non	Maximum number of builds to return
`statusFilter`	string	Non	Filter by build status: inProgress, completed, cancelling, postponed, notStarted, none
`resultFilter`	string	Non	Filter by build result: succeeded, partiallySucceeded, failed, canceled
`branchName`	string	Non	Filter by source branch name (e.g. "refs/heads/main")

Sortie

Paramètre	Type	Description
`content`	string	Human-readable summary of builds
`metadata`	object	Builds metadata
↳ `count`	number	Total number of builds returned
↳ `builds`	array	Array of build objects
↳ `id`	number	Build ID
↳ `buildNumber`	string	Build number (e.g. "20210601.1")
↳ `status`	string	Build status (e.g. "completed", "inProgress")
↳ `result`	string	Build result (e.g. "succeeded", "failed") — absent if still running
↳ `queueTime`	string	ISO 8601 queue timestamp
↳ `startTime`	string	ISO 8601 start timestamp
↳ `finishTime`	string	ISO 8601 finish timestamp — absent if still running
↳ `sourceBranch`	string	Source branch (e.g. "refs/heads/main")
↳ `sourceVersion`	string	Source commit SHA
↳ `definition`	object	Pipeline definition reference
↳ `id`	number	Definition ID
↳ `name`	string	Definition name
↳ `webUrl`	string	Browser URL for the build

`azure_devops_list_build_logs`

List all log entries for a specific build in Azure DevOps. Returns log IDs, types, and line counts — use the log ID with the Get Build Log tool to fetch actual log text.

Entrée

Paramètre	Type	Obligatoire	Description
`organization`	string	Oui	Azure DevOps organization name
`project`	string	Oui	Azure DevOps project name
`buildId`	number	Oui	The build ID whose logs to list

Sortie

Paramètre	Type	Description
`content`	string	Human-readable summary of build logs
`metadata`	object	Build logs metadata
↳ `count`	number	Total number of log entries returned
↳ `logs`	array	Array of log entry objects
↳ `id`	number	Log entry ID — use with Get Build Log to fetch content
↳ `type`	string	Log type (e.g. "Container", "Task", "Section")
↳ `url`	string	API URL for the log entry
↳ `lineCount`	number	Number of lines in the log
↳ `createdOn`	string	ISO 8601 creation timestamp
↳ `lastChangedOn`	string	ISO 8601 last-changed timestamp

`azure_devops_get_build_log`

Fetch the text content of a specific build log in Azure DevOps. Use List Build Logs first to get the log ID. Optionally retrieve only a line range with startLine/endLine.

Entrée

Paramètre	Type	Obligatoire	Description
`organization`	string	Oui	Azure DevOps organization name
`project`	string	Oui	Azure DevOps project name
`buildId`	number	Oui	The build ID containing the log
`logId`	number	Oui	The log entry ID to fetch (from List Build Logs)
`startLine`	number	Non	First line to return (1-based, inclusive)
`endLine`	number	Non	Last line to return (1-based, inclusive)

Sortie

Paramètre	Type	Description
`content`	string	Raw log text
`metadata`	object	Log metadata
↳ `lineCount`	number	Number of lines in the returned log text

`azure_devops_get_build_timeline`

Get the execution timeline for an Azure DevOps build — every stage, job, and task with its result and log ID. Use this to identify which steps failed before fetching their logs with Get Build Log.

Entrée

Paramètre	Type	Obligatoire	Description
`organization`	string	Oui	Azure DevOps organization name
`project`	string	Oui	Azure DevOps project name
`buildId`	number	Oui	ID of the build whose timeline to retrieve

Sortie

Paramètre	Type	Description
`content`	string	Summary of the build timeline, highlighting failed steps
`metadata`	object	Build timeline metadata
↳ `totalCount`	number	Total number of timeline records
↳ `failedCount`	number	Number of failed records
↳ `records`	array	All timeline records (stages, jobs, tasks)
↳ `id`	string	Record GUID
↳ `name`	string	Step name (e.g. "Run tests")
↳ `type`	string	Stage \| Phase \| Job \| Task
↳ `result`	string	succeeded \| failed \| skipped \| canceled \| null
↳ `logId`	number	Log ID to pass to Get Build Log, or null
↳ `errorCount`	number	Number of errors
↳ `warningCount`	number	Number of warnings
↳ `startTime`	string	ISO 8601 start timestamp
↳ `finishTime`	string	ISO 8601 finish timestamp
↳ `failedRecords`	array	Subset of records where result is failed, partiallySucceeded, or succeededWithIssues — use logId to fetch logs
↳ `id`	string	Record GUID
↳ `name`	string	Step name
↳ `type`	string	Stage \| Phase \| Job \| Task
↳ `result`	string	failed
↳ `logId`	number	Log ID to pass to Get Build Log
↳ `errorCount`	number	Number of errors
↳ `warningCount`	number	Number of warnings
↳ `startTime`	string	ISO 8601 start timestamp
↳ `finishTime`	string	ISO 8601 finish timestamp

`azure_devops_get_work_items_between_builds`

Get work item references associated with commits between two builds in Azure DevOps. Returns work item IDs and URLs — use Get Work Items Batch for full field details.

Entrée

Paramètre	Type	Obligatoire	Description
`organization`	string	Oui	Azure DevOps organization name
`project`	string	Oui	Azure DevOps project name
`fromBuildId`	number	Oui	The older build ID (start of range)
`toBuildId`	number	Oui	The newer build ID (end of range)

Sortie

Paramètre	Type	Description
`content`	string	Human-readable summary of work items between builds
`metadata`	object	Work items metadata
↳ `count`	number	Total number of work item references returned
↳ `workItems`	array	Array of work item references
↳ `id`	string	Work item ID
↳ `url`	string	API URL for the work item

`azure_devops_query_work_items`

Execute a WIQL query to search for work items in Azure DevOps and return full field details. Use TOP N in your query to limit results (Azure enforces a 200-item maximum per batch fetch).

Entrée

Paramètre	Type	Obligatoire	Description
`organization`	string	Oui	Azure DevOps organization name
`project`	string	Oui	Azure DevOps project name
`wiqlQuery`	string	Oui	WIQL query string (e.g. "SELECT [System.Id] FROM workitems WHERE [System.State] = 'Doing' ORDER BY [System.Id] ASC"). Use TOP N to limit results.

Sortie

Paramètre	Type	Description
`content`	string	Human-readable summary of matching work items
`metadata`	object	Work items metadata
↳ `count`	number	Number of work items returned (after hydration)
↳ `totalMatched`	number	Total number of work items matched by the WIQL query before hydration
↳ `workItems`	array	Array of work item details
↳ `id`	number	Work item ID
↳ `title`	string	Work item title
↳ `state`	string	Current state for Basic process (e.g. To Do, Doing, Done)
↳ `workItemType`	string	Work item type returned by Azure DevOps (e.g. Issue, Task, Epic)
↳ `assignedTo`	string	Display name of assigned user, or null if unassigned
↳ `areaPath`	string	Area path of the work item
↳ `url`	string	API URL for the work item

`azure_devops_get_work_item`

Fetch full details of a single work item by ID from Azure DevOps, including title, state, type, assignee, and area path.

Entrée

Paramètre	Type	Obligatoire	Description
`organization`	string	Oui	Azure DevOps organization name
`project`	string	Oui	Azure DevOps project name
`workItemId`	number	Oui	The work item ID to fetch

Sortie

Paramètre	Type	Description
`content`	string	Human-readable summary of the work item
`metadata`	object	Work item metadata
↳ `workItem`	object	Full work item details
↳ `id`	number	Work item ID
↳ `title`	string	Work item title
↳ `state`	string	Current state for Basic process (e.g. To Do, Doing, Done)
↳ `workItemType`	string	Work item type returned by Azure DevOps (e.g. Issue, Task, Epic)
↳ `assignedTo`	string	Display name of assigned user, or null if unassigned
↳ `areaPath`	string	Area path of the work item
↳ `url`	string	API URL for the work item

`azure_devops_get_work_items_batch`

Fetch full details for multiple work items by ID from Azure DevOps. Pass comma-separated IDs (e.g.

Entrée

Paramètre	Type	Obligatoire	Description
`organization`	string	Oui	Azure DevOps organization name
`project`	string	Oui	Azure DevOps project name
`ids`	string	Oui	Comma-separated work item IDs to fetch (e.g. "123,456,789"). Lists longer than 200 IDs are chunked automatically.

Sortie

Paramètre	Type	Description
`content`	string	Human-readable summary of the fetched work items
`metadata`	object	Work items metadata
↳ `count`	number	Number of work items returned
↳ `totalRequested`	number	Total number of IDs requested (across all chunks)
↳ `workItems`	array	Array of work item details
↳ `id`	number	Work item ID
↳ `title`	string	Work item title
↳ `state`	string	Current state for Basic process (e.g. To Do, Doing, Done)
↳ `workItemType`	string	Work item type returned by Azure DevOps (e.g. Issue, Task, Epic)
↳ `assignedTo`	string	Display name of assigned user, or null if unassigned
↳ `areaPath`	string	Area path of the work item
↳ `url`	string	API URL for the work item

`azure_devops_create_work_item`

Create a new Basic-process work item (Issue, Task, or Epic) in Azure DevOps. Returns the created work item with its assigned ID.

Entrée

Paramètre	Type	Obligatoire	Description
`organization`	string	Oui	Azure DevOps organization name
`project`	string	Oui	Azure DevOps project name
`workItemType`	string	Oui	Basic-process work item type to create ("Issue", "Task", or "Epic"). Use Issue for bug or defect tracking.
`title`	string	Oui	Title of the new work item
`description`	string	Non	HTML description of the work item (optional)
`assignedTo`	string	Non	Email or display name of the user to assign the work item to (optional)
`priority`	number	Non	Priority of the work item (1 = Critical, 2 = High, 3 = Medium, 4 = Low)
`effort`	number	Non	Effort (Microsoft.VSTS.Scheduling.Effort). Basic process: Issue only.
`startDate`	string	Non	Start date (Microsoft.VSTS.Scheduling.StartDate), ISO 8601. Basic process: Epic only.
`targetDate`	string	Non	Target date (Microsoft.VSTS.Scheduling.TargetDate), ISO 8601. Basic process: Epic only.
`activity`	string	Non	Activity (Microsoft.VSTS.Common.Activity). One of Deployment, Design, Development, Documentation, Requirements, Testing. Basic process: Task only.
`remainingWork`	number	Non	Remaining work hours (Microsoft.VSTS.Scheduling.RemainingWork). Basic process: Task only.
`completedWork`	number	Non	Completed work hours (Microsoft.VSTS.Scheduling.CompletedWork). Basic process: Task only.
`areaPath`	string	Non	Area path for the work item, e.g. "MyProject\\Team" (optional)
`iterationPath`	string	Non	Iteration path for the work item, e.g. "MyProject\\Sprint 1" (optional)
`tags`	string	Non	Semicolon-separated tags, e.g. "issue; p1; auth" (optional)

Sortie

Paramètre	Type	Description
`content`	string	Human-readable summary of the created work item
`metadata`	object	Created work item metadata
↳ `workItem`	object	Full details of the created work item
↳ `id`	number	Assigned work item ID
↳ `title`	string	Work item title
↳ `state`	string	Initial state for Basic process (e.g. To Do, Doing, Done)
↳ `workItemType`	string	Work item type returned by Azure DevOps (e.g. Issue, Task, Epic)
↳ `assignedTo`	string	Display name of assigned user, or null if unassigned
↳ `areaPath`	string	Area path of the work item
↳ `url`	string	API URL for the created work item

`azure_devops_update_work_item`

Update one or more fields on an existing work item in Azure DevOps. Provide only the fields you want to change.

Entrée

Paramètre	Type	Obligatoire	Description
`organization`	string	Oui	Azure DevOps organization name
`project`	string	Oui	Azure DevOps project name
`workItemId`	number	Oui	ID of the work item to update
`title`	string	Non	New title for the work item (optional)
`description`	string	Non	New HTML description for the work item (optional)
`assignedTo`	string	Non	Email or display name to reassign the work item to (optional)
`areaPath`	string	Non	New area path for the work item (optional)
`priority`	number	Non	Priority of the work item (1 = Critical, 2 = High, 3 = Medium, 4 = Low) (optional)
`state`	string	Non	New state for Basic-process work items: "To Do", "Doing", or "Done" (optional)
`effort`	number	Non	Effort (Microsoft.VSTS.Scheduling.Effort). Basic process: Issue only.
`startDate`	string	Non	Start date (Microsoft.VSTS.Scheduling.StartDate), ISO 8601. Basic process: Epic only.
`targetDate`	string	Non	Target date (Microsoft.VSTS.Scheduling.TargetDate), ISO 8601. Basic process: Epic only.
`activity`	string	Non	Activity (Microsoft.VSTS.Common.Activity). One of Deployment, Design, Development, Documentation, Requirements, Testing. Basic process: Task only.
`remainingWork`	number	Non	Remaining work hours (Microsoft.VSTS.Scheduling.RemainingWork). Basic process: Task only.
`completedWork`	number	Non	Completed work hours (Microsoft.VSTS.Scheduling.CompletedWork). Basic process: Task only.
`tags`	string	Non	Semicolon-separated tags to set on the work item (optional)

Sortie

Paramètre	Type	Description
`content`	string	Human-readable summary of the updated work item
`metadata`	object	Updated work item metadata
↳ `workItem`	object	Full details of the updated work item
↳ `id`	number	Work item ID
↳ `title`	string	Work item title
↳ `state`	string	Current state after update
↳ `workItemType`	string	Work item type returned by Azure DevOps (e.g. Issue, Task, Epic)
↳ `assignedTo`	string	Display name of assigned user, or null if unassigned
↳ `areaPath`	string	Area path of the work item
↳ `url`	string	API URL for the work item

`azure_devops_add_comment`

Add a comment to a work item in Azure DevOps.

Entrée

Paramètre	Type	Obligatoire	Description
`organization`	string	Oui	Azure DevOps organization name
`project`	string	Oui	Azure DevOps project name
`workItemId`	number	Oui	ID of the work item to comment on
`text`	string	Oui	Comment text (HTML supported, e.g. "<p>My comment</p>")

Sortie

Paramètre	Type	Description
`content`	string	Human-readable confirmation of the added comment
`metadata`	object	Added comment metadata
↳ `comment`	object	Full details of the created comment
↳ `workItemId`	number	Work item the comment belongs to
↳ `commentId`	number	Comment ID
↳ `version`	number	Comment version
↳ `text`	string	Comment text
↳ `renderedText`	string	Rendered HTML comment text when available
↳ `createdBy`	string	Display name of the comment author, or null
↳ `createdDate`	string	ISO timestamp when comment was created
↳ `modifiedBy`	string	Display name of the last modifier, or null
↳ `modifiedDate`	string	ISO timestamp when comment was modified
↳ `isDeleted`	boolean	Whether the comment is deleted
↳ `url`	string	API URL for the comment

`azure_devops_get_comments`

List comments for an Azure DevOps work item.

Entrée

Paramètre	Type	Obligatoire	Description
`organization`	string	Oui	Azure DevOps organization name
`project`	string	Oui	Azure DevOps project name
`workItemId`	number	Oui	ID of the work item whose comments should be listed
`top`	number	Non	Maximum number of comments to return
`continuationToken`	string	Non	Continuation token for paginating comments
`includeDeleted`	boolean	Non	Whether deleted comments should be returned
`expand`	string	Non	Additional comment data to include: none, reactions, renderedText, renderedTextOnly, all
`order`	string	Non	Sort order for comments: asc or desc

Sortie

Paramètre	Type	Description
`content`	string	Human-readable summary of work item comments
`metadata`	object	Comments metadata
↳ `count`	number	Number of comments returned in this page
↳ `totalCount`	number	Total number of comments on the work item
↳ `continuationToken`	string	Continuation token for the next page
↳ `nextPage`	string	API URL for the next page
↳ `url`	string	API URL for this comments list
↳ `comments`	array	Array of work item comments
↳ `workItemId`	number	Work item ID
↳ `commentId`	number	Comment ID
↳ `version`	number	Comment version
↳ `text`	string	Comment text
↳ `renderedText`	string	Rendered HTML comment text when available
↳ `createdBy`	string	Display name of the comment author
↳ `createdDate`	string	ISO 8601 creation timestamp
↳ `modifiedBy`	string	Display name of the last modifier
↳ `modifiedDate`	string	ISO 8601 modified timestamp
↳ `isDeleted`	boolean	Whether the comment is deleted
↳ `url`	string	API URL for the comment

Azure DevOps

On this page