Merge branch 'feat/DOCS-5492' of https://github.com/auth0/docs-v2 into feat/DOCS-5492

Author: SurajThotakura

.github/workflows/sync-agent-skills.yml

@@ -16,7 +16,7 @@ jobs:
 
     steps:
       - name: Checkout docs-v2
-        uses: actions/checkout@v4
+        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
 
       - name: Fetch latest skills from agent-skills
         run: |

.github/workflows/update-sdk-versions.yml

@@ -13,7 +13,7 @@ jobs:
       pull-requests: write
 
     steps:
-      - uses: actions/checkout@v6.0.2
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Fetch latest SDK releases and update libraries.mdx
         env:

.github/workflows/vale-check.yml

@@ -16,8 +16,8 @@ jobs:
       - name: Install mdx2vast
         run: npm install -g mdx2vast
 
-      - uses: actions/checkout@v4
-      - uses: errata-ai/vale-action@v2.1.1
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
+      - uses: errata-ai/vale-action@d89dee975228ae261d22c15adcd03578634d429c # v2.1.1
         with:
           files: '["auth4genai/"]'
           fail_on_error: true

auth4genai/mcp/get-started/call-your-apis-on-users-behalf.mdx

@@ -16,6 +16,7 @@ import MCPGetStartedCreateRoles from "/snippets/mcp/get-started/config-tenant/ro
 import CreateProfile from "/snippets/mcp/get-started/create-custom-token-exchange-profile.mdx";
 import CreateMCPAPI from "/snippets/mcp/get-started/create-mcp-api.mdx";
 import AssignPermissionsToRoles from "/snippets/mcp/get-started/config-tenant/assign-permissions-to-roles.mdx";
+import AssignDownstreamPermissionsToRoles from "/snippets/mcp/get-started/config-tenant/assign-downstream-permissions-to-roles.mdx";
 import { DownloadQuickstartButton } from "/snippets/download-quickstart/DownloadQuickstartButton.jsx";
 import MCPGetStartedTestingInstructions from "/snippets/mcp/get-started/testing-instructions.mdx";
 import CreateEnvFile from "/snippets/mcp/get-started/call-your-apis/create-env-file.mdx";
@@ -128,6 +129,8 @@ auth0 api post resource-servers --data '{
 
 Save the API identifier (audience) from the output; you'll configure it in your environment variables as `API_AUTH0_AUDIENCE`.
 
+<AssignDownstreamPermissionsToRoles />
+
 ## Sample app
 <Tabs>
   <Tab title="Javascript" icon="js">

auth4genai/snippets/mcp/get-started/config-tenant/assign-downstream-permissions-to-roles.mdx

@@ -0,0 +1,15 @@
+<Accordion title="Assign permissions to roles">
+
+After creating the downstream API and roles, assign the `read:private` permission to the roles.
+
+```shell wrap lines
+# Example for admin role
+auth0 roles permissions add YOUR_ADMIN_ROLE_ID --api-id "http://localhost:8787/" --permissions "read:private"
+
+# Example for user role
+auth0 roles permissions add YOUR_USER_ROLE_ID --api-id "http://localhost:8787/" --permissions "read:private"
+```
+
+Replace `YOUR_ADMIN_ROLE_ID` and `YOUR_USER_ROLE_ID` with the role IDs you saved when creating the roles.
+
+</Accordion>

main/config/navigation/customize.json

@@ -153,7 +153,8 @@
               "pages": [
                 "docs/customize/phone-messages/unified-phone/use-auth0s-unified-phone-experience-for-multi-factor-authentication",
                 "docs/customize/phone-messages/unified-phone/unified-phone-experience-passwordless",
-                "docs/customize/phone-messages/unified-phone/configure-unified-phone"
+                "docs/customize/phone-messages/unified-phone/configure-unified-phone",
+                "docs/customize/phone-messages/unified-phone/migrate-to-unified-phone-experience-with-terraform"
               ]
             },
             {

main/config/navigation/manage-users.json

@@ -78,7 +78,6 @@
             "docs/manage-users/user-migration/bulk-user-import-schema",
             "docs/manage-users/user-migration/bulk-user-exports",
             "docs/manage-users/user-migration/export-password-hashes-and-mfa-secrets",
-            "docs/manage-users/user-migration/user-import-export-extension",
             "docs/manage-users/user-migration/user-migration-scenarios",
             "docs/manage-users/user-migration/bulk-user-import-export"
           ]

main/config/navigation/secure.json

@@ -351,12 +351,36 @@
       "pages": [
         {
           "group": "Tenant Access Control List",
+          "root": "docs/secure/tenant-access-control-list",
+          "directory": "accordion",
           "pages": [
-            "docs/secure/tenant-access-control-list",
-            "docs/secure/tenant-access-control-list/configure-rules",
-            "docs/secure/tenant-access-control-list/manage-rules-in-dashboard",
-            "docs/secure/tenant-access-control-list/use-cases",
-            "docs/secure/tenant-access-control-list/reference"
+            {
+            
+              "group": "How To",
+              "expanded": true,
+              "pages": [
+                "docs/secure/tenant-access-control-list/configure-rules",
+                "docs/secure/tenant-access-control-list/enable-monitoring-mode"
+              ]
+            },
+            {
+            
+              "group": "Details",
+              "expanded": true,
+              "pages": [
+                "docs/secure/tenant-access-control-list/rule-evaluation",
+                "docs/secure/tenant-access-control-list/limits"
+              ]
+            },
+            {
+              "group": "Reference",
+              "expanded": true,
+              "pages": [
+                "docs/secure/tenant-access-control-list/use-cases",
+                "docs/secure/tenant-access-control-list/reference",
+                "docs/secure/tenant-access-control-list/tenant-log-event-reference"
+              ]
+            }
           ]
         }
       ]

main/config/redirects.json

@@ -22714,5 +22714,13 @@
   {
     "source": "/docs/get-started/universal-components/my-account/factors/passkeys",
     "destination": "/docs/get-started/universal-components/ios/components/factors/passkeys"
+  },
+  {
+    "source": "/docs/secure/tenant-access-control-list/manage-rules-in-dashboard",
+    "destination": "/docs/secure/tenant-access-control-list/configure-rules"
+  },
+  {
+    "source": "/docs/manage-users/user-migration/user-import-export-extension",
+    "destination": "/docs/manage-users/user-migration/bulk-user-import-export"
   }
 ]

main/docs/authenticate/database-connections/passkeys/native-passkeys-for-mobile-applications.mdx

@@ -55,7 +55,7 @@ For end users to authenticate with a single passkey with across different applic
 
 1. Navigate to [Applications > Applications](https://manage.auth0.com/#/applications) and select the application you wish to update.
 2. At the bottom of the Settings tab, select **Advanced Settings**. Then, choose the **Device Settings** tab.
-3. Complete the **iOS** and **Android** sections as needed for your application. Then, click **Save Changes**.
+3. Complete the **iOS** or **Android** sections as needed for your application. Then, click **Save Changes**.
 4. In the Advanced Settings section, select the **Grant Types** tab.
 5. Enable the **Passkey** grant, then select **Save Changes**.