Migrate from Management API v1 to v2
Auth0’s Management API v1 was deprecated in 2016 and replaced with the Auth0 Management API v2. Management API v1 will reach its End Of Life in the Public Cloud on July 13th, 2020. Requests will begin failing with a
410 HTTP status code on or after that date. Private Cloud releases will continue to support Management API v1 until the November 2020 monthly release.
Am I affected by the migration?
Affected tenants are those who meet all of the following criteria:
- Created before January 2, 2020
- Actively making requests to Auth0 endpoints directly under the
The following tenants are NOT affected:
- Created after January 2, 2020
- Exclusively using the Auth0 Management API v2 endpoints
- Using the Authentication API exclusively. (The Authentication API is not affected by this deprecation.)
How can I check to see if I've migrated all my requests?
Deprecation Notices will be recorded in your Tenant Logs for requests that will fail at API v1’s End of Life. You can search for relevant Deprecation Notices in your tenant logs with the following query:
type:depnote AND description:*APIv1*
To help identify the Application making requests, logs will include the
client_id used to make the request. You can also find the endpoint being used in the logs
Note that our current SDKs all use Management API v2. If you're seeing API v1 activity from an Application that is leveraging an older SDK, you should upgrade to the latest version.
For a complete list of breaking changes associated with this deprecation, see Management API v2 Changes.
How do I migrate?
After replacing all calls to the Management API v1 with their Management API v2 replacements, you should confirm you are no longer seeing Deprecation Notices in your Tenant Logs and disable the Management API v1 for your tenant.
You can disable API v1 by going Tenant Settings > Advanced > Migration in the Auth0 Dashboard. This will simulate the expected behavior after the End of Life date, causing calls to API v1 to fail with a
410 HTTP status code. You will be able to re-enable API v1 any time before the End of Life date.
By migrating your requests to API v2 and disabling API v1 as soon as possible, you will ensure that your systems will continue to operate uninterrupted after the July 13th, 2020 End of Life date, at which time the option to enable API v1 will be removed.