Skip to main content

​
Add work item comment

Action ID: tools.azure_devops.add_work_item_comment Add a comment to a work item. Reference: https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/comments/add?view=azure-devops-rest-7.2

​
Secrets

Optional secrets:
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_USER_TOKEN.
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_SERVICE_TOKEN.

​
Input fields

​
string
required
Azure DevOps organization name.
​
string
required
Project ID or project name.
​
string
required
Comment text (HTML supported).
​
integer
required
Work item ID.
​
string | null
Azure DevOps base URL. Defaults to https://dev.azure.com (Azure DevOps Services). For Azure DevOps Server, set this to the collection URL.Default: null.

​
Create pull request comment thread

Action ID: tools.azure_devops.create_pull_request_thread Create a comment thread on a pull request. Reference: https://learn.microsoft.com/en-us/rest/api/azure/devops/git/pull-request-threads/create?view=azure-devops-rest-7.2

​
Secrets

Optional secrets:
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_USER_TOKEN.
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_SERVICE_TOKEN.

​
Input fields

​
array[object]
required
Comments in the thread, each as {"content": "...", "commentType": "text"}.
​
string
required
Azure DevOps organization name.
​
string
required
Project ID or project name.
​
integer
required
Pull request ID.
​
string
required
Repository ID or name.
​
string | null
Azure DevOps base URL. Defaults to https://dev.azure.com (Azure DevOps Services). For Azure DevOps Server, set this to the collection URL.Default: null.
​
string | null
Thread status. One of active, fixed, wontFix, closed, byDesign, pending.Default: null.
​
object | null
File/line context, e.g. {"filePath": "/src/app.py", "rightFileStart": {"line": 1, "offset": 1}, "rightFileEnd": {"line": 1, "offset": 1}}.Default: null.

​
Create work item

Action ID: tools.azure_devops.create_work_item Create a work item of the given type (for example Bug or Task) from a mapping of field reference names to values. Reference: https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/work-items/create?view=azure-devops-rest-7.2

​
Secrets

Optional secrets:
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_USER_TOKEN.
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_SERVICE_TOKEN.

​
Input fields

​
object
required
Field reference names mapped to values, e.g. {"System.Title": "Investigate alert", "System.Description": "..."}.
​
string
required
Azure DevOps organization name.
​
string
required
Project ID or project name.
​
string
required
Work item type name (e.g. Bug, Task, User Story).
​
string | null
Azure DevOps base URL. Defaults to https://dev.azure.com (Azure DevOps Services). For Azure DevOps Server, set this to the collection URL.Default: null.
​
boolean | null
Bypass work item type rules.Default: null.
​
string | null
Expand parameters for work item attributes. One of none, relations, fields, links, all.Default: null.
​
boolean | null
Do not fire notifications for this change.Default: null.
​
boolean | null
Validate the changes without saving the work item.Default: null.

​
Get Advanced Security alert

Action ID: tools.azure_devops.get_alert Get a GitHub Advanced Security for Azure DevOps alert by ID. Reference: https://learn.microsoft.com/en-us/rest/api/azure/devops/advancedsecurity/alerts/get?view=azure-devops-rest-7.2

​
Secrets

Optional secrets:
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_USER_TOKEN.
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_SERVICE_TOKEN.

​
Input fields

​
integer
required
Alert ID.
​
string
required
Azure DevOps organization name.
​
string
required
Project ID or project name.
​
string
required
Repository ID or name.
​
string | null
Azure DevOps base URL. Defaults to https://advsec.dev.azure.com (Azure DevOps Services). For Azure DevOps Server, set this to the collection URL.Default: null.
​
string | null
Branch ref the alert is on (e.g. refs/heads/main).Default: null.

​
Get pipeline run

Action ID: tools.azure_devops.get_pipeline_run Get a pipeline run by ID. Reference: https://learn.microsoft.com/en-us/rest/api/azure/devops/pipelines/runs/get?view=azure-devops-rest-7.2

​
Secrets

Optional secrets:
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_USER_TOKEN.
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_SERVICE_TOKEN.

​
Input fields

​
string
required
Azure DevOps organization name.
​
integer
required
Pipeline ID.
​
string
required
Project ID or project name.
​
integer
required
Run ID.
​
string | null
Azure DevOps base URL. Defaults to https://dev.azure.com (Azure DevOps Services). For Azure DevOps Server, set this to the collection URL.Default: null.

