add_parent_child_link
Establish parent-child relationships between work items in Azure DevOps to organize hierarchies, create structured breakdowns, and enable progress tracking. Ensures child items appear under parents in backlogs and boards.
Instructions
Adds a parent-child relationship between two work items.
Use this tool when you need to:
- Establish hierarchy between work items
- Organize epics, features, user stories, and tasks
- Create a structured breakdown of work
- Enable rollup of effort and progress tracking
IMPORTANT: The child work item will immediately appear under the parent
in hierarchical views. This relationship affects how the items are
displayed in backlogs and boards. In Azure DevOps, a work item can have
only one parent but multiple children.
Args:
parent_id: ID of the parent work item
child_id: ID of the child work item
project: Optional project name or ID
Returns:
Formatted string containing the updated child work item details
showing the new parent relationship, formatted as markdown
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| child_id | Yes | ||
| parent_id | Yes | ||
| project | No |
Input Schema (JSON Schema)
{
"properties": {
"child_id": {
"title": "Child Id",
"type": "integer"
},
"parent_id": {
"title": "Parent Id",
"type": "integer"
},
"project": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Project"
}
},
"required": [
"parent_id",
"child_id"
],
"title": "add_parent_child_linkArguments",
"type": "object"
}