diff --git a/docs/modules/onecx-permission-svc/nav.adoc b/docs/modules/onecx-permission-svc/nav.adoc
index be25f93..00b6654 100644
--- a/docs/modules/onecx-permission-svc/nav.adoc
+++ b/docs/modules/onecx-permission-svc/nav.adoc
@@ -1 +1,3 @@
-* xref:onecx-permission-svc:index.adoc[Permission Service]
\ No newline at end of file
+* xref:onecx-permission-svc:index.adoc[Permission Service]
+** External API(s)
+*** xref:onecx-permission-svc:openapi/onecx-permission-v1.adoc[Permission Management V1]
\ No newline at end of file
diff --git a/docs/modules/onecx-permission-svc/pages/onecx-permission-svc-extensions.adoc b/docs/modules/onecx-permission-svc/pages/onecx-permission-svc-extensions.adoc
index 99f52aa..b71d42b 100644
--- a/docs/modules/onecx-permission-svc/pages/onecx-permission-svc-extensions.adoc
+++ b/docs/modules/onecx-permission-svc/pages/onecx-permission-svc-extensions.adoc
@@ -72,73 +72,73 @@ h| Version
 
 | https://quarkus.io/guides/cdi-reference[Link]
 | https://github.com/quarkusio/quarkusio.github.io/blob/develop/_generated-doc/latest/config/quarkus-arc.adoc[Link]
-| 3.12.0
+| 3.12.2
 
 | quarkus-liquibase
 
 | https://quarkus.io/guides/liquibase[Link]
 | https://github.com/quarkusio/quarkusio.github.io/blob/develop/_generated-doc/latest/config/quarkus-liquibase.adoc[Link]
-| 3.12.0
+| 3.12.2
 
 | quarkus-smallrye-health
 
 | https://quarkus.io/guides/smallrye-health[Link]
 | https://github.com/quarkusio/quarkusio.github.io/blob/develop/_generated-doc/latest/config/quarkus-smallrye-health.adoc[Link]
-| 3.12.0
+| 3.12.2
 
 | quarkus-micrometer-registry-prometheus
 
 | https://quarkus.io/guides/telemetry-micrometer[Link]
 | https://github.com/quarkusio/quarkusio.github.io/blob/develop/_generated-doc/latest/config/quarkus-micrometer-registry-prometheus.adoc[Link]
-| 3.12.0
+| 3.12.2
 
 | quarkus-hibernate-orm
 
 | https://quarkus.io/guides/hibernate-orm[Link]
 | https://github.com/quarkusio/quarkusio.github.io/blob/develop/_generated-doc/latest/config/quarkus-hibernate-orm.adoc[Link]
-| 3.12.0
+| 3.12.2
 
 | quarkus-rest
 
 | https://quarkus.io/guides/rest[Link]
 | https://github.com/quarkusio/quarkusio.github.io/blob/develop/_generated-doc/latest/config/quarkus-rest.adoc[Link]
-| 3.12.0
+| 3.12.2
 
 | quarkus-rest-jackson
 
 | https://quarkus.io/guides/rest-json[Link]
 | 
-| 3.12.0
+| 3.12.2
 
 | quarkus-jdbc-postgresql
 
 | https://quarkus.io/guides/datasource[Link]
 | https://github.com/quarkusio/quarkusio.github.io/blob/develop/_generated-doc/latest/config/quarkus-jdbc-postgresql.adoc[Link]
-| 3.12.0
+| 3.12.2
 
 | quarkus-smallrye-openapi
 
 | https://quarkus.io/guides/openapi-swaggerui[Link]
 | https://github.com/quarkusio/quarkusio.github.io/blob/develop/_generated-doc/latest/config/quarkus-smallrye-openapi.adoc[Link]
-| 3.12.0
+| 3.12.2
 
 | quarkus-hibernate-validator
 
 | https://quarkus.io/guides/validation[Link]
 | https://github.com/quarkusio/quarkusio.github.io/blob/develop/_generated-doc/latest/config/quarkus-hibernate-validator.adoc[Link]
-| 3.12.0
+| 3.12.2
 
 | quarkus-opentelemetry
 
 | https://quarkus.io/guides/opentelemetry[Link]
 | https://github.com/quarkusio/quarkusio.github.io/blob/develop/_generated-doc/latest/config/quarkus-opentelemetry.adoc[Link]
-| 3.12.0
+| 3.12.2
 
 | quarkus-oidc
 
 | https://quarkus.io/guides/security-oidc-bearer-token-authentication-tutorial[Link]
 | https://github.com/quarkusio/quarkusio.github.io/blob/develop/_generated-doc/latest/config/quarkus-oidc.adoc[Link]
-| 3.12.0
+| 3.12.2
 
 | tkit-quarkus-security
 
@@ -150,7 +150,7 @@ h| Version
 
 | https://quarkus.io/guides/container-image[Link]
 | https://github.com/quarkusio/quarkusio.github.io/blob/develop/_generated-doc/latest/config/quarkus-container-image-docker.adoc[Link]
-| 3.12.0
+| 3.12.2
 
 
 | onecx-security
@@ -163,7 +163,7 @@ h| Version
 
 | 
 | 
-| 3.12.0
+| 3.12.2
 
 
 |===
\ No newline at end of file
diff --git a/docs/modules/onecx-permission-svc/pages/openapi/onecx-permission-v1.adoc b/docs/modules/onecx-permission-svc/pages/openapi/onecx-permission-v1.adoc
new file mode 100644
index 0000000..f6f0091
--- /dev/null
+++ b/docs/modules/onecx-permission-svc/pages/openapi/onecx-permission-v1.adoc
@@ -0,0 +1,2 @@
+:page-layout: swagger
+:page-swagger-url: https://raw.githubusercontent.com/onecx/onecx-permission-svc/main/src/main/openapi/onecx-permission-v1.yaml
diff --git a/pom.xml b/pom.xml
index 2ce0627..76f8a5b 100644
--- a/pom.xml
+++ b/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.tkit.onecx</groupId>
         <artifactId>onecx-quarkus3-parent</artifactId>
-        <version>0.55.0</version>
+        <version>0.56.0</version>
     </parent>
 
     <artifactId>onecx-permission-svc</artifactId>
@@ -163,6 +163,25 @@
 
     <build>
         <plugins>
+            <plugin>
+                <groupId>org.tkit.maven</groupId>
+                <artifactId>tkit-docs-quarkus-plugin</artifactId>
+                <executions>
+                    <execution>
+                        <id>docs</id>
+                        <phase>prepare-package</phase>
+                        <goals>
+                            <goal>docs</goal>
+                        </goals>
+                        <configuration>
+                            <skipDocs>${skipDocs}</skipDocs>
+                            <openApiFiles>
+                                <openApiFile>onecx-permission-v1.yaml</openApiFile>
+                            </openApiFiles>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
             <plugin>
                 <groupId>org.openapitools</groupId>
                 <artifactId>openapi-generator-maven-plugin</artifactId>