From d434d4ec702b44b6cb46e886f6234ee5ff992358 Mon Sep 17 00:00:00 2001
From: Sheen Capadngan <sheensantoscapadngan@gmail.com>
Date: Wed, 26 Nov 2025 04:29:24 +0800
Subject: [PATCH] misc: added cert alerts to doc

---
 backend/src/server/routes/v1/pki-alert-router.ts   | 7 +++++++
 docs/api-reference/endpoints/pki-alerts/create.mdx | 2 +-
 docs/api-reference/endpoints/pki-alerts/delete.mdx | 2 +-
 docs/api-reference/endpoints/pki-alerts/read.mdx   | 2 +-
 docs/api-reference/endpoints/pki-alerts/update.mdx | 2 +-
 docs/docs.json                                     | 9 +++++++++
 6 files changed, 20 insertions(+), 4 deletions(-)

diff --git a/backend/src/server/routes/v1/pki-alert-router.ts b/backend/src/server/routes/v1/pki-alert-router.ts
index 459b5cc6c..a786e6015 100644
--- a/backend/src/server/routes/v1/pki-alert-router.ts
+++ b/backend/src/server/routes/v1/pki-alert-router.ts
@@ -23,6 +23,7 @@ export const registerPkiAlertRouter = async (server: FastifyZodProvider) => {
     },
     onRequest: verifyAuth([AuthMode.JWT, AuthMode.IDENTITY_ACCESS_TOKEN]),
     schema: {
+      hide: false,
       description: "Create a new PKI alert",
       tags: [ApiDocsTags.PkiAlerting],
       body: CreatePkiAlertV2Schema.extend({
@@ -90,6 +91,7 @@ export const registerPkiAlertRouter = async (server: FastifyZodProvider) => {
     },
     onRequest: verifyAuth([AuthMode.JWT, AuthMode.IDENTITY_ACCESS_TOKEN]),
     schema: {
+      hide: false,
       description: "List PKI alerts for a project",
       tags: [ApiDocsTags.PkiAlerting],
       querystring: z.object({
@@ -150,6 +152,7 @@ export const registerPkiAlertRouter = async (server: FastifyZodProvider) => {
     },
     onRequest: verifyAuth([AuthMode.JWT, AuthMode.IDENTITY_ACCESS_TOKEN]),
     schema: {
+      hide: false,
       description: "Get a PKI alert by ID",
       tags: [ApiDocsTags.PkiAlerting],
       params: z.object({
@@ -214,6 +217,7 @@ export const registerPkiAlertRouter = async (server: FastifyZodProvider) => {
     },
     onRequest: verifyAuth([AuthMode.JWT, AuthMode.IDENTITY_ACCESS_TOKEN]),
     schema: {
+      hide: false,
       description: "Update a PKI alert",
       tags: [ApiDocsTags.PkiAlerting],
       params: z.object({
@@ -283,6 +287,7 @@ export const registerPkiAlertRouter = async (server: FastifyZodProvider) => {
     },
     onRequest: verifyAuth([AuthMode.JWT, AuthMode.IDENTITY_ACCESS_TOKEN]),
     schema: {
+      hide: false,
       description: "Delete a PKI alert",
       tags: [ApiDocsTags.PkiAlerting],
       params: z.object({
@@ -347,6 +352,7 @@ export const registerPkiAlertRouter = async (server: FastifyZodProvider) => {
     },
     onRequest: verifyAuth([AuthMode.JWT, AuthMode.IDENTITY_ACCESS_TOKEN]),
     schema: {
+      hide: false,
       description: "List certificates that match an alert's filter rules",
       tags: [ApiDocsTags.PkiAlerting],
       params: z.object({
@@ -397,6 +403,7 @@ export const registerPkiAlertRouter = async (server: FastifyZodProvider) => {
     },
     onRequest: verifyAuth([AuthMode.JWT, AuthMode.IDENTITY_ACCESS_TOKEN]),
     schema: {
+      hide: false,
       description: "Preview certificates that would match the given filter rules",
       tags: [ApiDocsTags.PkiAlerting],
       body: z.object({
diff --git a/docs/api-reference/endpoints/pki-alerts/create.mdx b/docs/api-reference/endpoints/pki-alerts/create.mdx
index d4be026a7..e339dd425 100644
--- a/docs/api-reference/endpoints/pki-alerts/create.mdx
+++ b/docs/api-reference/endpoints/pki-alerts/create.mdx
@@ -1,4 +1,4 @@
 ---
 title: "Create"
-openapi: "POST /api/v2/pki/alerts"
+openapi: "POST /api/v1/cert-manager/alerts"
 ---
diff --git a/docs/api-reference/endpoints/pki-alerts/delete.mdx b/docs/api-reference/endpoints/pki-alerts/delete.mdx
index 67429049c..8cf3b8e40 100644
--- a/docs/api-reference/endpoints/pki-alerts/delete.mdx
+++ b/docs/api-reference/endpoints/pki-alerts/delete.mdx
@@ -1,4 +1,4 @@
 ---
 title: "Delete"
-openapi: "DELETE /api/v2/pki/alerts/{alertId}"
+openapi: "DELETE /api/v1/cert-manager/alerts/{alertId}"
 ---
diff --git a/docs/api-reference/endpoints/pki-alerts/read.mdx b/docs/api-reference/endpoints/pki-alerts/read.mdx
index 0e0547288..b408e1709 100644
--- a/docs/api-reference/endpoints/pki-alerts/read.mdx
+++ b/docs/api-reference/endpoints/pki-alerts/read.mdx
@@ -1,4 +1,4 @@
 ---
 title: "Retrieve"
-openapi: "GET /api/v2/pki/alerts/{alertId}"
+openapi: "GET /api/v1/cert-manager/alerts/{alertId}"
 ---
diff --git a/docs/api-reference/endpoints/pki-alerts/update.mdx b/docs/api-reference/endpoints/pki-alerts/update.mdx
index 45f1f1f1f..8e4dbb574 100644
--- a/docs/api-reference/endpoints/pki-alerts/update.mdx
+++ b/docs/api-reference/endpoints/pki-alerts/update.mdx
@@ -1,4 +1,4 @@
 ---
 title: "Update"
-openapi: "PATCH /api/v2/pki/alerts/{alertId}"
+openapi: "PATCH /api/v1/cert-manager/alerts/{alertId}"
 ---
diff --git a/docs/docs.json b/docs/docs.json
index 80ca37c92..bde82d71f 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -2581,6 +2581,15 @@
                   "api-reference/endpoints/certificate-profiles/get-latest-active-bundle"
                 ]
               },
+              {
+                "group": "Certificate Alerts",
+                "pages": [
+                  "api-reference/endpoints/pki-alerts/create",
+                  "api-reference/endpoints/pki-alerts/read",
+                  "api-reference/endpoints/pki-alerts/update",
+                  "api-reference/endpoints/pki-alerts/delete"
+                ]
+              },
               {
                 "group": "Certificate Syncs",
                 "pages": [