Update docs for email domain based organization discovery for self-registration.

en/identity-server/next/docs/apis/restapis/organization-discovery-config-mgt.yaml

@@ -91,6 +91,55 @@ paths:
                 ]
             }'
       x-codegen-request-body-name: body
+    put:
+      tags:
+        - Discovery
+      summary: Update organization discovery configuration.
+      description: |
+        This API provides the capability to update discovery configuration of the primary organization. <br>
+
+        <b>Scope(Permission) required:</b> `internal_organization_config_update`
+      operationId: updateDiscoveryConfig
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Config'
+      responses:
+        '200':
+          description: Successful Response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Config'
+        '400':
+          $ref: '#/components/responses/BadRequest'
+        '401':
+          $ref: '#/components/responses/Unauthorized'
+        '403':
+          $ref: '#/components/responses/Forbidden'
+        '500':
+          $ref: '#/components/responses/ServerError'
+      x-codeSamples:
+        - lang: Curl
+          source: |
+            curl --location  --request PUT 'https://localhost:9443/api/server/v1/organization-configs/discovery' \
+            -H 'Content-Type: application/json' \
+            -H 'Accept: application/json' \
+            -H 'Authorization: Basic YWRtaW46YWRtaW4=' \
+            -d '{
+                "properties": [
+                    {
+                        "key": "emailDomain.enable",
+                        "value": true
+                    },
+                    {
+                        "key": "emailDomainBasedSelfSignup.enable",
+                        "value": false
+                    }
+                ]
+            }'
+      x-codegen-request-body-name: body
     delete:
       tags:
         - Discovery
@@ -148,20 +197,22 @@ components:
         properties:
           type: array
           items:
-            $ref: '#/components/schemas/Properties'
-    Properties:
-      required:
-        - key
-        - value
-      type: object
-      properties:
-        key:
-          type: string
-          example: emailDomain.enable
-        value:
-          type: string
-          example: true
-
+            type: object
+            required:
+              - key
+              - value
+            properties:
+              key:
+                type: string
+                example: emailDomain.enable
+              value:
+                type: string
+                example: true
+          example:
+            - key: emailDomain.enable
+              value: true
+            - key: emailDomainBasedSelfSignup.enable
+              value: false
   responses:
     BadRequest:
       description: Invalid input in the request.

en/includes/guides/organization-management/email-domain-based-organization-discovery.md

@@ -27,8 +27,9 @@ and user Bob and Ben, with emails `[email protected]` and `[email protected]` should be
 ### Using the Console
 
 1. Login to the organization (root) from the {{ product_name }} Console.
-2. On the {{ product_name }} Console, go to **Login & Registration**, and click **Email Domain Discovery** under **Organization Settings**.
+2. On the {{ product_name }} Console, go to **Login & Registration**, and click **Organization Discovery** under **Organization Settings**.
 3. Turn on the toggle to enable email domain based organization discovery.
+4. Select the **Email domain discovery for self-registration** checkbox if you want to allow users to discover and self-register in sub-organizations based on their email domain.
 
     ![Enable email domain based organization discovery]({{base_path}}/assets/img/guides/organization/manage-organizations/enable-email-domain-based-organization-discovery.png){: width="700" style="display: block; margin: 0; border: 0.3px solid lightgrey;"}