Agreed, to add to this convention; having the version of the api as part of the communication protocol or message format is also recommended. This is so you c

Agreed, to add to this convention; having the version of the api as part of the communication protocol or message format is also recommended. This is so you can still support older api versions on the host side until a known cut off date. This allows for a soft roll out or smooth transition to the new version. There are various ways to implement, http header, http path, structured file formats to include a version variable, or meta tags, etc... This also allows you to put hooks in to track users of the old api version so that additional reach out/communication to the slow adopters can be had.