diff --git a/static/api-specs/idn/beta/paths/schema.yaml b/static/api-specs/idn/beta/paths/schema.yaml
index fa0f24903..4d8a82d22 100644
--- a/static/api-specs/idn/beta/paths/schema.yaml
+++ b/static/api-specs/idn/beta/paths/schema.yaml
@@ -102,24 +102,21 @@ patch:
   tags:
     - Sources
   summary: Update Source Schema (Partial)
-  description: >-
+  description: |
     Use this API to selectively update an existing Schema using a JSONPatch payload. 
     
     The following schema fields are immutable and cannot be updated:
 
-    * id
-
-    * name
-
-    * created
-
-    * modified
+    - id
+    - name
+    - created
+    - modified
 
 
-    To switch an account attribute to a group, you need to have the following in place:
+    To switch an account attribute to a group entitlement, you need to have the following in place:
 
-    * `isEntitlement: true`
-    * Must define a schema for the group and [add it to the source](https://developer.sailpoint.com/idn/api/v3/create-schema) before updating the `isGroup` flag.  For example, here is the `group` account attribute referencing a schema that defines the group:
+    - `isEntitlement: true`
+    - Must define a schema for the group and [add it to the source](https://developer.sailpoint.com/idn/api/v3/create-schema) before updating the `isGroup` flag.  For example, here is the `group` account attribute referencing a schema that defines the group:
     ```json
     {
         "name": "groups",
diff --git a/static/api-specs/idn/v3/paths/schema.yaml b/static/api-specs/idn/v3/paths/schema.yaml
index 2bf660098..41a129ccd 100644
--- a/static/api-specs/idn/v3/paths/schema.yaml
+++ b/static/api-specs/idn/v3/paths/schema.yaml
@@ -101,24 +101,21 @@ patch:
   tags:
     - Sources
   summary: Update Source Schema (Partial)
-  description: >-
+  description: |
     Use this API to selectively update an existing Schema using a JSONPatch payload. 
     
     The following schema fields are immutable and cannot be updated:
 
-    * id
-
-    * name
-
-    * created
-
-    * modified
+    - id
+    - name
+    - created
+    - modified
 
 
-    To switch an account attribute to a group, you need to have the following in place:
+    To switch an account attribute to a group entitlement, you need to have the following in place:
 
-    * `isEntitlement: true`
-    * Must define a schema for the group and [add it to the source](https://developer.sailpoint.com/idn/api/v3/create-schema) before updating the `isGroup` flag.  For example, here is the `group` account attribute referencing a schema that defines the group:
+    - `isEntitlement: true`
+    - Must define a schema for the group and [add it to the source](https://developer.sailpoint.com/idn/api/v3/create-schema) before updating the `isGroup` flag.  For example, here is the `group` account attribute referencing a schema that defines the group:
     ```json
     {
         "name": "groups",