The deprecation policy for Admin Router API endpoints can be divided into three related issues:
a) the deprecation timeline - for how long/how many DC/OS versions we want to be compatible with when changing the endpoint
b) the way we are deprecating endpoints - we can either do it transparently or via a 3XX response.
c) IAM RID deprecation/migration policy
This issue tries to discuss this problem and proposes solutions.