Update API docs on service change

Author: CDO Jenkins

openapi.yaml

@@ -5653,6 +5653,7 @@ components:
                 - uid
             type: object
         ActiveDirectoryGroup:
+            description: The list of items retrieved.
             properties:
                 groupIdentifier:
                     description: The unique identifier of the user group in your Identity Provider (IdP).
@@ -5681,11 +5682,11 @@ components:
         ActiveDirectoryGroupCreateOrUpdateInput:
             properties:
                 groupIdentifier:
-                    description: The unique identifier, represented as a UUID, of the Active Directory Group in your Identity Provider (IdP).
+                    description: The object ID of the Active Directory group in your Identity Provider (IdP), or the group name in the IdP if the ID is unavailable.
                     example: 7131daad-e813-4b8f-8f42-be1e241e8cdb
                     type: string
                 issuerUrl:
-                    description: The Identity Provider (IdP) URL, which Cisco Defense Orchestrator will use to validate SAML assertions during the sign-in process.
+                    description: The Identity Provider (IdP) URL, which Cisco Security Cloud Control will use to validate SAML assertions during the sign-in process.
                     example: https://access.example.com/saml2/idp/metadata.php
                     type: string
                 name:
@@ -9621,6 +9622,7 @@ components:
                 - url
             type: object
         User:
+            description: The list of items retrieved.
             properties:
                 apiOnlyUser:
                     description: Whether the user is API-only, an API-only user cannot access Security Cloud Control in the UI.
@@ -9707,7 +9709,7 @@ components:
                     type: integer
             type: object
         UserRole:
-            description: The role of the user this token belongs to. The user can be API-only or a human.
+            description: This determines the role for all the users included in this Active Directory Group.
             enum:
                 - ROLE_ADMIN
                 - ROLE_SUPER_ADMIN
@@ -9716,6 +9718,7 @@ components:
                 - ROLE_EDIT_ONLY
                 - ROLE_VPN_SESSIONS_MANAGER
                 - ROLE_FWAAS
+            example: ROLE_ADMIN
             type: string
         VpnHealthMetrics:
             description: The vpn health metrics for the device.