MicrosoftDocs / vsts-rest-api-specs

MIT License
158 stars 114 forks source link

Azure DevOps REST API - Work Item Relation Type URL Format Is Not Explicit #699

Open jack-toussaint opened 2 weeks ago

jack-toussaint commented 2 weeks ago

Please add examples for all of the Work Item Relation types. The ArtifactLink relation type for linking pull requests requires the url to be formatted in a specific way. I couldn't find that format anywhere in the documentation. I had to create a work item and manually link the PR. Then used the API to pull the metadata for that work item. That allowed me to inspect the ArtifactLink object and get the proper format, vstfs:///Git/PullRequestId/{projectId}/{repositoryId}/{pullRequestId}.

I searched online for "vstfs:///Git/PullRequestId" and found it tucked away in the Pull Requests page, https://learn.microsoft.com/en-us/rest/api/azure/devops/git/pull-requests/get-pull-requests?view=azure-devops-rest-7.1&tabs=HTTP.

Please provide examples for all of the Work Item Relation Types or come up with another solution for improving this documentation.


Document Details

Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.