​
Get pull request

Action ID: tools.azure_devops.get_pull_request Get a pull request by ID. Reference: https://learn.microsoft.com/en-us/rest/api/azure/devops/git/pull-requests/get-pull-request?view=azure-devops-rest-7.2

​
Secrets

Optional secrets:
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_USER_TOKEN.
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_SERVICE_TOKEN.

​
Input fields

​
string
required
Azure DevOps organization name.
​
string
required
Project ID or project name.
​
integer
required
Pull request ID.
​
string
required
Repository ID or name.
​
string | null
Azure DevOps base URL. Defaults to https://dev.azure.com (Azure DevOps Services). For Azure DevOps Server, set this to the collection URL.Default: null.
​
boolean | null
Include commits associated with the pull request.Default: null.
​
boolean | null
Include linked work item references.Default: null.
​
integer | null
Not used.Default: null.

​
Get repository

Action ID: tools.azure_devops.get_repository Get a Git repository by ID or name. Reference: https://learn.microsoft.com/en-us/rest/api/azure/devops/git/repositories/get-repository?view=azure-devops-rest-7.2

​
Secrets

Optional secrets:
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_USER_TOKEN.
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_SERVICE_TOKEN.

​
Input fields

​
string
required
Azure DevOps organization name.
​
string
required
Project ID or project name.
​
string
required
Repository ID or name.
​
string | null
Azure DevOps base URL. Defaults to https://dev.azure.com (Azure DevOps Services). For Azure DevOps Server, set this to the collection URL.Default: null.

​
Get work item

Action ID: tools.azure_devops.get_work_item Get a single work item by ID. Reference: https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/work-items/get-work-item?view=azure-devops-rest-7.2

​
Secrets

Optional secrets:
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_USER_TOKEN.
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_SERVICE_TOKEN.

​
Input fields

​
integer
required
Work item ID.
​
string
required
Azure DevOps organization name.
​
string
required
Project ID or project name.
​
string | null
Return the work item as of this UTC date time (ISO 8601).Default: null.
​
string | null
Azure DevOps base URL. Defaults to https://dev.azure.com (Azure DevOps Services). For Azure DevOps Server, set this to the collection URL.Default: null.
​
string | null
Expand parameters for work item attributes. One of none, relations, fields, links, all.Default: null.
​
string | null
Comma-separated list of field reference names to return. Cannot be combined with expand.Default: null.

​
List Advanced Security alerts

Action ID: tools.azure_devops.list_alerts List GitHub Advanced Security for Azure DevOps alerts (secret, dependency, code scanning) for a repository. Returns one page; pass continuation_token to fetch the next page. Reference: https://learn.microsoft.com/en-us/rest/api/azure/devops/advancedsecurity/alerts/list?view=azure-devops-rest-7.2

​
Secrets

Optional secrets:
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_USER_TOKEN.
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_SERVICE_TOKEN.

​
Input fields

​
string
required
Azure DevOps organization name.
​
string
required
Project ID or project name.
​
string
required
Repository ID or name.
​
string | null
Alert type. One of unknown, dependency, secret, code, license.Default: null.
​
string | null
Azure DevOps base URL. Defaults to https://advsec.dev.azure.com (Azure DevOps Services). For Azure DevOps Server, set this to the collection URL.Default: null.
​
string | null
Comma-separated confidence levels (high, other).Default: null.
​
string | null
Continuation token from the previous page.Default: null.
​
string | null
Only alerts first seen after this time (ISO 8601).Default: null.
​
boolean | null
Filter by triage status.Default: null.
​
string | null
Keyword filter on title, rule, or dependency.Default: null.
​
string | null
Only alerts modified after this time (ISO 8601).Default: null.
​
boolean | null
Only alerts on the default branch.Default: null.
​
string | null
Sort order, e.g. severity, firstSeen, lastSeen, id.Default: null.
​
string | null
Filter by branch ref (e.g. refs/heads/main).Default: null.
​
string | null
Filter by rule ID.Default: null.
​
string | null
Filter by rule name.Default: null.
​
string | null
Comma-separated severities (e.g. critical,high).Default: null.
​
string | null
Comma-separated states (e.g. active, dismissed, fixed, autoDismissed).Default: null.
​
string | null
Only alerts first seen before this time (ISO 8601).Default: null.
​
string | null
Filter by tool name.Default: null.
​
integer | null
Maximum number of alerts to return.Default: null.
​
string | null
Comma-separated secret validity statuses.Default: null.

