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
Authentication
Authentication method: custom
Authentication profiles
connection · custom
- Organization URL Required
- Personal Access Token Required · protected credential
Supported objects
| Object | Read | Write | Notes |
|---|---|---|---|
| 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 projectwork_item_type· string · Required, Select the type of work item (e.g. Bug, Task, User Story)title· string · Required, The title of the work itemdescription· 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 projectwork_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 projectwork_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 itemdescription· 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 projectwiql_query· string · Optional, The WIQL query to execute. Default: SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @project ORDER BY [System.ChangedDate] DESClimit· 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 projectwork_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 · Requiredmethod· string · Requiredheaders· object · Optional, Authorization headers are injected automatically from your connection.queryParams· object · Optional, Appended to the URL as ?key=value.body_type· string · Optionalbody· object · Optionalresponse_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· stringwork_item_type· stringevents· 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· stringwork_item_type· stringstate_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.