Deprecation Strategy

When we deprecate an endpoint, you have six months to change or stop the use of this endpoint.
You know an endpoint is deprecated either by inspecting it in swagger, or inspecting the returned headers from the API call.
We have added four new headers to all deprecated endpoints:

X-Deprecated-AtUtc
DateTime formatted string in UTC indicating the date when the endpoint was deprecated.
X-Deprecated-ExpiresUtc
DateTime formatted string in UTC indicating the date when the endpoint will be shut down and start responding 410 gone to all requests.
X-Deprecated-Message
Either the new url to use, or a description of what to do.
X-Deprecated-Api
Name of the application the response came from.

Be sure to listen for these headers and have some kind of handle for this. This is important as it might break your application when the "Expires" header has been reached.