There will generally be three supported versions of the Campaign Manager 360 API at any
given time. When a new version is released, a sunset date is announced for the
previous version. A version is considered deprecated once a sunset date has been
announced for it.
The deprecation period for most versions will be approximately 7 months.
While deprecated versions remain available until the scheduled sunset date,
users are encouraged to use the deprecation period to migrate to a newer
version. After the sunset date, deprecated versions will no longer be available.
What happens when a version sunsets?
When a version is sunset all incoming requests are rejected with an HTTP 403: Forbidden error response. These errors are accompanied by a message alerting users that the version is no longer supported:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "forbidden",
"message": "3140 : Version v2.x of the DCM/DFA Trafficking and Reporting API is no longer supported. Please upgrade to the latest version of the API."
}
],
"code": 403,
"message": "3140 : Version v2.x of the DCM/DFA Trafficking and Reporting API is no longer supported. Please upgrade to the latest version of the API."
}
}
After some time, the version is fully deactivated and becomes unreachable. At that point, all requests against the version receive a generic HTTP 404: Not Found error response.
A schedule of the currently announced deprecation and sunset dates is provided
below:
| API Version |
Deprecation Date |
Sunset Date |
| v3.5 |
Jun 15, 2022 |
Apr 20, 2023 |
| v3.4 |
May 24, 2021 |
Jan 10, 2022 |
| v3.3 |
Currently Deprecated |
June 30, 2021 |