​
List builds

Action ID: tools.azure_devops.list_builds List builds in a project matching optional filters. Returns one page; pass continuation_token to fetch the next page. Reference: https://learn.microsoft.com/en-us/rest/api/azure/devops/build/builds/list?view=azure-devops-rest-7.2

​
Secrets

Optional secrets:
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_USER_TOKEN.
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_SERVICE_TOKEN.

​
Input fields

​
string
required
Azure DevOps organization name.
​
string
required
Project ID or project name.
​
string | null
Azure DevOps base URL. Defaults to https://dev.azure.com (Azure DevOps Services). For Azure DevOps Server, set this to the collection URL.Default: null.
​
string | null
Filter by branch ref (e.g. refs/heads/main).Default: null.
​
string | null
Comma-separated list of build IDs.Default: null.
​
string | null
Filter by build number (supports trailing * wildcard).Default: null.
​
string | null
Continuation token from the previous page.Default: null.
​
string | null
Comma-separated list of definition IDs.Default: null.
​
integer | null
Maximum number of builds to return per definition.Default: null.
​
string | null
Only builds finished/started before this time (ISO 8601).Default: null.
​
string | null
Only builds finished/started after this time (ISO 8601).Default: null.
​
string | null
Result order (e.g. finishTimeDescending, queueTimeDescending, startTimeDescending).Default: null.
​
string | null
Filter by build reason (e.g. manual, individualCI, schedule, pullRequest).Default: null.
​
string | null
Filter by repository ID.Default: null.
​
string | null
Filter by repository type.Default: null.
​
string | null
Filter by the user who requested the build.Default: null.
​
string | null
Filter by result (e.g. succeeded, partiallySucceeded, failed, canceled).Default: null.
​
string | null
Filter by status (e.g. inProgress, completed, cancelling, postponed, notStarted, all).Default: null.
​
string | null
Comma-separated list of tags.Default: null.
​
integer | null
Maximum number of builds to return.Default: null.

​
List pipeline runs

Action ID: tools.azure_devops.list_pipeline_runs List the top 10000 runs for a pipeline. Reference: https://learn.microsoft.com/en-us/rest/api/azure/devops/pipelines/runs/list?view=azure-devops-rest-7.2

​
Secrets

Optional secrets:
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_USER_TOKEN.
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_SERVICE_TOKEN.

​
Input fields

​
string
required
Azure DevOps organization name.
​
integer
required
Pipeline ID.
​
string
required
Project ID or project name.
​
string | null
Azure DevOps base URL. Defaults to https://dev.azure.com (Azure DevOps Services). For Azure DevOps Server, set this to the collection URL.Default: null.

​
List pipelines

Action ID: tools.azure_devops.list_pipelines List pipelines in a project. Returns one page; pass continuation_token to fetch the next page. Reference: https://learn.microsoft.com/en-us/rest/api/azure/devops/pipelines/pipelines/list?view=azure-devops-rest-7.2

​
Secrets

Optional secrets:
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_USER_TOKEN.
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_SERVICE_TOKEN.

​
Input fields

​
string
required
Azure DevOps organization name.
​
string
required
Project ID or project name.
​
string | null
Azure DevOps base URL. Defaults to https://dev.azure.com (Azure DevOps Services). For Azure DevOps Server, set this to the collection URL.Default: null.
​
string | null
Continuation token from the previous page.Default: null.
​
string | null
Sort order, e.g. name asc.Default: null.
​
integer | null
Maximum number of pipelines to return.Default: null.

​
List projects

Action ID: tools.azure_devops.list_projects List projects in an Azure DevOps organization. Returns one page; pass continuation_token to fetch the next page. Reference: https://learn.microsoft.com/en-us/rest/api/azure/devops/core/projects/list?view=azure-devops-rest-7.2

​
Secrets

Optional secrets:
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_USER_TOKEN.
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_SERVICE_TOKEN.

​
Input fields

​
string
required
Azure DevOps organization name.
​
string | null
Azure DevOps base URL. Defaults to https://dev.azure.com (Azure DevOps Services). For Azure DevOps Server, set this to the collection URL.Default: null.
​
integer | null
Continuation token (number of projects already fetched) from the previous page.Default: null.
​
boolean | null
Include the default team image URL.Default: null.
​
integer | null
Number of projects to skip.Default: null.
​
string | null
Filter on team project state. One of all, createPending, deleted, deleting, new, unchanged, wellFormed.Default: null.
​
integer | null
Maximum number of projects to return.Default: null.

