Fix rendering of list in Dashboards Secure Embed description (#3423)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

Author: api-clients-generation-pipeline[bot]

.generator/schemas/v2/openapi.yaml

@@ -129945,10 +129945,15 @@ tags:
       organize, find, and share all of your dashboards with your team and
       organization.
     name: Dashboard Lists
-  - description: >-
-      Manage securely embedded Datadog dashboards. Secure embeds use HMAC-SHA256 signed sessions for authentication, enabling customers to embed dashboards in their own applications with server-side auth control. Unlike public dashboards (open URL) or invite dashboards (email-based access), secure embeds provide programmatic access control.
+  - description: |-
+      Manage securely embedded Datadog dashboards. Secure embeds use HMAC-SHA256 signed sessions
+      for authentication, enabling customers to embed dashboards in their own applications with
+      server-side auth control. Unlike public dashboards (open URL) or invite dashboards
+      (email-based access), secure embeds provide programmatic access control.
 
-      **Requirements:** - Org setting: SharedDashboards > Embed sharing must be enabled. - AuthN: Datadog API key and application key. - Read operations require `dashboards_read` permission. - Write operations require `dashboards_embed_share` permission.
+      **Requirements:**
+      - **Embed** sharing must be enabled under **Organization Settings** > **Public Sharing** > **Shared Dashboards**.
+      - You need [an API key and an application key](https://docs.datadoghq.com/account_management/api-app-keys/) to interact with these endpoints.
     name: Dashboard Secure Embed
   - description: |-
       The Data Deletion API allows the user to target and delete data from the allowed products. It's currently enabled for Logs and RUM and depends on `logs_delete_data` and `rum_delete_data` permissions respectively.

src/datadog_api_client/v2/api/dashboard_secure_embed_api.py

@@ -16,8 +16,15 @@
 
 class DashboardSecureEmbedApi:
     """
-    Manage securely embedded Datadog dashboards. Secure embeds use HMAC-SHA256 signed sessions for authentication, enabling customers to embed dashboards in their own applications with server-side auth control. Unlike public dashboards (open URL) or invite dashboards (email-based access), secure embeds provide programmatic access control.
-    **Requirements:** - Org setting: SharedDashboards > Embed sharing must be enabled. - AuthN: Datadog API key and application key. - Read operations require ``dashboards_read`` permission. - Write operations require ``dashboards_embed_share`` permission.
+    Manage securely embedded Datadog dashboards. Secure embeds use HMAC-SHA256 signed sessions
+    for authentication, enabling customers to embed dashboards in their own applications with
+    server-side auth control. Unlike public dashboards (open URL) or invite dashboards
+    (email-based access), secure embeds provide programmatic access control.
+
+    **Requirements:**
+
+    * **Embed** sharing must be enabled under **Organization Settings** > **Public Sharing** > **Shared Dashboards**.
+    * You need `an API key and an application key <https://docs.datadoghq.com/account_management/api-app-keys/>`_ to interact with these endpoints.
     """
 
     def __init__(self, api_client=None):

tests/v2/features/dashboard_secure_embed.feature

@@ -4,11 +4,11 @@ Feature: Dashboard Secure Embed
   signed sessions for authentication, enabling customers to embed dashboards
   in their own applications with server-side auth control. Unlike public
   dashboards (open URL) or invite dashboards (email-based access), secure
-  embeds provide programmatic access control. **Requirements:** - Org
-  setting: SharedDashboards > Embed sharing must be enabled. - AuthN:
-  Datadog API key and application key. - Read operations require
-  `dashboards_read` permission. - Write operations require
-  `dashboards_embed_share` permission.
+  embeds provide programmatic access control.  **Requirements:** - **Embed**
+  sharing must be enabled under **Organization Settings** > **Public
+  Sharing** > **Shared Dashboards**. - You need [an API key and an
+  application key](https://docs.datadoghq.com/account_management/api-app-
+  keys/) to interact with these endpoints.
 
   Background:
     Given a valid "apiKeyAuth" key in the system