Skip to content
← Back to documentation
Technical Reference

Azure DevOps

Track work, code, and ship software with Azure Boards, Repos, and Pipelines.

CategoryDeveloper Tools
Authenticationcustom
Version0.1.0
Published scopes0 published scopes
Last updatedSeptember 19, 2026

Overview

Azure DevOps

This CDK catalogue package is pinned to @activepieces/piece-azure-devops@0.1.0 and declares 6 declared actions and 2 declared triggers. Its definition is derived from the exact reviewed Activepieces source.

Provider runtime verification is recorded separately when an approved test connection is exercised; this catalogue entry does not claim that verification.

Technical guide

Technical reference

  • Package: @activepieces/piece-azure-devops@0.1.0
  • Exact artifact digest: sha256:8eca00821237a4b1445b0c18b91941ff437473dad86a2e419260863530655fb4
  • Source: the exact reviewed Activepieces source
  • Authentication, action and trigger schemas are taken from the exact pinned package.

Capability summary

Authenticationcustom
Supported objects8
Supported actions6
Triggers2

Authentication

Authentication method: custom

Authentication profiles

connection · custom
  • Organization URL Required
  • Personal Access Token Required · protected credential

Supported objects

ObjectReadWriteNotes
Create Work Item Yes No
Get Work Item Yes No
Update Work Item Yes No
List Work Items Yes No
Add Comment Yes No
Custom API Call Yes No
New or Updated Work Item (Instant) Yes No Trigger contract validated offline; live event delivery is tracked separately.
New or Updated Work Item (Polling) Yes No Trigger contract validated offline; live event delivery is tracked separately.

Supported actions

Create Work Item · Read

Creates a new work item (Bug, Task, User Story, etc.) in Azure DevOps

create_work_item · Risk: low · Retry: safe

Inputs

  • project · string · Required, Select the Azure DevOps project
  • work_item_type · string · Required, Select the type of work item (e.g. Bug, Task, User Story)
  • title · string · Required, The title of the work item
  • description · string · Optional, Detailed description of the work item (supports HTML)
  • assigned_to · string · Optional, Select the person to assign this work item to. Only project team members are listed u2014 use the Custom API Call action if you need to assign a user outside your teams.
  • priority · string · Optional, The priority of the work item
Get Work Item · Read

Retrieves a work item by ID from Azure DevOps

get_work_item · Risk: low · Retry: safe

Inputs

  • project · string · Required, Select the Azure DevOps project
  • work_item_id · number · Required, Numeric ID of the work item (e.g. 123). To pass it dynamically, reference the ID from a previous step (e.g. `{{trigger.id}}`), not the title.
Update Work Item · Read

Updates an existing work item in Azure DevOps

update_work_item · Risk: low · Retry: safe

Inputs

  • project · string · Required, Select the Azure DevOps project
  • work_item_type · string · Required, Type of the work item. Used only to load the matching list of states below u2014 it does not change the work item's type. Changing type requires a separate Azure DevOps operation not supported here.
  • work_item_id · number · Required, Numeric ID of the work item (e.g. 123). To pass it dynamically from a previous step, use a reference like `{{trigger.id}}` or the output of a Get/List step u2014 not the title.
  • title · string · Optional, New title for the work item
  • description · string · Optional, New description for the work item (supports HTML)
  • state · string · Optional, New state for the work item. Leave empty to keep the current state.
  • assigned_to · string · Optional, Select the person to assign this work item to. Only project team members are listed u2014 use the Custom API Call action if you need to assign a user outside your teams.
  • priority · string · Optional, The priority of the work item
List Work Items · Read

Lists work items from Azure DevOps using a WIQL query

list_work_items · Risk: low · Retry: safe

Inputs

  • project · string · Required, Select the Azure DevOps project
  • wiql_query · string · Optional, The WIQL query to execute. Default: SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @project ORDER BY [System.ChangedDate] DESC
  • limit · number · Optional, Maximum number of work items to return (default: 50, max: 200)
Add Comment · Read

Adds a comment to an existing work item in Azure DevOps

add_comment · Risk: low · Retry: safe

Inputs

  • project · string · Required, Select the Azure DevOps project
  • work_item_id · number · Required, Numeric ID of the work item (e.g. 123). To pass it dynamically, reference the ID from a previous step (e.g. `{{trigger.id}}`), not the title.
  • comment · string · Required, The comment text to add (supports HTML)
Custom API Call · Read

Make a custom API call to a specific endpoint

custom_api_call · Risk: low · Retry: safe

Inputs

  • url · object · Required
  • method · string · Required
  • headers · object · Optional, Authorization headers are injected automatically from your connection.
  • queryParams · object · Optional, Appended to the URL as ?key=value.
  • body_type · string · Optional
  • body · object · Optional
  • response_is_binary · boolean · Optional, Enable for files like PDFs, images, etc.
  • failsafe · boolean · Optional, On a failed request, output the error instead of failing the step.
  • timeout · number · Optional, Seconds to wait for a response. Empty: up to the flow limit (10 min).
  • followRedirects · boolean · Optional, Follow 3xx redirects instead of returning them as the response.

Triggers

New or Updated Work Item (Instant) · Webhook

Fires instantly when a work item is created, updated, or commented on in Azure DevOps via a Service Hooks subscription. Requires a public webhook URL reachable from Azure DevOps.

Inputs

  • project · string
  • work_item_type · string
  • events · array
New or Updated Work Item (Polling) · Poll

Polls Azure DevOps every few minutes and fires when a work item is created or updated. Use this when your Activepieces instance is not reachable from the public internet; otherwise prefer the Instant trigger. Pick a work item type to unlock the state filter.

Inputs

  • project · string
  • work_item_type · string
  • state_filter · string

Setup

Setup

Create a tenant connection only in the consuming Studio instance when this connector is made available there. Credentials remain in that tenant's Vault-backed connection and are not stored in CDK package metadata.

Limitations

The package has passed deterministic offline package-load and contract validation. No provider credentials, provider API call or live webhook delivery is represented by this release state.