capabilities.work

Create a Parent and Linked Child Work Item

A 3-step recipe with Azure DevOps. We can help you get access.

Recipe · 3 steps

Create a Parent and Linked Child Work Item

Create a parent and child work item, then link the child to the parent.

  1. Create the parent work item with a JSON Patch document setting its title.
  2. Create the child work item with a JSON Patch document setting its title.
  3. Patch the child work item with a relations add operation that creates a Hierarchy-Reverse link pointing at the parent's API URL.
What you'll need to have ready
  • apiVersion: Azure DevOps REST API version (e.g. 7.1).
  • parentType: Work item type for the parent (e.g. User Story).
  • parentTitle: Title for the parent work item.
  • childType: Work item type for the child (e.g. Task).
  • childTitle: Title for the child work item.
  • accessToken: Azure DevOps bearer (OAuth 2.0) access token.
For your developer

Arazzo workflow microsoft-azure-devops:create-linked-child-work-item, 3 operations: workItems_create → workItems_create → workItems_update. Specs on APIs.io.