# Azure DevOps (/integrations/azure_devops)





{/* MANUAL-CONTENT-START:intro */}

Use [Azure DevOps](https://azure.microsoft.com/en-us/products/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.

{/* MANUAL-CONTENT-END */}

## Use the block [#usage-instructions]

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

## Actions [#actions]

### Azure DevOps List Pipelines [#azure-devops-list-pipelines]

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

<ReferenceDetails>
  #### Input [#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 [#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 |
</ReferenceDetails>

### Azure DevOps Get Pipeline [#azure-devops-get-pipeline]

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

<ReferenceDetails>
  #### Input [#input-1]

  | 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 [#output-1]

  | 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 |
</ReferenceDetails>

### Azure DevOps List Pipeline Runs [#azure-devops-list-pipeline-runs]

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

<ReferenceDetails>
  #### Input [#input-2]

  | 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 [#output-2]

  | 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 |
</ReferenceDetails>

### Azure DevOps Get Pipeline 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.

<ReferenceDetails>
  #### Input [#input-3]

  | 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 [#output-3]

  | 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 |
</ReferenceDetails>

### Azure DevOps List Builds [#azure-devops-list-builds]

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

<ReferenceDetails>
  #### Input [#input-4]

  | 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 [#output-4]

  | 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 |
</ReferenceDetails>

### Azure DevOps List Build Logs [#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.

<ReferenceDetails>
  #### Input [#input-5]

  | 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 [#output-5]

  | 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 |
</ReferenceDetails>

### Azure DevOps Get Build Log [#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.

<ReferenceDetails>
  #### Input [#input-6]

  | 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 [#output-6]

  | Parameter | Type | Description |
  | - | - | - |
  | `content` | string | Raw log text |
  | `metadata` | object | Log metadata |
  | ↳ `lineCount` | number | Number of lines in the returned log text |
</ReferenceDetails>

### Azure DevOps Get Build Timeline [#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.

<ReferenceDetails>
  #### Input [#input-7]

  | 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 [#output-7]

  | 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 |
</ReferenceDetails>

### Azure DevOps Get Work Items Between Builds [#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.

<ReferenceDetails>
  #### Input [#input-8]

  | 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 [#output-8]

  | 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 |
</ReferenceDetails>

### Azure DevOps Query Work Items [#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).

<ReferenceDetails>
  #### Input [#input-9]

  | 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 [#output-9]

  | 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 |
</ReferenceDetails>

### Azure DevOps Get 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.

<ReferenceDetails>
  #### Input [#input-10]

  | 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 [#output-10]

  | 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 |
</ReferenceDetails>

### Azure DevOps Get Work Items Batch [#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.

<ReferenceDetails>
  #### Input [#input-11]

  | 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 [#output-11]

  | 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 |
</ReferenceDetails>

### Azure DevOps Create 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.

<ReferenceDetails>
  #### Input [#input-12]

  | 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 [#output-12]

  | 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 |
</ReferenceDetails>

### Azure DevOps Update 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.

<ReferenceDetails>
  #### Input [#input-13]

  | 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 [#output-13]

  | 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 |
</ReferenceDetails>

### Azure DevOps Add Comment [#azure-devops-add-comment]

Add a comment to a work item in Azure DevOps.

<ReferenceDetails>
  #### Input [#input-14]

  | 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 [#output-14]

  | 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 |
</ReferenceDetails>

### Azure DevOps Get Comments [#azure-devops-get-comments]

List comments for an Azure DevOps work item.

<ReferenceDetails>
  #### Input [#input-15]

  | 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 [#output-15]

  | 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 |
</ReferenceDetails>

## Triggers [#triggers]

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

### Azure DevOps Build Failed [#azure-devops-build-failed]

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

#### Output [#output-16]

| Parameter | Type | Description |
| - | - | - |
| `buildId` | number | Build ID |
| `buildNumber` | string | Build number string (e.g. 20240101.1) |
| `result` | string | Build result: failed \| canceled \| partiallySucceeded |
| `pipelineId` | number | Pipeline definition ID |
| `pipelineName` | string | Pipeline definition name |
| `projectName` | string | Azure DevOps project name |
| `branch` | string | Source branch name (refs/heads/ prefix stripped) |
| `commitSha` | string | Source commit SHA |
| `triggeredBy` | string | Display name of the person who triggered the build |
| `triggeredByEmail` | string | Email/unique name of the person who triggered the build, or null if not set |
| `startTime` | string | Build start time (ISO 8601) |
| `finishTime` | string | Build finish time (ISO 8601) |
| `buildUrl` | string | API URL for the build resource |

***

### Azure DevOps Webhook (All Service Hook Events) [#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 [#output-17]

| Parameter | Type | Description |
| - | - | - |
| `eventType` | string | Service hook event type (e.g. build.complete, workitem.created) |
| `notificationId` | number | Notification ID |
| `subscriptionId` | string | Service hook subscription ID |
| `publisherId` | string | Publisher ID (e.g. tfs) |
| `createdDate` | string | Event creation time (ISO 8601) |
| `resource` | json | Event resource payload |
| `resourceContainers` | json | Resource container references (project, collection, etc.) |
| `message` | json | Short message object |
| `detailedMessage` | json | Detailed message object |

***

### Azure DevOps Work Item Created [#azure-devops-work-item-created]

Trigger workflow when a work item is created in Azure DevOps

#### Output [#output-18]

| Parameter | Type | Description |
| - | - | - |
| `workItemId` | number | Work item ID |
| `workItemType` | string | Work item type for Basic process (e.g. Issue, Task, Epic) |
| `title` | string | Work item title |
| `state` | string | Work item state for Basic process (e.g. To Do, Doing, Done) |
| `createdBy` | string | Display name of the creator, or null if not set |
| `assignedTo` | string | Assignee display name, or null if unassigned |
| `priority` | number | Priority (1–4), or 0 if not set |
| `areaPath` | string | Area path |
| `iterationPath` | string | Iteration path |
| `description` | string | Work item description (HTML), or null if not set |
| `projectName` | string | Azure DevOps project name |
| `workItemUrl` | string | API URL for the work item resource |