​
List pull requests

Action ID: tools.azure_devops.list_pull_requests List pull requests in a repository matching optional search criteria. Reference: https://learn.microsoft.com/en-us/rest/api/azure/devops/git/pull-requests/get-pull-requests?view=azure-devops-rest-7.2

​
Secrets

Optional secrets:
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_USER_TOKEN.
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_SERVICE_TOKEN.

​
Input fields

​
string
required
Azure DevOps organization name.
​
string
required
Project ID or project name.
​
string
required
Repository ID or name.
​
string | null
Azure DevOps base URL. Defaults to https://dev.azure.com (Azure DevOps Services). For Azure DevOps Server, set this to the collection URL.Default: null.
​
string | null
Only pull requests created by this user ID.Default: null.
​
boolean | null
Include reference links.Default: null.
​
string | null
Only pull requests created or closed before this time (ISO 8601).Default: null.
​
string | null
Only pull requests created or closed after this time (ISO 8601).Default: null.
​
string | null
Which time to filter on with min_time/max_time. One of created, closed.Default: null.
​
string | null
Only pull requests with this reviewer user ID.Default: null.
​
integer | null
Number of pull requests to skip.Default: null.
​
string | null
Only pull requests from this source branch (e.g. refs/heads/feature).Default: null.
​
string | null
Pull request status. One of active, abandoned, completed, all, notSet.Default: null.
​
string | null
Only pull requests into this target branch (e.g. refs/heads/main).Default: null.
​
string | null
Only pull requests whose title contains this text.Default: null.
​
integer | null
Maximum number of pull requests to return.Default: null.

​
List repositories

Action ID: tools.azure_devops.list_repositories List Git repositories in a project. Reference: https://learn.microsoft.com/en-us/rest/api/azure/devops/git/repositories/list?view=azure-devops-rest-7.2

​
Secrets

Optional secrets:
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_USER_TOKEN.
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_SERVICE_TOKEN.

​
Input fields

​
string
required
Azure DevOps organization name.
​
string
required
Project ID or project name.
​
string | null
Azure DevOps base URL. Defaults to https://dev.azure.com (Azure DevOps Services). For Azure DevOps Server, set this to the collection URL.Default: null.
​
boolean | null
Include all remote URLs.Default: null.
​
boolean | null
Include hidden repositories.Default: null.
​
boolean | null
Include reference links.Default: null.

​
List teams

Action ID: tools.azure_devops.list_teams List teams in a project. Reference: https://learn.microsoft.com/en-us/rest/api/azure/devops/core/teams/get-teams?view=azure-devops-rest-7.2

​
Secrets

Optional secrets:
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_USER_TOKEN.
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_SERVICE_TOKEN.

​
Input fields

​
string
required
Azure DevOps organization name.
​
string
required
Project ID or project name.
​
string | null
Azure DevOps base URL. Defaults to https://dev.azure.com (Azure DevOps Services). For Azure DevOps Server, set this to the collection URL.Default: null.
​
boolean | null
Expand identity information in the result.Default: null.
​
boolean | null
Return only teams the authenticated user is a member of.Default: null.
​
integer | null
Number of teams to skip.Default: null.
​
integer | null
Maximum number of teams to return.Default: null.

​
List work item comments

Action ID: tools.azure_devops.list_work_item_comments List comments on a work item. Returns one page; pass continuation_token to fetch the next page. Reference: https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/comments/get-comments?view=azure-devops-rest-7.2

​
Secrets

Optional secrets:
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_USER_TOKEN.
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_SERVICE_TOKEN.

​
Input fields

​
string
required
Azure DevOps organization name.
​
string
required
Project ID or project name.
​
integer
required
Work item ID.
​
string | null
Azure DevOps base URL. Defaults to https://dev.azure.com (Azure DevOps Services). For Azure DevOps Server, set this to the collection URL.Default: null.
​
string | null
Continuation token from the previous page.Default: null.
​
string | null
Additional data to include. One of none, reactions, renderedText, renderedTextOnly, all.Default: null.
​
boolean | null
Include deleted comments.Default: null.
​
string | null
Order of comments. One of asc, desc.Default: null.
​
integer | null
Maximum number of comments to return.Default: null.

