Auth0 End-of-Life Rollout: Allow Connections Management without Options Scopes

Auth0 Management API access to a connection's options field now requires options-specific scopes, as operating without them is deprecated and has reached end-of-life. The content below outlines the rollout phases, affected endpoints, and migration path.

Rollout Transitions Tenants in Phases

The phase dates mark the beginning of each sequential rollout stage. Each phase may take several weeks, so tenants within the same phase may receive the change at different times.

#

Date

Version

Scope

1

May 5, 2025

N/A

Force new behavior in tenants on free subscriptions.

2

July 8, 2025

N/A

Force new behavior in development and staging tenants.

3

July 27, 2026

202631

Default remaining tenants, including production, to the new behavior.

4

Sep 29, 2026

202640

Force new behavior in all remaining tenants, including production, and remove the ability to revert via migration toggle.

The end-of-life rollout concluded on November 2, 2026, and by that date, all tenants had transitioned to the updated behavior. The respective migration toggle is no longer available in the Auth0 Dashboard (Tenant Settings > Advanced) because the updated behavior is now in effect across all Auth0 tenants.

Which Endpoints Require the Options-Specific Scopes?

Once a tenant transitions to the new behavior, accessing or updating a connection's options field requires the corresponding options-specific scopes in the following connection management operations:

Without the read:connections_options scope, the options field is omitted from GET response payloads. Without the update:connections_options scope, PATCH requests that include the options field receive a 403 Forbidden response:

{
  "statusCode": 403,
  "error": "Forbidden",
  "message": "Updating the \"options\" property requires the \ "update:connections_options\" scope.",
  "errorCode": "insufficient_scope"
}

Options-Specific Scopes Provide Finer-Grained Access Control

The new scopes provide increased control over application access to connection data. Update authorization grants for client applications that read or update a connection's options field to include the additional options-specific scopes alongside the previously required scopes:

  • Add read:connections_options in addition to read:connections for GET operations that need to return the options field.

  • Add update:connections_options in addition to update:connections for PATCH operations that include the options field.

Adding Options-Specific Scopes to a Client Application Grant

To add the required scopes using the Auth0 Dashboard:

  1. Navigate to Applications > Applications and choose the application that requires calling the relevant Management API endpoints.

  2. Select the API Access tab. Then, select Edit next to Auth0 Management API to open the permission management panel.

  3. In the Client Access tab, search for connections_options. Enable one or both of the new permissions. Then, choose Save to confirm the changes.

Why is Auth0 Making these Changes?

Auth0 updated this behavior as part of a calendar-year 2025 change to improve access control for connection management endpoints. The change was announced on October 25, 2024, via product notification, with a target end-of-life date of April 24, 2025.

Recommended content

No recommended content found...