wit_add_artifact_link
Link artifacts like repositories, branches, commits, and builds to Azure DevOps work items using VSTFS URIs or individual components. Simplifies tracking and referencing related development resources.
Instructions
Add artifact links (repository, branch, commit, builds) to work items. You can either provide the full vstfs URI or the individual components to build it automatically.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| artifactUri | No | The complete VSTFS URI of the artifact to link. If provided, individual component parameters are ignored. | |
| branchName | No | The branch name (e.g., 'main'). Required when linkType is 'Branch'. | |
| buildId | No | The build ID. Required when linkType is 'Build', 'Found in build', or 'Integrated in build'. | |
| comment | No | Comment to include with the artifact link. | |
| commitId | No | The commit SHA hash. Required when linkType is 'Fixed in Commit'. | |
| linkType | No | Type of artifact link, defaults to 'Branch'. This determines both the link type and how to build the VSTFS URI from individual components. | Branch |
| project | Yes | The name or ID of the Azure DevOps project. | |
| projectId | No | The project ID (GUID) containing the artifact. Required for Git artifacts when artifactUri is not provided. | |
| pullRequestId | No | The pull request ID. Required when linkType is 'Pull Request'. | |
| repositoryId | No | The repository ID (GUID) containing the artifact. Required for Git artifacts when artifactUri is not provided. | |
| workItemId | Yes | The ID of the work item to add the artifact link to. |