Git Pull Request API

Last Update: 8/8/2017

api-version = 3.0-preview

Use these APIs to work with a Pull Request in a Team Foundation managed Git repository.

  • General Operations This section describes how to find, examine, edit and complete pull requests.

  • Comments Users can comment on pull requests. These comments are grouped into threads which can be used on the pull request in general or about a particular section of a file in the pull request.

  • Iterations Iterations contain the history of the pull request. Every time commits are pushed to the source branch and when the pull request is created, an iteration is created. Each iteraction can contain more than one commit.

  • Reviewers The primary action for reviewers is to vote to approve or reject the pull request.

  • Work Items Pull requests can be linked to work items.

  • Statuses Custom statuses provide extensibility for pull request expirience. Used with status policy they can block pull request completion.


Repositories have both a name and an identifier. Identifiers are globally unique, but several projects may contain a repository of the same name. You don't need to include the project if you specify a repository by ID. However, if you specify a repository by name, you must also specify the project (by name or ID).

There are code samples available for this area.