Fix openAPI docs

Author: paul-tavares

x-pack/solutions/security/plugins/security_solution/common/api/endpoint/scripts_library/list_scripts.schema.yaml

@@ -16,21 +16,25 @@ paths:
         - name: page
           in: query
           required: false
+          description: Page number of the results to return. Defaults to 1.
           schema:
             $ref: '../model/schema/common.schema.yaml#/components/schemas/Page'
         - name: pageSize
           in: query
           required: false
+          description: Number of results to return per page. Defaults to 10. Max value is 1000.
           schema:
             $ref: '#/components/schemas/ApiPageSize'
         - name: sortField
           in: query
           required: false
+          description: The field to sort the results by. Defaults to name.
           schema:
             $ref: '#/components/schemas/ApiSortField'
         - name: sortDirection
           in: query
           required: false
+          description: The direction to sort the results by. Defaults to asc (ascending).
           schema:
             $ref: '../model/schema/common.schema.yaml#/components/schemas/SortDirection'
         - name: kuery
@@ -66,6 +70,16 @@ paths:
                     type: array
                     items:
                       $ref: './common.yaml#/components/schemas/EndpointScript'
+              examples:
+                response:
+                  summary: List of scripts response example
+                  value:
+                    page: 1
+                    pageSize: 10
+                    total: 100
+                    sortField: name
+                    sortDirection: asc
+                    data: []
 
 
 components: