REST API Versioning

by XDK 19. July 2019 18:48

Explanation:

API version can be specified either in the header of the HTTP request or as a URL query parameter:

HTTP request header: Accept: application/json;api-version=1.0
Query parameter: GET {url}/{organization}/_apis/{area}/{resource}?api-version=1.

Supported versions

Product 1.0 2.0 3.0 4.0 5.0
Azure DevOps Services X X X X X
Azure DevOps Server 2019 X X X X X
Team Foundation Server 2018 X X X X -
Team Foundation Server 2017 X X X - -
Team Foundation Server 2015 X X - - -

Note : Once a preview API is deactivated, requests that specify a -preview version will be rejected (for example, 1.0-preview.1, 1.0-preview.2).

 

Tags:

Azure DevOps Services | REST APIs | Team Foundation Server

Comments are closed

Disclaimer

The information provided here is based on my expreriences, troubleshooting and online/offline findings. It can be used as is on your own risk without any warranties and I impose no rights.

About the author

My name is Xavier Dilip Kumar Jayaraj and I am a Software Configuration Management Engineer with a background in application development, Build & packaging using Install Shield.

Profile in LinkedIn , PCEP-Certified , Azure-DevOps-C1

DevOps Tools

ALM tools:
Azure DevOps
IBM Rational
CA Agile Central-Rally
CollabNet VersionOne

Configuration tools:
• Puppet
• CHEF
• AWS OpsWorks
• Ansible

Build automation tools:
Apache Ant 
Apache Maven
Boot
Gradle
Grunt
MSBuild
Waf

Continuous Integration tools:
Bamboo
Buildbot
Hudson
TeamCity

Testing tools:
Selenium
Watir
Wapt
ApacheJMeter
QTest

Version control system tools:
Subversion
Team Foundation Server
GIT
Mercurial
Perforce

Code review tools:
Crucible
Gerrit
GitHub
Bitbucket Server

Continuous Delivery/release management tools:
XL Release
ElectricFlow
Serena Release
Octopus Deploy

Quotes I Like

"Failure will never overtake me if my determination to succeed is strong enough."  - Dr. APJ. Abdul Kalam

"Always be yourself, express yourself, have faith in yourself, do not go out and look for a successful personality and duplicate it." - Bruce Lee

"Technology is just a tool. In terms of getting the kids working together and motivating them, the teacher is the most important." - Bill Gates

"Innovation distinguishes between a leader and a follower." - Steve Jobs

Knowledge Base Articles