API-versionering är en komplex utmaning som kräver ett långsiktigt åtagande mot användare och stabila URI:er för att hantera applikationers och API:ers evolution. Det rekommenderas att inte bädda in API-versioner direkt i resurs-URI:er för långvarigt bruk, för att bevara konceptet hypermedia och skapa permanenta länkar (permalänkar). Den senaste API-versionen bör implementeras under en versionslös bas-URI, medan äldre eller inaktuella versioner bör omdirigeras med HTTP 30x statuskoder (t.ex. 301 Moved Permanently) till den aktuella permalänken. Temporär versionsinbäddning i bas-URI kan användas för specifika och begränsade ändamål som felsökning eller under stängda betatester, men bör vara tidsbegränsad. HTTP-verbsemantik (t.ex. PUT för uppdatering) och HTTP-statuskoder bör förbli konsekventa över API-versioner för att säkerställa bakåtkompatibilitet för befintliga API-klienter.