​
List work items

Action ID: tools.azure_devops.list_work_items Get a batch of work items by IDs (maximum 200). Reference: https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/work-items/list?view=azure-devops-rest-7.2

​
Secrets

Optional secrets:
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_USER_TOKEN.
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_SERVICE_TOKEN.

​
Input fields

​
string
required
Comma-separated list of work item IDs (maximum 200).
​
string
required
Azure DevOps organization name.
​
string
required
Project ID or project name.
​
string | null
Return the work items as of this UTC date time (ISO 8601).Default: null.
​
string | null
Azure DevOps base URL. Defaults to https://dev.azure.com (Azure DevOps Services). For Azure DevOps Server, set this to the collection URL.Default: null.
​
string | null
Behavior when a work item is not found. One of fail, omit.Default: null.
​
string | null
Expand parameters for work item attributes. One of none, relations, fields, links, all.Default: null.
​
string | null
Comma-separated list of field reference names to return. Cannot be combined with expand.Default: null.

​
Query work items (WIQL)

Action ID: tools.azure_devops.query_work_items Run a WIQL query and return matching work item references. Reference: https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/wiql/query-by-wiql?view=azure-devops-rest-7.2

​
Secrets

Optional secrets:
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_USER_TOKEN.
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_SERVICE_TOKEN.

​
Input fields

​
string
required
Azure DevOps organization name.
​
string
required
Project ID or project name.
​
string
required
WIQL query text, e.g. SELECT [System.Id] FROM WorkItems WHERE [System.State] = 'Active'.
​
string | null
Azure DevOps base URL. Defaults to https://dev.azure.com (Azure DevOps Services). For Azure DevOps Server, set this to the collection URL.Default: null.
​
string | null
Team ID or name to scope the query to.Default: null.
​
boolean | null
Use time precision in date comparisons.Default: null.
​
integer | null
Maximum number of results to return.Default: null.

​
Run pipeline

Action ID: tools.azure_devops.run_pipeline Run a YAML pipeline, optionally overriding the branch, template parameters, and variables. Reference: https://learn.microsoft.com/en-us/rest/api/azure/devops/pipelines/runs/run-pipeline?view=azure-devops-rest-7.2

​
Secrets

Optional secrets:
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_USER_TOKEN.
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_SERVICE_TOKEN.

​
Input fields

​
string
required
Azure DevOps organization name.
​
integer
required
Pipeline ID.
​
string
required
Project ID or project name.
​
string | null
Azure DevOps base URL. Defaults to https://dev.azure.com (Azure DevOps Services). For Azure DevOps Server, set this to the collection URL.Default: null.
​
integer | null
Pipeline version to run.Default: null.
​
boolean | null
Preview the final YAML without running the pipeline.Default: null.
​
object | null
Run resources, e.g. {"repositories": {"self": {"refName": "refs/heads/main"}}} to pick the branch.Default: null.
​
array[string] | null
Stage names to skip.Default: null.
​
object | null
Runtime template parameter values.Default: null.
​
object | null
Variable overrides, e.g. {"env": {"value": "prod"}}.Default: null.
​
string | null
YAML to use instead of the pipeline’s YAML (preview runs only).Default: null.

​
Update work item

Action ID: tools.azure_devops.update_work_item Update fields on an existing work item from a mapping of field reference names to values. Reference: https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/work-items/update?view=azure-devops-rest-7.2

​
Secrets

Optional secrets:
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_USER_TOKEN.
  • azure_devops_oauth: OAuth token AZURE_DEVOPS_SERVICE_TOKEN.

​
Input fields

​
object
required
Field reference names mapped to new values, e.g. {"System.State": "Closed"}.
​
integer
required
Work item ID.
​
string
required
Azure DevOps organization name.
​
string
required
Project ID or project name.
​
string | null
Azure DevOps base URL. Defaults to https://dev.azure.com (Azure DevOps Services). For Azure DevOps Server, set this to the collection URL.Default: null.
​
boolean | null
Bypass work item type rules.Default: null.
​
string | null
Expand parameters for work item attributes. One of none, relations, fields, links, all.Default: null.
​
boolean | null
Do not fire notifications for this change.Default: null.
​
boolean | null
Validate the changes without saving the work item.Default: null.