manage_work_item_link
Add, remove, or update links between work items in Azure DevOps projects using specified relation types, enabling structured task dependencies and workflows.
Instructions
Add or remove a link between work items
Input Schema
Name | Required | Description | Default |
---|---|---|---|
comment | No | Optional comment explaining the link | |
newRelationType | No | The new relation type to use when updating a link | |
operation | Yes | The operation to perform on the link | |
projectId | Yes | The ID or name of the project | |
relationType | Yes | The reference name of the relation type (e.g., "System.LinkTypes.Hierarchy-Forward") | |
sourceWorkItemId | Yes | The ID of the source work item | |
targetWorkItemId | Yes | The ID of the target work item |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"comment": {
"description": "Optional comment explaining the link",
"type": "string"
},
"newRelationType": {
"description": "The new relation type to use when updating a link",
"type": "string"
},
"operation": {
"description": "The operation to perform on the link",
"enum": [
"add",
"remove",
"update"
],
"type": "string"
},
"projectId": {
"description": "The ID or name of the project",
"type": "string"
},
"relationType": {
"description": "The reference name of the relation type (e.g., \"System.LinkTypes.Hierarchy-Forward\")",
"type": "string"
},
"sourceWorkItemId": {
"description": "The ID of the source work item",
"type": "number"
},
"targetWorkItemId": {
"description": "The ID of the target work item",
"type": "number"
}
},
"required": [
"sourceWorkItemId",
"targetWorkItemId",
"projectId",
"operation",
"relationType"
],
"type": "object"
}