Use Azure DevOps to inspect pipelines and run history, retrieve build timelines and logs, and manage work items and comments.

• Compare work items between builds to prepare release notes or investigate a regression.
• Run WIQL queries to return hydrated work item fields, rather than IDs alone.
• Create or update work items with titles, descriptions, priority, assignees, area paths, iterations, tags, effort, and dates.
• Start workflows from service hooks when builds fail or work items are created.

Use the block

List and inspect pipelines and builds, query and manage work items, and add or read comments.

Actions

Azure DevOps List Pipelines

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

Inputs and outputs

Input

Parameter	Type	Required	Description
organization	string	Yes	Azure DevOps organization name
project	string	Yes	Azure DevOps project name
orderBy	string	No	Field to sort results by (e.g. "name")
top	number	No	Maximum number of pipelines to return
continuationToken	string	No	Continuation token for paginating results

Output

Parameter	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.

Inputs and outputs

Input

Parameter	Type	Required	Description
organization	string	Yes	Azure DevOps organization name
project	string	Yes	Azure DevOps project name
pipelineId	number	Yes	ID of the pipeline to retrieve
pipelineVersion	number	No	Specific revision of the pipeline to retrieve (defaults to latest)

Output

Parameter	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.

Inputs and outputs

Input

Parameter	Type	Required	Description
organization	string	Yes	Azure DevOps organization name
project	string	Yes	Azure DevOps project name
pipelineId	number	Yes	ID of the pipeline whose runs to list

Output

Parameter	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.

Inputs and outputs

Input

Parameter	Type	Required	Description
organization	string	Yes	Azure DevOps organization name
project	string	Yes	Azure DevOps project name
pipelineId	number	Yes	ID of the pipeline
runId	number	Yes	ID of the run to retrieve

Output

Parameter	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.

Inputs and outputs

Input

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

Output

Parameter	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.

Inputs and outputs

Input

Parameter	Type	Required	Description
organization	string	Yes	Azure DevOps organization name
project	string	Yes	Azure DevOps project name
buildId	number	Yes	The build ID whose logs to list

Output

Parameter	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.

Inputs and outputs

Input

Parameter	Type	Required	Description
organization	string	Yes	Azure DevOps organization name
project	string	Yes	Azure DevOps project name
buildId	number	Yes	The build ID containing the log
logId	number	Yes	The log entry ID to fetch (from List Build Logs)
startLine	number	No	First line to return (1-based, inclusive)
endLine	number	No	Last line to return (1-based, inclusive)

Output

Parameter	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.

Inputs and outputs

Input

Parameter	Type	Required	Description
organization	string	Yes	Azure DevOps organization name
project	string	Yes	Azure DevOps project name
buildId	number	Yes	ID of the build whose timeline to retrieve

Output

Parameter	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.

Inputs and outputs

Input

Parameter	Type	Required	Description
organization	string	Yes	Azure DevOps organization name
project	string	Yes	Azure DevOps project name
fromBuildId	number	Yes	The older build ID (start of range)
toBuildId	number	Yes	The newer build ID (end of range)

Output

Parameter	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).

Inputs and outputs

Input

Parameter	Type	Required	Description
organization	string	Yes	Azure DevOps organization name
project	string	Yes	Azure DevOps project name
wiqlQuery	string	Yes	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.

Output

Parameter	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.

Inputs and outputs

Input

Parameter	Type	Required	Description
organization	string	Yes	Azure DevOps organization name
project	string	Yes	Azure DevOps project name
workItemId	number	Yes	The work item ID to fetch

Output

Parameter	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. "123,456,789"). Requests with more than 200 IDs are automatically split into chunks.

Inputs and outputs

Input

Parameter	Type	Required	Description
organization	string	Yes	Azure DevOps organization name
project	string	Yes	Azure DevOps project name
ids	string	Yes	Comma-separated work item IDs to fetch (e.g. "123,456,789"). Lists longer than 200 IDs are chunked automatically.

Output

Parameter	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.

Inputs and outputs

Input

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

Output

Parameter	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.

Inputs and outputs

Input

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

Output

Parameter	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.

Inputs and outputs

Input

Parameter	Type	Required	Description
organization	string	Yes	Azure DevOps organization name
project	string	Yes	Azure DevOps project name
workItemId	number	Yes	ID of the work item to comment on
text	string	Yes	Comment text (HTML supported, e.g. "<p>My comment</p>")

Output

Parameter	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.

Inputs and outputs

Input

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

Output

Parameter	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

Triggers

A trigger starts a workflow when a supported event occurs in this service.

Azure DevOps Build Failed

Trigger workflow when an Azure DevOps build fails, is canceled, or partially succeeds

Output

---

Azure DevOps Webhook (All Service Hook Events)

Trigger on whichever service hook event types you configure in Azure DevOps. Sim does not filter deliveries for this trigger.

Output

---

Azure DevOps Work Item Created

Trigger workflow when a work item is created in Azure DevOps

Output