View as Markdown
Azure DevOps icon

Azure DevOps ACTION

Update Work Item

Update an existing work item - retitle it, move it between states, reassign it, repoint its area and iteration, or link it to another work item. At least one field or a link is required. Returns the updated work item. Use when closing out automated work or reflecting a change from another system. Example: work item 299, state Closed. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Azure DevOps account once, then configure and run Update Work Item from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "azure_devops-update-work-item",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    azure_devops: { authProvisionId: "apn_xxxxxxx" },
    organization: "Organization",
    project: "Project",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Update Work Item inputs
Property Type Description
organization Organization string
Name of the organization
Required Dynamic
project Project string
Project ID or project name. Run the List Projects action first to obtain valid values.
Required
workItemId Work Item ID integer
Numeric ID of the work item. Run the Query Work Items (WIQL) action first to obtain valid values.
Required
title Title string
New title of the work item (max 255 chars)
Optional
description Description string
Description of the work item. HTML is supported.
Optional
state State string
New state, e.g. Active, Resolved, Closed. Valid values depend on the work item type - run the List Work Item Types action first.
Optional
assignedTo Assigned To string
Email address or display name of the user to assign the work item to. Run the List Users action first to obtain valid values.
Optional
areaPath Area Path string
Area path, e.g. MyProject\Team A. Run the List Classification Nodes action first to obtain valid values.
Optional
iterationPath Iteration Path string
Iteration path, e.g. MyProject\Sprint 1. Run the List Classification Nodes action first to obtain valid values.
Optional
tags Tags string[]
Tags to set on the work item. Replaces the existing tag list.
Optional
additionalFields Additional Fields object
Any other work item fields to set, keyed by reference name. Example: { "Microsoft.VSTS.Common.Priority": 1 }. Run the List Work Item Fields action first to obtain valid reference names.
Optional
targetWorkItemId Link Target Work Item ID integer
Numeric ID of a work item to link this one to, e.g. 297. Run the Query Work Items (WIQL) action first to obtain valid values. Requires Link Type.
Optional
linkType Link Type string
Relationship the target work item has to this one, e.g. a predecessor it depends on. Requires Link Target Work Item ID.
Optional
linkComment Link Comment string
Comment describing why the work items are linked
Optional
expand Expand string
Additional work item attributes to include in the response
Optional
bypassRules Bypass Rules boolean
Do not enforce work item type rules on this change. Requires membership of the Project Collection Service Accounts group.
Optional
suppressNotifications Suppress Notifications boolean
Do not fire any notifications for this change
Optional
validateOnly Validate Only boolean
Validate the change without saving the work item
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
azure_devops-update-work-item
Version
0.0.2
App
Azure DevOps
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes