Replace SpringFox with SpringDoc in CLAMP

This commit:
- Remove springfox from CLAMP
- updates the commissioning, AC Element, and K8S particiapnt to use the
  generated interface rather than the hard coded one
- removes swagger annotations from handwritten code
- implements SpringDoc for the <base_path>/v3/api-docs on endpoints

Issue-ID: POLICY-4404
Change-Id: I49f48bc7828cb49dab854ef9ed16a9aa377983e1
Signed-off-by: liamfallon <liam.fallon@est.tech>

20 files changed, 980 insertions, 254 deletions

diff --git a/participant/participant-impl/participant-impl-acelement/pom.xml b/participant/participant-impl/participant-impl-acelement/pom.xml
index 0349dfd64..9ff4d109a 100644
--- a/participant/participant-impl/participant-impl-acelement/pom.xml
+++ b/participant/participant-impl/participant-impl-acelement/pom.xml
@@ -36,6 +36,36 @@
     <build>
         <plugins>
             <plugin>
+                <groupId>io.swagger.codegen.v3</groupId>
+                <artifactId>swagger-codegen-maven-plugin</artifactId>
+                <version>${version.swagger.codegen.v3}</version>
+                <executions>
+                    <execution>
+                        <id>code-gen</id>
+                        <goals>
+                            <goal>generate</goal>
+                        </goals>
+                        <configuration>
+                            <inputSpec>${project.basedir}/src/main/resources/openapi/openapi.yaml</inputSpec>
+                            <invokerPackage>org.onap.policy.clamp.acm.runtime.main.rest</invokerPackage>
+                            <apiPackage>org.onap.policy.clamp.acm.element.main.rest.genapi</apiPackage>
+                            <language>spring</language>
+                            <generateModels>false</generateModels>
+                            <generateSupportingFiles>false</generateSupportingFiles>
+                            <importMappings>
+                                ElementConfig=org.onap.policy.clamp.models.acm.messages.rest.element.ElementConfig
+                            </importMappings>
+                            <configOptions>
+                                <sourceFolder>src/gen/java</sourceFolder>
+                                <dateLibrary>java11</dateLibrary>
+                                <interfaceOnly>true</interfaceOnly>
+                                <useTags>true</useTags>
+                            </configOptions>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
                 <groupId>org.springframework.boot</groupId>
                 <artifactId>spring-boot-maven-plugin</artifactId>
                 <executions>
diff --git a/participant/participant-impl/participant-impl-acelement/src/main/java/org/onap/policy/clamp/acm/element/config/SpringFoxConfig.java b/participant/participant-impl/participant-impl-acelement/src/main/java/org/onap/policy/clamp/acm/element/config/SpringDocBean.java
index 4e88e364a..11696093a 100644
--- a/participant/participant-impl/participant-impl-acelement/src/main/java/org/onap/policy/clamp/acm/element/config/SpringFoxConfig.java
+++ b/participant/participant-impl/participant-impl-acelement/src/main/java/org/onap/policy/clamp/acm/element/config/SpringDocBean.java
@@ -20,27 +20,29 @@
 
 package org.onap.policy.clamp.acm.element.config;
 
-import org.onap.policy.clamp.acm.element.main.rest.AcElementController;
+import io.swagger.v3.oas.models.ExternalDocumentation;
+import io.swagger.v3.oas.models.OpenAPI;
+import io.swagger.v3.oas.models.info.Info;
+import io.swagger.v3.oas.models.info.License;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
-import springfox.documentation.builders.PathSelectors;
-import springfox.documentation.builders.RequestHandlerSelectors;
-import springfox.documentation.spi.DocumentationType;
-import springfox.documentation.spring.web.plugins.Docket;
 
 @Configuration
-public class SpringFoxConfig {
+public class SpringDocBean {
 
     /**
-     * Docket Spring Fox Config.
+     * Bean to configure Springdoc.
      *
-     * @return Docket
+     * @return the OpenAPI specification
      */
     @Bean
-    public Docket api() {
-        return new Docket(DocumentationType.SWAGGER_2).select()
-                .apis(RequestHandlerSelectors.basePackage(AcElementController.class.getPackageName()))
-                .paths(PathSelectors.any()).build();
+    public OpenAPI acmElementParticipantOpenApi() {
+        return new OpenAPI()
+                .info(new Info().title("ACM Element Test Participant")
+                .description("CLAMP Automation Composition Management Element Test Participant API")
+                .license(new License().name("Apache 2.0").url("http://www.apache.org/licenses/LICENSE-2.0")))
+                .externalDocs(new ExternalDocumentation()
+                .description("CLAMP Automation Composition Management Documentation")
+                .url("https://docs.onap.org/projects/onap-policy-parent/en/latest/clamp/clamp.html"));
     }
 }
-
diff --git a/participant/participant-impl/participant-impl-acelement/src/main/java/org/onap/policy/clamp/acm/element/main/parameters/ElementTopicParameters.java b/participant/participant-impl/participant-impl-acelement/src/main/java/org/onap/policy/clamp/acm/element/main/parameters/ElementTopicParameters.java
index 21394401c..d42b0d196 100644
--- a/participant/participant-impl/participant-impl-acelement/src/main/java/org/onap/policy/clamp/acm/element/main/parameters/ElementTopicParameters.java
+++ b/participant/participant-impl/participant-impl-acelement/src/main/java/org/onap/policy/clamp/acm/element/main/parameters/ElementTopicParameters.java
@@ -22,10 +22,12 @@ package org.onap.policy.clamp.acm.element.main.parameters;
 
 import java.util.List;
 import lombok.Data;
+import lombok.EqualsAndHashCode;
 import org.onap.policy.clamp.models.acm.messages.rest.element.DmaapConfig;
 import org.onap.policy.common.endpoints.parameters.TopicParameters;
 
 @Data
+@EqualsAndHashCode(callSuper = false)
 public class ElementTopicParameters extends TopicParameters {
 
     /**
diff --git a/participant/participant-impl/participant-impl-acelement/src/main/java/org/onap/policy/clamp/acm/element/main/rest/AbstractRestController.java b/participant/participant-impl/participant-impl-acelement/src/main/java/org/onap/policy/clamp/acm/element/main/rest/AbstractRestController.java
deleted file mode 100644
index 369342b11..000000000
--- a/participant/participant-impl/participant-impl-acelement/src/main/java/org/onap/policy/clamp/acm/element/main/rest/AbstractRestController.java
+++ /dev/null
@@ -1,67 +0,0 @@
-/*-
- * ============LICENSE_START=======================================================
- * Copyright (C) 2022 Nordix Foundation.
- * ================================================================================
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * SPDX-License-Identifier: Apache-2.0
- * ============LICENSE_END=========================================================
- */
-
-package org.onap.policy.clamp.acm.element.main.rest;
-
-import javax.ws.rs.core.MediaType;
-import org.springframework.web.bind.annotation.RequestMapping;
-
-/**
- * Common superclass to provide REST endpoints for the AC element.
- */
-// @formatter:off
-@RequestMapping(
-        value = "/onap/policy/clamp/acelement/v2",
-        produces = {
-            MediaType.APPLICATION_JSON,
-            AbstractRestController.APPLICATION_YAML
-        }
-)
-// @formatter:on
-public abstract class AbstractRestController {
-    public static final String APPLICATION_YAML = "application/yaml";
-
-    public static final String API_VERSION_NAME = "api-version";
-
-    public static final String VERSION_MINOR_NAME = "X-MinorVersion";
-    public static final String VERSION_MINOR_DESCRIPTION =
-            "Used to request or communicate a MINOR version back from the client"
-                    + " to the server, and from the server back to the client";
-
-    public static final String VERSION_PATCH_NAME = "X-PatchVersion";
-    public static final String VERSION_PATCH_DESCRIPTION = "Used only to communicate a PATCH version in a response for"
-            + " troubleshooting purposes only, and will not be provided by" + " the client on request";
-
-    public static final String VERSION_LATEST_NAME = "X-LatestVersion";
-    public static final String VERSION_LATEST_DESCRIPTION = "Used only to communicate an API's latest version";
-
-    public static final String REQUEST_ID_NAME = "X-ONAP-RequestID";
-    public static final String REQUEST_ID_HDR_DESCRIPTION = "Used to track REST transactions for logging purpose";
-
-    public static final String OK_CODE = "200";
-    public static final String CREATED_CODE = "201";
-    public static final String NO_CONTENT_CODE = "204";
-    public static final String AUTHENTICATION_ERROR_CODE = "401";
-    public static final String BAD_REQUEST_ERROR_CODE = "400";
-
-    public static final String AUTHENTICATION_ERROR_MESSAGE = "Authentication Error";
-    public static final String BAD_REQUEST_ERROR_MESSAGE = "Bad request";
-    public static final String SERVER_OK_MESSAGE = "Success";
-}
\ No newline at end of file
diff --git a/participant/participant-impl/participant-impl-acelement/src/main/java/org/onap/policy/clamp/acm/element/main/rest/AcElementController.java b/participant/participant-impl/participant-impl-acelement/src/main/java/org/onap/policy/clamp/acm/element/main/rest/AcElementController.java
index afe864edc..021567a7b 100644
--- a/participant/participant-impl/participant-impl-acelement/src/main/java/org/onap/policy/clamp/acm/element/main/rest/AcElementController.java
+++ b/participant/participant-impl/participant-impl-acelement/src/main/java/org/onap/policy/clamp/acm/element/main/rest/AcElementController.java
@@ -20,117 +20,49 @@
 
 package org.onap.policy.clamp.acm.element.main.rest;
 
-import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.headers.Header;
-import io.swagger.v3.oas.annotations.media.Content;
-import io.swagger.v3.oas.annotations.media.Schema;
-import io.swagger.v3.oas.annotations.responses.ApiResponse;
-import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import java.util.UUID;
 import lombok.RequiredArgsConstructor;
+import org.onap.policy.clamp.acm.element.main.rest.genapi.AcElementControllerApi;
 import org.onap.policy.clamp.acm.element.service.ConfigService;
 import org.onap.policy.clamp.models.acm.messages.rest.element.ElementConfig;
 import org.springframework.http.HttpStatus;
-import org.springframework.http.MediaType;
 import org.springframework.http.ResponseEntity;
-import org.springframework.web.bind.annotation.DeleteMapping;
-import org.springframework.web.bind.annotation.GetMapping;
-import org.springframework.web.bind.annotation.PostMapping;
-import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RestController;
 
 @RestController
 @RequiredArgsConstructor
-public class AcElementController extends AbstractRestController {
+public class AcElementController implements AcElementControllerApi {
 
     private final ConfigService configService;
 
     /**
-     * REST endpoint to get the existing element config.
+     * REST end point to get the existing element configuration.
      *
-     * @return the element config params
+     * @return the element configuration parameters
      */
-    // @formatter:off
-    @GetMapping(path = "/config", produces = MediaType.APPLICATION_JSON_VALUE)
-    @Operation(summary = "Return the element config",
-        tags = { "Clamp Automation Composition AC Element Impl API" })
-    @ApiResponses(
-        value = {
-            @ApiResponse(responseCode = OK_CODE, description = SERVER_OK_MESSAGE,
-                    content = @Content(schema = @Schema(implementation = ElementConfig.class)),
-                    headers = {
-                        @Header(name = API_VERSION_NAME),
-                        @Header(name = VERSION_MINOR_NAME, description = VERSION_MINOR_DESCRIPTION),
-                        @Header(name = VERSION_PATCH_NAME, description = VERSION_PATCH_DESCRIPTION),
-                        @Header(name = VERSION_PATCH_NAME, description = VERSION_PATCH_DESCRIPTION),
-                        @Header(name = VERSION_LATEST_NAME, description = VERSION_LATEST_DESCRIPTION),
-                        @Header(name = REQUEST_ID_NAME, description = REQUEST_ID_HDR_DESCRIPTION)
-                    }),
-            @ApiResponse(responseCode = AUTHENTICATION_ERROR_CODE, description = AUTHENTICATION_ERROR_MESSAGE)
-        }
-    )
-    // @formatter:on
-    public ResponseEntity<ElementConfig> getElementConfig() {
+    @Override
+    public ResponseEntity<ElementConfig> getElementConfig(UUID onapRequestId) {
         return new ResponseEntity<>(configService.getElementConfig(), HttpStatus.OK);
     }
 
     /**
-     * REST endpoint to activate the element.
+     * REST end point to activate the element.
      *
-     * @param params element parameters for this ac element
+     * @param params element parameters for this AC element
      */
-    // @formatter:off
-    @PostMapping(path = "/activate", consumes = MediaType.APPLICATION_JSON_VALUE,
-        produces = MediaType.APPLICATION_JSON_VALUE)
-    @Operation(summary = "Activates the element config",
-        tags = { "Clamp Automation Composition AC Element Impl API" }
-    )
-    @ApiResponses(
-        value = {
-            @ApiResponse(responseCode = CREATED_CODE, description = SERVER_OK_MESSAGE,
-                    headers = {
-                        @Header(name = API_VERSION_NAME),
-                        @Header(name = VERSION_MINOR_NAME, description = VERSION_MINOR_DESCRIPTION),
-                        @Header(name = VERSION_PATCH_NAME, description = VERSION_PATCH_DESCRIPTION),
-                        @Header(name = VERSION_PATCH_NAME, description = VERSION_PATCH_DESCRIPTION),
-                        @Header(name = VERSION_LATEST_NAME, description = VERSION_LATEST_DESCRIPTION),
-                        @Header(name = REQUEST_ID_NAME, description = REQUEST_ID_HDR_DESCRIPTION)
-                    }),
-            @ApiResponse(responseCode = AUTHENTICATION_ERROR_CODE, description = AUTHENTICATION_ERROR_MESSAGE),
-            @ApiResponse(responseCode = BAD_REQUEST_ERROR_CODE, description = BAD_REQUEST_ERROR_MESSAGE)
-        }
-    )
-    // formatter:on
-    public ResponseEntity<Object> activateElement(@RequestBody ElementConfig params) {
+    @Override
+    public ResponseEntity<String> activateElement(UUID onapRequestId, ElementConfig params) {
         configService.activateElement(params);
         return new ResponseEntity<>(HttpStatus.CREATED);
     }
 
     /**
-     * REST endpoint to delete the element config.
+     * REST end point to delete the element configuration.
      *
      * @return Status of operation
      */
-    // @formatter:off
-    @DeleteMapping(path = "/deactivate")
-    @Operation(summary = "Delete the element config",
-        tags = { "Clamp Automation Composition AC Element Impl API" }
-    )
-    @ApiResponses(
-        value = {
-            @ApiResponse(responseCode = NO_CONTENT_CODE, description = SERVER_OK_MESSAGE,
-                    headers = {
-                        @Header(name = API_VERSION_NAME),
-                        @Header(name = VERSION_MINOR_NAME, description = VERSION_MINOR_DESCRIPTION),
-                        @Header(name = VERSION_PATCH_NAME, description = VERSION_PATCH_DESCRIPTION),
-                        @Header(name = VERSION_PATCH_NAME, description = VERSION_PATCH_DESCRIPTION),
-                        @Header(name = VERSION_LATEST_NAME, description = VERSION_LATEST_DESCRIPTION),
-                        @Header(name = REQUEST_ID_NAME, description = REQUEST_ID_HDR_DESCRIPTION)
-                    }),
-            @ApiResponse(responseCode = AUTHENTICATION_ERROR_CODE, description = AUTHENTICATION_ERROR_MESSAGE)
-        }
-    )
-    // @formatter:on
-    public ResponseEntity<Void> deleteConfig() {
+    @Override
+    public ResponseEntity<Void> deleteConfig(UUID onapRequestId) {
         configService.deleteConfig();
         return new ResponseEntity<>(HttpStatus.NO_CONTENT);
     }
diff --git a/participant/participant-impl/participant-impl-acelement/src/main/resources/config/application.yaml b/participant/participant-impl/participant-impl-acelement/src/main/resources/config/application.yaml
index 4d7710304..c32680602 100644
--- a/participant/participant-impl/participant-impl-acelement/src/main/resources/config/application.yaml
+++ b/participant/participant-impl/participant-impl-acelement/src/main/resources/config/application.yaml
@@ -3,9 +3,16 @@ spring:
     user:
       name: ${REST_USER:acmUser}
       password: ${REST_PASSWORD:zb!XztG34}
+  autoconfigure:
+    exclude: >
+      org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration,
+      org.springframework.boot.autoconfigure.orm.jpa.HibernateJpaAutoConfiguration,
+      org.springframework.boot.autoconfigure.jdbc.DataSourceTransactionManagerAutoConfiguration
 
 server:
   port: ${PORT:8084}
+  servlet:
+    context-path: /onap/policy/clamp/acelement/v2
   error:
     path: /error
 
@@ -13,6 +20,7 @@ element:
   elementId:
     name: ${ELEMENT_ID:onap.policy.clamp.ac.element1}
     version: ${ELEMENT_VERSION:1.0.0}
+
 management:
   endpoints:
     web:
diff --git a/participant/participant-impl/participant-impl-acelement/src/main/resources/openapi/openapi.yaml b/participant/participant-impl/participant-impl-acelement/src/main/resources/openapi/openapi.yaml
new file mode 100644
index 000000000..a3ccd1865
--- /dev/null
+++ b/participant/participant-impl/participant-impl-acelement/src/main/resources/openapi/openapi.yaml
@@ -0,0 +1,242 @@
+openapi: 3.0.3
+info:
+  title: ACM Element Test Participant
+  description: ApiCLAMP Automation Composition Management Element Test Participant API
+  contact:
+    name: ONAP Support
+    url: https://lists.onap.org/g/onap-discuss
+    email: onap-discuss@lists.onap.org
+  license:
+    name: Apache 2.0
+    url: http://www.apache.org/licenses/LICENSE-2.0
+  version: '1.0'
+externalDocs:
+  description: CLAMP Automation Composition Management Documentation
+  url: https://docs.onap.org/projects/onap-policy-parent/en/latest/clamp/clamp.html
+servers:
+  - url: http:{port}/{server}
+    variables:
+      port:
+        default: "30296"
+        description: This value is assigned by the service provider
+      server:
+        default: /onap/policy/clamp/acelement/v2
+        description: This value is assigned by the service provider
+tags:
+  - name: ac-element-controller
+    description: Automation Composition Element Test Participant controller
+paths:
+  /config:
+    get:
+      tags:
+        - ac-element-controller
+      summary: Return the element configuration
+      description: Return the configuraiton of this AC element
+      operationId: getElementConfig
+      parameters:
+      - name: X-onap-RequestId
+        in: header
+        description: RequestID for http transaction
+        schema:
+          type: string
+          format: uuid
+      responses:
+        200:
+          description: OK, serialised instance of
+            [ElementConfig](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/element/ElementConfig.java)
+          headers:
+            api-version:
+              schema:
+                type: string
+            X-LatestVersion:
+              schema:
+                type: string
+                description: Used only to communicate an API's latest version
+            X-PatchVersion:
+              schema:
+                type: string
+                description:
+                  Used only to communicate a PATCH version in a response for troubleshooting purposes only,
+                  and will not be provided by the client on request
+            X-MinorVersion:
+              schema:
+                type: string
+                description:
+                  Used to request or communicate a MINOR version back from the client
+                  to the server, and from the server back to the client
+            X-onap-RequestId:
+              schema:
+                type: string
+                format: uuid
+                description: Used to track REST transactions for logging purposes
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ElementConfig'
+            application/yaml:
+              schema:
+                $ref: '#/components/schemas/ElementConfig'
+        401:
+          description: Authorization Error
+        404:
+          description: Not Found
+        500:
+          description: Internal Server Error
+      security:
+        - basicAuth: []
+  /activate:
+    post:
+      tags:
+        - ac-element-controller
+      summary: Activates the element configuration
+      description: >-
+        Activates a configuration on an Automation Composition Element
+      operationId: activateElement
+      parameters:
+      - name: X-onap-RequestId
+        in: header
+        description: RequestID for http transaction
+        schema:
+          type: string
+          format: uuid
+      requestBody:
+        description: The AC element configuration to apply in a serialised instance of
+            [ElementConfig](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/element/ElementConfig.java)
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/ElementConfig'
+          application/yaml:
+            schema:
+              $ref: '#/components/schemas/ElementConfig'
+      responses:
+        201:
+          description: OK, configuration has been created
+          headers:
+            api-version:
+              schema:
+                type: string
+            X-LatestVersion:
+              schema:
+                type: string
+                description: Used only to communicate an API's latest version
+            X-PatchVersion:
+              schema:
+                type: string
+                description:
+                  Used only to communicate a PATCH version in a response for troubleshooting purposes only,
+                  and will not be provided by the client on request
+            X-MinorVersion:
+              schema:
+                type: string
+                description:
+                  Used to request or communicate a MINOR version back from the client
+                  to the server, and from the server back to the client
+            X-onap-RequestId:
+              schema:
+                type: string
+                format: uuid
+                description: Used to track REST transactions for logging purposes
+          content:
+            application/json:
+              schema:
+                type: string
+              example: Success
+            application/yaml:
+              schema:
+                type: string
+              example: Success
+        400:
+          description: Bad Request
+        401:
+          description: Authorization Error
+        500:
+          description: Internal Server Error
+      security:
+        - basicAuth: []
+  /deactivate:
+    delete:
+      tags:
+        - ac-element-controller
+      summary: Delete the AC element configuration
+      description: Deletes the configuration of an Automation Composition Element
+      operationId: deleteConfig
+      parameters:
+      - name: X-onap-RequestId
+        in: header
+        description: RequestID for http transaction
+        schema:
+          type: string
+          format: uuid
+      responses:
+        204:
+          description: No Content
+          headers:
+            api-version:
+              schema:
+                type: string
+            X-LatestVersion:
+              schema:
+                type: string
+                description: Used only to communicate an API's latest version
+            X-PatchVersion:
+              schema:
+                type: string
+                description:
+                  Used only to communicate a PATCH version in a response for troubleshooting purposes only,
+                  and will not be provided by the client on request
+            X-MinorVersion:
+              schema:
+                type: string
+                description:
+                  Used to request or communicate a MINOR version back from the client
+                  to the server, and from the server back to the client
+            X-onap-RequestId:
+              schema:
+                type: string
+                format: uuid
+                description: Used to track REST transactions for logging purposes
+        400:
+          description: Bad Request
+        401:
+          description: Authorization Error
+        409:
+          description: Not Defined, the elemet type is not defined
+          headers:
+            api-version:
+              schema:
+                type: string
+            X-LatestVersion:
+              schema:
+                type: string
+                description: Used only to communicate an API's latest version
+            X-PatchVersion:
+              schema:
+                type: string
+                description:
+                  Used only to communicate a PATCH version in a response for troubleshooting purposes only,
+                  and will not be provided by the client on request
+            X-MinorVersion:
+              schema:
+                type: string
+                description:
+                  Used to request or communicate a MINOR version back from the client
+                  to the server, and from the server back to the client
+            X-onap-RequestId:
+              schema:
+                type: string
+                format: uuid
+                description: Used to track REST transactions for logging purposes
+        500:
+          description: Internal Server Error
+      security:
+        - basicAuth: []
+components:
+  securitySchemes:
+    basicAuth:
+      type: http
+      scheme: basic
+  schemas:
+    ElementConfig:
+      title: ElementConfig
+      type: object
diff --git a/participant/participant-impl/participant-impl-acelement/src/test/java/org/onap/policy/clamp/acm/element/rest/AcElementControllerTest.java b/participant/participant-impl/participant-impl-acelement/src/test/java/org/onap/policy/clamp/acm/element/rest/AcElementControllerTest.java
index 001b2be3b..1d19b1a17 100644
--- a/participant/participant-impl/participant-impl-acelement/src/test/java/org/onap/policy/clamp/acm/element/rest/AcElementControllerTest.java
+++ b/participant/participant-impl/participant-impl-acelement/src/test/java/org/onap/policy/clamp/acm/element/rest/AcElementControllerTest.java
@@ -67,9 +67,9 @@ class AcElementControllerTest {
 
     private static final Coder CODER = new StandardCoder();
     private static final String ELEMENT_CONFIG_YAML = "src/test/resources/config.json";
-    private static final String RETRIEVE_CONFIG = "/onap/policy/clamp/acelement/v2/config";
-    private static final String ACTIVATE_CONFIG = "/onap/policy/clamp/acelement/v2/activate";
-    private static final String DEACTIVATE_CONFIG = "/onap/policy/clamp/acelement/v2/deactivate";
+    private static final String RETRIEVE_CONFIG = "/config";
+    private static final String ACTIVATE_CONFIG = "/activate";
+    private static final String DEACTIVATE_CONFIG = "/deactivate";
     private static ElementConfig config;
 
 
diff --git a/participant/participant-impl/participant-impl-acelement/src/test/java/org/onap/policy/clamp/acm/element/rest/ActuatorControllerTest.java b/participant/participant-impl/participant-impl-acelement/src/test/java/org/onap/policy/clamp/acm/element/rest/ActuatorControllerTest.java
index 489056adc..81c4b087c 100644
--- a/participant/participant-impl/participant-impl-acelement/src/test/java/org/onap/policy/clamp/acm/element/rest/ActuatorControllerTest.java
+++ b/participant/participant-impl/participant-impl-acelement/src/test/java/org/onap/policy/clamp/acm/element/rest/ActuatorControllerTest.java
@@ -41,9 +41,10 @@ import org.springframework.test.context.junit.jupiter.SpringExtension;
 @ActiveProfiles("test")
 class ActuatorControllerTest extends CommonActuatorController {
 
-    private static final String HEALTH_ENDPOINT = "health";
-    private static final String METRICS_ENDPOINT = "metrics";
-    private static final String PROMETHEUS_ENDPOINT = "prometheus";
+    private static final String HEALTH_ENDPOINT = "onap/policy/clamp/acelement/v2/health/";
+    private static final String METRICS_ENDPOINT = "onap/policy/clamp/acelement/v2/metrics/";
+    private static final String PROMETHEUS_ENDPOINT = "onap/policy/clamp/acelement/v2/prometheus/";
+    private static final String SWAGGER_ENDPOINT = "onap/policy/clamp/acelement/v2/v3/api-docs/";
 
     @LocalServerPort
     private int randomServerPort;
@@ -69,6 +70,11 @@ class ActuatorControllerTest extends CommonActuatorController {
     }
 
     @Test
+    void testGetSwagger_Unauthorized() throws Exception {
+        assertUnauthorizedActGet(SWAGGER_ENDPOINT);
+    }
+
+    @Test
     void testGetHealth() throws Exception {
         Invocation.Builder invocationBuilder = super.sendActRequest(HEALTH_ENDPOINT);
         Response rawresp = invocationBuilder.buildGet().invoke();
@@ -83,9 +89,16 @@ class ActuatorControllerTest extends CommonActuatorController {
     }
 
     @Test
-    void testGePrometheus() throws Exception {
+    void testGetPrometheus() throws Exception {
         Invocation.Builder invocationBuilder = super.sendActRequest(PROMETHEUS_ENDPOINT);
         Response rawresp = invocationBuilder.buildGet().invoke();
         assertEquals(Response.Status.OK.getStatusCode(), rawresp.getStatus());
     }
+
+    @Test
+    void testGetSwagger() throws Exception {
+        Invocation.Builder invocationBuilder = super.sendActRequest(SWAGGER_ENDPOINT);
+        Response rawresp = invocationBuilder.buildGet().invoke();
+        assertEquals(Response.Status.OK.getStatusCode(), rawresp.getStatus());
+    }
 }
diff --git a/participant/participant-impl/participant-impl-acelement/src/test/resources/application-test.yaml b/participant/participant-impl/participant-impl-acelement/src/test/resources/application-test.yaml
index d521ad742..4162bc8bf 100644
--- a/participant/participant-impl/participant-impl-acelement/src/test/resources/application-test.yaml
+++ b/participant/participant-impl/participant-impl-acelement/src/test/resources/application-test.yaml
@@ -6,6 +6,8 @@ spring:
 
 server:
   port: 8084
+  servlet:
+    context-path: /onap/policy/clamp/acelement/v2
   error:
     path: /error
 
diff --git a/participant/participant-impl/participant-impl-kubernetes/pom.xml b/participant/participant-impl/participant-impl-kubernetes/pom.xml
index 94dc415e3..a81f12927 100644
--- a/participant/participant-impl/participant-impl-kubernetes/pom.xml
+++ b/participant/participant-impl/participant-impl-kubernetes/pom.xml
@@ -52,6 +52,37 @@
         </resources>
         <plugins>
             <plugin>
+                <groupId>io.swagger.codegen.v3</groupId>
+                <artifactId>swagger-codegen-maven-plugin</artifactId>
+                <version>${version.swagger.codegen.v3}</version>
+                <executions>
+                    <execution>
+                        <id>code-gen</id>
+                        <goals>
+                            <goal>generate</goal>
+                        </goals>
+                        <configuration>
+                            <inputSpec>${project.basedir}/src/main/resources/openapi/openapi.yaml</inputSpec>
+                            <invokerPackage>org.onap.policy.clamp.acm.participant.kubernetes.controller</invokerPackage>
+                            <apiPackage>org.onap.policy.clamp.acm.participant.kubernetes.controller.genapi</apiPackage>
+                            <language>spring</language>
+                            <generateModels>false</generateModels>
+                            <generateSupportingFiles>false</generateSupportingFiles>
+                            <importMappings>
+                                ChartList=org.onap.policy.clamp.acm.participant.kubernetes.models.ChartList,
+                                InstallationInfo=org.onap.policy.clamp.acm.participant.kubernetes.models.InstallationInfo
+                            </importMappings>
+                            <configOptions>
+                                <sourceFolder>src/gen/java</sourceFolder>
+                                <dateLibrary>java11</dateLibrary>
+                                <interfaceOnly>true</interfaceOnly>
+                                <useTags>true</useTags>
+                            </configOptions>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
                 <groupId>org.springframework.boot</groupId>
                 <artifactId>spring-boot-maven-plugin</artifactId>
                 <executions>
diff --git a/participant/participant-impl/participant-impl-kubernetes/src/main/java/org/onap/policy/clamp/acm/participant/kubernetes/configurations/SpringFoxConfig.java b/participant/participant-impl/participant-impl-kubernetes/src/main/java/org/onap/policy/clamp/acm/participant/kubernetes/configurations/SpringDocBean.java
index cfa98bd65..17e1b16d1 100644
--- a/participant/participant-impl/participant-impl-kubernetes/src/main/java/org/onap/policy/clamp/acm/participant/kubernetes/configurations/SpringFoxConfig.java
+++ b/participant/participant-impl/participant-impl-kubernetes/src/main/java/org/onap/policy/clamp/acm/participant/kubernetes/configurations/SpringDocBean.java
@@ -1,6 +1,6 @@
 /*-
  * ============LICENSE_START=======================================================
- *  Copyright (C) 2021 Nordix Foundation.
+ *  Copyright (C) 2021-2022 Nordix Foundation.
  * ================================================================================
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -20,26 +20,29 @@
 
 package org.onap.policy.clamp.acm.participant.kubernetes.configurations;
 
-import org.onap.policy.clamp.acm.participant.kubernetes.controller.ChartController;
+import io.swagger.v3.oas.models.ExternalDocumentation;
+import io.swagger.v3.oas.models.OpenAPI;
+import io.swagger.v3.oas.models.info.Info;
+import io.swagger.v3.oas.models.info.License;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
-import springfox.documentation.builders.PathSelectors;
-import springfox.documentation.builders.RequestHandlerSelectors;
-import springfox.documentation.spi.DocumentationType;
-import springfox.documentation.spring.web.plugins.Docket;
 
 @Configuration
-public class SpringFoxConfig {
+public class SpringDocBean {
 
     /**
-     * Docket Spring Fox Config.
+     * Bean to configure Springdoc.
      *
-     * @return Docket
+     * @return the OpenAPI specification
      */
     @Bean
-    public Docket api() {
-        return new Docket(DocumentationType.SWAGGER_2).select()
-                .apis(RequestHandlerSelectors.basePackage(ChartController.class.getPackageName()))
-                .paths(PathSelectors.any()).build();
+    public OpenAPI kubernetesParticipantOpenApi() {
+        return new OpenAPI()
+                .info(new Info().title("ACM Kubernetes Participant")
+                .description("CLAMP Automation Composition Management Kubernetes Participant API")
+                .license(new License().name("Apache 2.0").url("http://www.apache.org/licenses/LICENSE-2.0")))
+                .externalDocs(new ExternalDocumentation()
+                .description("CLAMP Automation Composition Management Documentation")
+                .url("https://docs.onap.org/projects/onap-policy-parent/en/latest/clamp/clamp.html"));
     }
 }
diff --git a/participant/participant-impl/participant-impl-kubernetes/src/main/java/org/onap/policy/clamp/acm/participant/kubernetes/controller/ChartController.java b/participant/participant-impl/participant-impl-kubernetes/src/main/java/org/onap/policy/clamp/acm/participant/kubernetes/controller/ChartController.java
index 1186b7bf5..3928dd4f8 100644
--- a/participant/participant-impl/participant-impl-kubernetes/src/main/java/org/onap/policy/clamp/acm/participant/kubernetes/controller/ChartController.java
+++ b/participant/participant-impl/participant-impl-kubernetes/src/main/java/org/onap/policy/clamp/acm/participant/kubernetes/controller/ChartController.java
@@ -18,15 +18,14 @@
 
 package org.onap.policy.clamp.acm.participant.kubernetes.controller;
 
-import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.responses.ApiResponse;
-import io.swagger.v3.oas.annotations.responses.ApiResponses;
-import io.swagger.v3.oas.annotations.tags.Tag;
 import java.io.IOException;
 import java.lang.invoke.MethodHandles;
 import java.util.ArrayList;
+import java.util.UUID;
 import lombok.RequiredArgsConstructor;
+import org.onap.policy.clamp.acm.participant.kubernetes.controller.genapi.KubernetesParticipantControllerApi;
 import org.onap.policy.clamp.acm.participant.kubernetes.exception.ServiceException;
+import org.onap.policy.clamp.acm.participant.kubernetes.exception.ServiceRuntimeException;
 import org.onap.policy.clamp.acm.participant.kubernetes.models.ChartInfo;
 import org.onap.policy.clamp.acm.participant.kubernetes.models.ChartList;
 import org.onap.policy.clamp.acm.participant.kubernetes.models.HelmRepository;
@@ -38,16 +37,8 @@ import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.springframework.boot.autoconfigure.condition.ConditionalOnExpression;
 import org.springframework.http.HttpStatus;
-import org.springframework.http.MediaType;
 import org.springframework.http.ResponseEntity;
-import org.springframework.web.bind.annotation.DeleteMapping;
-import org.springframework.web.bind.annotation.GetMapping;
-import org.springframework.web.bind.annotation.PathVariable;
-import org.springframework.web.bind.annotation.PostMapping;
-import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RequestParam;
-import org.springframework.web.bind.annotation.RequestPart;
 import org.springframework.web.bind.annotation.RestController;
 import org.springframework.web.multipart.MultipartFile;
 
@@ -55,8 +46,7 @@ import org.springframework.web.multipart.MultipartFile;
 @RestController("chartController")
 @ConditionalOnExpression("${chart.api.enabled:false}")
 @RequestMapping("helm")
-@Tag(name = "k8s-participant")
-public class ChartController {
+public class ChartController implements KubernetesParticipantControllerApi {
     private final Logger logger = LoggerFactory.getLogger(MethodHandles.lookup().lookupClass());
 
     private final ChartService chartService;
@@ -68,12 +58,10 @@ public class ChartController {
      *
      * @return List of charts installed
      */
-    @GetMapping(path = "/charts", produces = MediaType.APPLICATION_JSON_VALUE)
-    @Operation(summary = "Return all Charts")
-    @ApiResponses(value = {@ApiResponse(responseCode = "200", description = "chart List")})
-    public ResponseEntity<ChartList> getAllCharts() {
+    @Override
+    public ResponseEntity<ChartList> getAllCharts(UUID onapRequestId) {
         return new ResponseEntity<>(ChartList.builder().charts(new ArrayList<>(chartService.getAllCharts())).build(),
-                HttpStatus.OK);
+            HttpStatus.OK);
     }
 
     /**
@@ -84,18 +72,18 @@ public class ChartController {
      * @throws ServiceException in case of error
      * @throws IOException in case of IO error
      */
-    @PostMapping(path = "/install", consumes = MediaType.APPLICATION_JSON_VALUE,
-            produces = MediaType.APPLICATION_JSON_VALUE)
-    @Operation(summary = "Install the chart")
-    @ApiResponses(value = {@ApiResponse(responseCode = "201", description = "chart Installed")})
-    public ResponseEntity<Void> installChart(@RequestBody InstallationInfo info)
-            throws ServiceException, IOException {
+    @Override
+    public ResponseEntity<Void> installChart(UUID onapRequestId, InstallationInfo info) {
         ChartInfo chart = chartService.getChart(info.getName(), info.getVersion());
         if (chart == null) {
             return new ResponseEntity<>(HttpStatus.NOT_FOUND);
         }
 
-        chartService.installChart(chart);
+        try {
+            chartService.installChart(chart);
+        } catch (ServiceException | IOException e) {
+            throw new ServiceRuntimeException(e);
+        }
         return new ResponseEntity<>(HttpStatus.CREATED);
     }
 
@@ -107,18 +95,19 @@ public class ChartController {
      * @return Status of operation
      * @throws ServiceException in case of error.
      */
-    @DeleteMapping(path = "/uninstall/{name}/{version}", produces = MediaType.APPLICATION_JSON_VALUE)
-    @Operation(summary = "Uninstall the Chart")
-    @ApiResponses(value = {@ApiResponse(responseCode = "204", description = "chart Uninstalled")})
-    public ResponseEntity<Void> uninstallChart(@PathVariable("name") String name,
-            @PathVariable("version") String version) throws ServiceException {
+    @Override
+    public ResponseEntity<Void> uninstallChart(String name, String version, UUID onapRequestId) {
         ChartInfo chart = chartService.getChart(name, version);
         if (chart == null) {
             return new ResponseEntity<>(HttpStatus.NOT_FOUND);
         }
 
-        chartService.uninstallChart(chart);
-        return new ResponseEntity<>(HttpStatus.NO_CONTENT);
+        try {
+            chartService.uninstallChart(chart);
+            return new ResponseEntity<>(HttpStatus.NO_CONTENT);
+        } catch (ServiceException se) {
+            throw se.asRuntimeException();
+        }
     }
 
     /**
@@ -131,23 +120,23 @@ public class ChartController {
      * @throws ServiceException in case of error
      * @throws IOException in case of IO error
      */
-    @PostMapping(path = "/onboard/chart", consumes = MediaType.MULTIPART_FORM_DATA_VALUE,
-            produces = MediaType.APPLICATION_JSON_VALUE)
-    @Operation(summary = "Onboard the Chart")
-    @ApiResponses(value = {@ApiResponse(responseCode = "200", description = "Chart Onboarded")})
-    public ResponseEntity<Void> onboardChart(@RequestPart("chart") MultipartFile chartFile,
-            @RequestParam(name = "values", required = false) MultipartFile overrideFile,
-            @RequestParam("info") String infoJson) throws ServiceException, IOException {
+    @Override
+    public ResponseEntity<Void> onboardChart(MultipartFile chartFile, MultipartFile overrideFile, String infoJson,
+        UUID onapRequestId) {
 
         ChartInfo info;
         try {
             info = CODER.decode(infoJson, ChartInfo.class);
         } catch (CoderException e) {
-            throw new ServiceException("Error parsing the chart information", e);
+            throw new ServiceRuntimeException("Error parsing the chart information", e);
         }
 
-        chartService.saveChart(info, chartFile, overrideFile);
-        return new ResponseEntity<>(HttpStatus.OK);
+        try {
+            chartService.saveChart(info, chartFile, overrideFile);
+            return new ResponseEntity<>(HttpStatus.OK);
+        } catch (IOException | ServiceException e) {
+            throw new ServiceRuntimeException(e);
+        }
     }
 
     /**
@@ -157,11 +146,8 @@ public class ChartController {
      * @param version version of the chart
      * @return Status of operation
      */
-    @DeleteMapping(path = "/chart/{name}/{version}")
-    @Operation(summary = "Delete the chart")
-    @ApiResponses(value = {@ApiResponse(responseCode = "204", description = "Chart Deleted")})
-    public ResponseEntity<Void> deleteChart(@PathVariable("name") String name,
-            @PathVariable("version") String version) {
+    @Override
+    public ResponseEntity<Void> deleteChart(String name, String version, UUID onapRequestId) {
 
         ChartInfo chart = chartService.getChart(name, version);
         if (chart == null) {
@@ -180,24 +166,25 @@ public class ChartController {
      * @throws ServiceException in case of error
      * @throws IOException in case of IO error
      */
-    @PostMapping(path = "/repo", consumes = MediaType.APPLICATION_JSON_VALUE,
-            produces = MediaType.APPLICATION_JSON_VALUE)
-    @ApiResponses(
-            value = {@ApiResponse(responseCode = "201", description = "Repository added"),
-                @ApiResponse(responseCode = "409", description = "Repository already Exist")})
-    public ResponseEntity<String> configureRepo(@RequestBody String repo)
-            throws ServiceException, IOException {
+    @Override
+    public ResponseEntity<String> configureRepo(UUID onapRequestId, String repo) {
         HelmRepository repository;
         try {
             repository = CODER.decode(repo, HelmRepository.class);
         } catch (CoderException e) {
             logger.warn("Error parsing the repository information:", e);
             return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
-                    .body("Error parsing the repository information");
+                .body("Error parsing the repository information");
         }
-        if (chartService.configureRepository(repository)) {
-            return new ResponseEntity<>(HttpStatus.CREATED);
+
+        try {
+            if (chartService.configureRepository(repository)) {
+                return new ResponseEntity<>(HttpStatus.CREATED);
+            } else {
+                return new ResponseEntity<>(HttpStatus.CONFLICT);
+            }
+        } catch (ServiceException se) {
+            throw se.asRuntimeException();
         }
-        return new ResponseEntity<>(HttpStatus.CONFLICT);
     }
 }
diff --git a/participant/participant-impl/participant-impl-kubernetes/src/main/java/org/onap/policy/clamp/acm/participant/kubernetes/exception/ServiceException.java b/participant/participant-impl/participant-impl-kubernetes/src/main/java/org/onap/policy/clamp/acm/participant/kubernetes/exception/ServiceException.java
index 6414f2fa9..f4701e0ac 100644
--- a/participant/participant-impl/participant-impl-kubernetes/src/main/java/org/onap/policy/clamp/acm/participant/kubernetes/exception/ServiceException.java
+++ b/participant/participant-impl/participant-impl-kubernetes/src/main/java/org/onap/policy/clamp/acm/participant/kubernetes/exception/ServiceException.java
@@ -29,4 +29,8 @@ public class ServiceException extends Exception {
     public ServiceException(String message, Exception originalException) {
         super(message, originalException);
     }
+
+    public ServiceRuntimeException asRuntimeException() {
+        return new ServiceRuntimeException(this);
+    }
 }
diff --git a/participant/participant-impl/participant-impl-kubernetes/src/main/java/org/onap/policy/clamp/acm/participant/kubernetes/exception/ServiceRuntimeException.java b/participant/participant-impl/participant-impl-kubernetes/src/main/java/org/onap/policy/clamp/acm/participant/kubernetes/exception/ServiceRuntimeException.java
new file mode 100644
index 000000000..9aa2eefa3
--- /dev/null
+++ b/participant/participant-impl/participant-impl-kubernetes/src/main/java/org/onap/policy/clamp/acm/participant/kubernetes/exception/ServiceRuntimeException.java
@@ -0,0 +1,37 @@
+/*-
+ * ========================LICENSE_START=================================
+ * Copyright (C) 2021 Nordix Foundation. All rights reserved.
+ * ======================================================================
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ * ========================LICENSE_END===================================
+ */
+
+package org.onap.policy.clamp.acm.participant.kubernetes.exception;
+
+public class ServiceRuntimeException extends RuntimeException {
+
+
+    private static final long serialVersionUID = -4702572294307202439L;
+
+    public ServiceRuntimeException(String message) {
+        super(message);
+    }
+
+    public ServiceRuntimeException(String message, Exception originalException) {
+        super(message, originalException);
+    }
+
+    public ServiceRuntimeException(Exception originalException) {
+        super(originalException);
+    }
+}
diff --git a/participant/participant-impl/participant-impl-kubernetes/src/main/resources/openapi/openapi.yaml b/participant/participant-impl/participant-impl-kubernetes/src/main/resources/openapi/openapi.yaml
new file mode 100644
index 000000000..457b66fc9
--- /dev/null
+++ b/participant/participant-impl/participant-impl-kubernetes/src/main/resources/openapi/openapi.yaml
@@ -0,0 +1,494 @@
+openapi: 3.0.3
+info:
+  title: ACM Kubernetes Participant
+  description: CLAMP Automation Composition Management Kubernetes Participant API
+  contact:
+    name: ONAP Support
+    url: https://lists.onap.org/g/onap-discuss
+    email: onap-discuss@lists.onap.org
+  license:
+    name: Apache 2.0
+    url: http://www.apache.org/licenses/LICENSE-2.0
+  version: '1.0'
+externalDocs:
+  description: CLAMP Automation Composition Management Documentation
+  url: https://docs.onap.org/projects/onap-policy-parent/en/latest/clamp/clamp.html
+tags:
+  - name: kubernetes-participant-controller
+    description: Automation Composition Element Test Participant controller
+servers:
+  - url: http:{port}/{server}
+    variables:
+      port:
+        default: "30295"
+        description: This value is assigned by the service provider
+      server:
+        default: /onap/policy/clamp/acm/k8sparticipant
+        description: This value is assigned by the service provider
+paths:
+  /charts:
+    get:
+      tags:
+        - kubernetes-participant-controller
+      summary: Return all Charts
+      description: Return all the charts configured in the Kubernetes Participant
+      operationId: getAllCharts
+      parameters:
+      - name: X-onap-RequestId
+        in: header
+        description: RequestID for http transaction
+        schema:
+          type: string
+          format: uuid
+      responses:
+        200:
+          description: OK, reutrns a serialised instance of
+            [ChartList](https://github.com/onap/policy-clamp/blob/master/participant/participant-impl/participant-impl-kubernetes/src/main/java/org/onap/policy/clamp/acm/participant/kubernetes/models/ChartList.java)
+          headers:
+            api-version:
+              schema:
+                type: string
+            X-LatestVersion:
+              schema:
+                type: string
+                description: Used only to communicate an API's latest version
+            X-PatchVersion:
+              schema:
+                type: string
+                description:
+                  Used only to communicate a PATCH version in a response for troubleshooting purposes only,
+                  and will not be provided by the client on request
+            X-MinorVersion:
+              schema:
+                type: string
+                description:
+                  Used to request or communicate a MINOR version back from the client
+                  to the server, and from the server back to the client
+            X-onap-RequestId:
+              schema:
+                type: string
+                format: uuid
+                description: Used to track REST transactions for logging purposes
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ChartList'
+            application/yaml:
+              schema:
+                $ref: '#/components/schemas/ChartList'
+        401:
+          description: Authorization Error
+        404:
+          description: Not Found
+        500:
+          description: Internal Server Error
+      security:
+        - basicAuth: []
+  /install:
+    post:
+      tags:
+        - kubernetes-participant-controller
+      summary: Installs a chart
+      description: >-
+        Installs a Helm Chart for use by an Automation Composition Element in the Kubernetes Participant
+      operationId: installChart
+      parameters:
+        - name: X-ONAP-RequestID
+          in: header
+          description: RequestID for http transaction
+          required: false
+          schema:
+            type: string
+            format: uuid
+      requestBody:
+        description: The installation information for the chart to install in a serialised instance of
+            [InstallationInfo](https://github.com/onap/policy-clamp/blob/master/participant/participant-impl/participant-impl-kubernetes/src/main/java/org/onap/policy/clamp/acm/participant/kubernetes/models/InstallationInfo.java)
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/InstallationInfo'
+          application/yaml:
+            schema:
+              $ref: '#/components/schemas/InstallationInfo'
+      responses:
+        201:
+          description: OK, the Helm chart has been installed
+          headers:
+            api-version:
+              schema:
+                type: string
+            X-LatestVersion:
+              schema:
+                type: string
+                description: Used only to communicate an API's latest version
+            X-PatchVersion:
+              schema:
+                type: string
+                description:
+                  Used only to communicate a PATCH version in a response for troubleshooting purposes only,
+                  and will not be provided by the client on request
+            X-MinorVersion:
+              schema:
+                type: string
+                description:
+                  Used to request or communicate a MINOR version back from the client
+                  to the server, and from the server back to the client
+            X-onap-RequestId:
+              schema:
+                type: string
+                format: uuid
+                description: Used to track REST transactions for logging purposes
+        400:
+          description: Bad Request
+        401:
+          description: Authorization Error
+        500:
+          description: Internal Server Error
+      security:
+        - basicAuth: []
+  /uninstall/{name}/{version}:
+    delete:
+      tags:
+        - kubernetes-participant-controller
+      summary: Uninstall a Helm Chart
+      description: Uninstall a Helm Chart from the helm charts that can be used by an Automation Composition element in the
+        Kubernetes Participant
+      operationId: uninstallChart
+      parameters:
+      - name: X-onap-RequestId
+        in: header
+        description: RequestID for http transaction
+        schema:
+          type: string
+          format: uuid
+      - name : name
+        in: path
+        description: The name of the chart to uninstall
+        required: true
+        schema:
+          type: string
+      - name : version
+        in: path
+        description: The version of the chart to uninstall
+        required: true
+        schema:
+          type: string
+      responses:
+        204:
+          description: No Content, the chart has been uninstalled
+          headers:
+            api-version:
+              schema:
+                type: string
+            X-LatestVersion:
+              schema:
+                type: string
+                description: Used only to communicate an API's latest version
+            X-PatchVersion:
+              schema:
+                type: string
+                description:
+                  Used only to communicate a PATCH version in a response for troubleshooting purposes only,
+                  and will not be provided by the client on request
+            X-MinorVersion:
+              schema:
+                type: string
+                description:
+                  Used to request or communicate a MINOR version back from the client
+                  to the server, and from the server back to the client
+            X-onap-RequestId:
+              schema:
+                type: string
+                format: uuid
+                description: Used to track REST transactions for logging purposes
+        400:
+          description: Bad Request
+        401:
+          description: Authorization Error
+        409:
+          description: Not Defined, the chart is not defined
+          headers:
+            api-version:
+              schema:
+                type: string
+            X-LatestVersion:
+              schema:
+                type: string
+                description: Used only to communicate an API's latest version
+            X-PatchVersion:
+              schema:
+                type: string
+                description:
+                  Used only to communicate a PATCH version in a response for troubleshooting purposes only,
+                  and will not be provided by the client on request
+            X-MinorVersion:
+              schema:
+                type: string
+                description:
+                  Used to request or communicate a MINOR version back from the client
+                  to the server, and from the server back to the client
+            X-onap-RequestId:
+              schema:
+                type: string
+                format: uuid
+                description: Used to track REST transactions for logging purposes
+        500:
+          description: Internal Server Error
+      security:
+        - basicAuth: []
+  /onboard/chart:
+    post:
+      tags:
+        - kubernetes-participant-controller
+      summary: Onboards a chart onto Kubernetes
+      description: >-
+        Onboards a Helm Chart onto a Kubernetes Cluster
+      operationId: onboardChart
+      parameters:
+        - name: X-ONAP-RequestID
+          in: header
+          description: RequestID for http transaction
+          required: false
+          schema:
+            type: string
+            format: uuid
+      requestBody:
+        required: true
+        content:
+          multipart/form-data:
+            schema:
+              required:
+                - chartFile
+                - info
+              type: object
+              properties:
+                chartFile:
+                  type: string
+                  format: binary
+                  nullable: false
+                overrideFile:
+                  type: string
+                  format: binary
+                  nullable: true
+                info:
+                  type: string
+                  description: A JSON or YAML serialized instance of
+                    [ChartInfo](https://github.com/onap/policy-clamp/blob/master/participant/participant-impl/participant-impl-kubernetes/src/main/java/org/onap/policy/clamp/acm/participant/kubernetes/models/ChartInfo.java)
+            encoding:
+              chartFile: 
+                contentType: application/octet-stream
+              overrideFile: 
+                contentType: application/octet-stream
+              info:
+                contentType: application/json
+      responses:
+        200:
+          description: OK, the Helm chart has been onboarded
+          headers:
+            api-version:
+              schema:
+                type: string
+            X-LatestVersion:
+              schema:
+                type: string
+                description: Used only to communicate an API's latest version
+            X-PatchVersion:
+              schema:
+                type: string
+                description:
+                  Used only to communicate a PATCH version in a response for troubleshooting purposes only,
+                  and will not be provided by the client on request
+            X-MinorVersion:
+              schema:
+                type: string
+                description:
+                  Used to request or communicate a MINOR version back from the client
+                  to the server, and from the server back to the client
+            X-onap-RequestId:
+              schema:
+                type: string
+                format: uuid
+                description: Used to track REST transactions for logging purposes
+        400:
+          description: Bad Request
+        401:
+          description: Authorization Error
+        500:
+          description: Internal Server Error
+      security:
+        - basicAuth: []
+  /chart/{name}/{version}:
+    delete:
+      tags:
+        - kubernetes-participant-controller
+      summary: Delete a Helm Chart
+      description: Delete a Helm Chart from the helm charts that can be used by an Automation Composition element in the
+        Kubernetes Participant
+      operationId: deleteChart
+      parameters:
+      - name: X-onap-RequestId
+        required: false
+        in: header
+        description: RequestID for http transaction
+        schema:
+          type: string
+          format: uuid
+      - name : name
+        in: path
+        description: The name of the chart to uninstall
+        required: true
+        schema:
+          type: string
+      - name : version
+        in: path
+        description: The version of the chart to uninstall
+        required: true
+        schema:
+          type: string
+      responses:
+        204:
+          description: No Content, the chart has been deleted
+          headers:
+            api-version:
+              schema:
+                type: string
+            X-LatestVersion:
+              schema:
+                type: string
+                description: Used only to communicate an API's latest version
+            X-PatchVersion:
+              schema:
+                type: string
+                description:
+                  Used only to communicate a PATCH version in a response for troubleshooting purposes only,
+                  and will not be provided by the client on request
+            X-MinorVersion:
+              schema:
+                type: string
+                description:
+                  Used to request or communicate a MINOR version back from the client
+                  to the server, and from the server back to the client
+            X-onap-RequestId:
+              schema:
+                type: string
+                format: uuid
+                description: Used to track REST transactions for logging purposes
+        400:
+          description: Bad Request
+        401:
+          description: Authorization Error
+        409:
+          description: Not Defined, the chart is not defined
+          headers:
+            api-version:
+              schema:
+                type: string
+            X-LatestVersion:
+              schema:
+                type: string
+                description: Used only to communicate an API's latest version
+            X-PatchVersion:
+              schema:
+                type: string
+                description:
+                  Used only to communicate a PATCH version in a response for troubleshooting purposes only,
+                  and will not be provided by the client on request
+            X-MinorVersion:
+              schema:
+                type: string
+                description:
+                  Used to request or communicate a MINOR version back from the client
+                  to the server, and from the server back to the client
+            X-onap-RequestId:
+              schema:
+                type: string
+                format: uuid
+                description: Used to track REST transactions for logging purposes
+        500:
+          description: Internal Server Error
+      security:
+        - basicAuth: []
+  /repo:
+    post:
+      tags:
+        - kubernetes-participant-controller
+      summary: Configure a Helm repository
+      description: >-
+        Configure a Helm repository to the Kubernetes Participant, which the participant can then use
+      operationId: configureRepo
+      parameters:
+        - name: X-ONAP-RequestID
+          in: header
+          description: RequestID for http transaction
+          required: false
+          schema:
+            type: string
+            format: uuid
+      requestBody:
+        description: The Helm repository to be configured
+        content:
+          application/json:
+            schema:
+              type: string
+          application/yaml:
+            schema:
+              type: string
+      responses:
+        201:
+          description: OK, the repository has been configured
+          headers:
+            api-version:
+              schema:
+                type: string
+            X-LatestVersion:
+              schema:
+                type: string
+                description: Used only to communicate an API's latest version
+            X-PatchVersion:
+              schema:
+                type: string
+                description:
+                  Used only to communicate a PATCH version in a response for troubleshooting purposes only,
+                  and will not be provided by the client on request
+            X-MinorVersion:
+              schema:
+                type: string
+                description:
+                  Used to request or communicate a MINOR version back from the client
+                  to the server, and from the server back to the client
+            X-onap-RequestId:
+              schema:
+                type: string
+                format: uuid
+                description: Used to track REST transactions for logging purposes
+          content:
+            application/json:
+              schema:
+                type: string
+              example: Success
+            application/yaml:
+              schema:
+                type: string
+              example: Success
+        400:
+          description: Bad Request
+        401:
+          description: Authorization Error
+        409:
+          description: Conflict, the repository already exists
+        500:
+          description: Internal Server Error
+      security:
+        - basicAuth: []
+components:
+  securitySchemes:
+    basicAuth:
+      type: http
+      scheme: basic
+  schemas:
+    ChartList:
+      title: ChartList
+      type: object
+    InstallationInfo:
+      title: InstallationInfo
+      type: object
diff --git a/participant/participant-impl/participant-impl-kubernetes/src/test/java/org/onap/policy/clamp/acm/participant/kubernetes/rest/ActuatorControllerTest.java b/participant/participant-impl/participant-impl-kubernetes/src/test/java/org/onap/policy/clamp/acm/participant/kubernetes/rest/ActuatorControllerTest.java
index 997a227cb..3a97b8c6e 100644
--- a/participant/participant-impl/participant-impl-kubernetes/src/test/java/org/onap/policy/clamp/acm/participant/kubernetes/rest/ActuatorControllerTest.java
+++ b/participant/participant-impl/participant-impl-kubernetes/src/test/java/org/onap/policy/clamp/acm/participant/kubernetes/rest/ActuatorControllerTest.java
@@ -44,6 +44,7 @@ class ActuatorControllerTest extends CommonActuatorController {
     private static final String HEALTH_ENDPOINT = "health";
     private static final String METRICS_ENDPOINT = "metrics";
     private static final String PROMETHEUS_ENDPOINT = "prometheus";
+    private static final String SWAGGER_ENDPOINT = "v3/api-docs";
 
     @LocalServerPort
     private int randomServerPort;
@@ -69,6 +70,11 @@ class ActuatorControllerTest extends CommonActuatorController {
     }
 
     @Test
+    void testGetSwagger_Unauthorized() {
+        assertUnauthorizedActGet(SWAGGER_ENDPOINT);
+    }
+
+    @Test
     void testGetHealth() {
         Invocation.Builder invocationBuilder = super.sendActRequest(HEALTH_ENDPOINT);
         Response rawresp = invocationBuilder.buildGet().invoke();
@@ -83,10 +89,16 @@ class ActuatorControllerTest extends CommonActuatorController {
     }
 
     @Test
-    void testGePrometheus() {
+    void testGetPrometheus() {
         Invocation.Builder invocationBuilder = super.sendActRequest(PROMETHEUS_ENDPOINT);
         Response rawresp = invocationBuilder.buildGet().invoke();
         assertEquals(Response.Status.OK.getStatusCode(), rawresp.getStatus());
     }
 
+    @Test
+    void testGetSwagger() {
+        Invocation.Builder invocationBuilder = super.sendActRequest(SWAGGER_ENDPOINT);
+        Response rawresp = invocationBuilder.buildGet().invoke();
+        assertEquals(Response.Status.OK.getStatusCode(), rawresp.getStatus());
+    }
 }
diff --git a/participant/participant-impl/participant-impl-kubernetes/src/test/java/org/onap/policy/clamp/acm/participant/kubernetes/rest/ChartControllerTest.java b/participant/participant-impl/participant-impl-kubernetes/src/test/java/org/onap/policy/clamp/acm/participant/kubernetes/rest/ChartControllerTest.java
index e1cf3cf08..a6d6f315a 100644
--- a/participant/participant-impl/participant-impl-kubernetes/src/test/java/org/onap/policy/clamp/acm/participant/kubernetes/rest/ChartControllerTest.java
+++ b/participant/participant-impl/participant-impl-kubernetes/src/test/java/org/onap/policy/clamp/acm/participant/kubernetes/rest/ChartControllerTest.java
@@ -64,7 +64,6 @@ import org.springframework.test.web.servlet.request.MockMvcRequestBuilders;
 import org.springframework.test.web.servlet.setup.MockMvcBuilders;
 import org.springframework.web.context.WebApplicationContext;
 
-
 @ExtendWith(SpringExtension.class)
 @WebMvcTest(value = ChartController.class, properties = "chart.api.enabled=true")
 @Import({MetricsAutoConfiguration.class, CompositeMeterRegistryAutoConfiguration.class})
@@ -182,13 +181,13 @@ class ChartControllerTest {
     @Test
     void onboardChart() throws Exception {
         RequestBuilder requestBuilder;
-        MockMultipartFile chartFile = new MockMultipartFile("chart", "hello.tgz",
+        MockMultipartFile chartFile = new MockMultipartFile("file", "hello.tgz",
             MediaType.TEXT_PLAIN_VALUE, "Dummy data".getBytes());
 
-        MockMultipartFile overrideFile = new MockMultipartFile("values", "values.yaml",
+        MockMultipartFile overrideFile = new MockMultipartFile("file", "values.yaml",
             MediaType.TEXT_PLAIN_VALUE, "Dummy data".getBytes());
 
-        //Mocking successful scenario for void uninstall method
+        // Mocking successful scenario for void uninstall method
         when(chartService.saveChart(charts.get(0), chartFile, null)).thenReturn(charts.get(0));
 
         requestBuilder = MockMvcRequestBuilders.multipart(ONBOARD_CHART_URL)
diff --git a/participant/participant-impl/participant-impl-kubernetes/src/test/resources/application-test.yaml b/participant/participant-impl/participant-impl-kubernetes/src/test/resources/application-test.yaml
index c54996e79..cd36f61e7 100644
--- a/participant/participant-impl/participant-impl-kubernetes/src/test/resources/application-test.yaml
+++ b/participant/participant-impl/participant-impl-kubernetes/src/test/resources/application-test.yaml
@@ -29,4 +29,3 @@ participant:
             - localhost
           topicCommInfrastructure: dmaap
       name: AutomationComposition Topics
-
diff --git a/participant/participant-impl/participant-impl-policy/src/test/java/org/onap/policy/clamp/acm/participant/policy/main/utils/MockRestEndpoint.java b/participant/participant-impl/participant-impl-policy/src/test/java/org/onap/policy/clamp/acm/participant/policy/main/utils/MockRestEndpoint.java
index 9f56a29ca..b7485c6ca 100644
--- a/participant/participant-impl/participant-impl-policy/src/test/java/org/onap/policy/clamp/acm/participant/policy/main/utils/MockRestEndpoint.java
+++ b/participant/participant-impl/participant-impl-policy/src/test/java/org/onap/policy/clamp/acm/participant/policy/main/utils/MockRestEndpoint.java
@@ -20,7 +20,6 @@
 
 package org.onap.policy.clamp.acm.participant.policy.main.utils;
 
-import io.swagger.annotations.ApiParam;
 import javax.ws.rs.DELETE;
 import javax.ws.rs.POST;
 import javax.ws.rs.Path;
@@ -46,8 +45,7 @@ public class MockRestEndpoint {
      */
     @Path("policy/api/v1/policytypes")
     @POST
-    public Response createPolicyType(
-            @RequestBody @ApiParam(value = "Entity body", required = true) ToscaServiceTemplate body) {
+    public Response createPolicyType(@RequestBody ToscaServiceTemplate body) {
         return Response.status(200).build();
     }
 
@@ -59,8 +57,7 @@ public class MockRestEndpoint {
      */
     @Path("policy/api/v1/policies")
     @POST
-    public Response createPolicy(
-            @RequestBody @ApiParam(value = "Entity body ", required = true) ToscaServiceTemplate body) {
+    public Response createPolicy(@RequestBody ToscaServiceTemplate body) {
         return Response.status(200).build();
     }
 
@@ -94,8 +91,7 @@ public class MockRestEndpoint {
      */
     @Path("policy/pap/v1/pdps/deployments/batch")
     @POST
-    public Response handlePolicyDeployOrUndeploy(
-            @RequestBody @ApiParam(value = "Entity body", required = true) DeploymentGroups body) {
+    public Response handlePolicyDeployOrUndeploy(@RequestBody DeploymentGroups body) {
         return Response.status(200).build();
     }