fix(openapi): Fix broken mintlify pages (v2) (#8382)

Co-authored-by: hyperswitch-bot[bot] <148525504+hyperswitch-bot[bot]@users.noreply.github.com>

api-reference/docs.json

@@ -265,11 +265,11 @@
                     "pages": [
                       "v2/payment-methods/payment-method--create",
                       "v2/payment-methods/payment-method--create-intent",
-                      "v2/payment-methods/payment-method--payment-methods-list",
                       "v2/payment-methods/payment-method--confirm-intent",
                       "v2/payment-methods/payment-method--update",
                       "v2/payment-methods/payment-method--retrieve",
                       "v2/payment-methods/payment-method--delete",
+                      "v2/payment-methods/payment-method--list-customer-saved-payment-methods",
                       "v2/payment-methods/list-saved-payment-methods-for-a-customer"
                     ]
                   },
@@ -291,13 +291,17 @@
                       "v2/customers/customers--retrieve",
                       "v2/customers/customers--update",
                       "v2/customers/customers--delete",
-                      "v2/customers/customers--list",
+                      "v2/customers/customers--list"
-                      "v2/customers/customers--list-saved-payment-methods"
                     ]
                   },
                   {
                     "group": "Refunds",
-                    "pages": ["v2/refunds/refunds--create"]
+                    "pages": [
+                      "v2/refunds/refunds--create",
+                      "v2/refunds/refunds--metadata-update",
+                      "v2/refunds/refunds--retrieve",
+                      "v2/refunds/refunds--list"
+                    ]
                   }
                 ]
               },
@@ -373,6 +377,10 @@
                   {
                     "group": "Tokenization",
                     "pages": ["v2/tokenization/tokenization--create"]
+                  },
+                  {
+                    "group": "Revenue Recovery",
+                    "pages": ["v2/revenue-recovery/revenue-recovery--retrieve"]
                   }
                 ]
               }

api-reference/v2/customers/customers--update.mdx

@@ -1,3 +1,3 @@
 ---
-openapi: put /v2/customers/{id}
+openapi: post /v2/customers/{id}
 ---

api-reference/v2/openapi_spec_v2.json

@@ -1958,18 +1958,6 @@
               "type": "string"
             },
             "example": "pro_abcdefghijklmnop"
-          },
-          {
-            "name": "X-Client-Secret",
-            "in": "header",
-            "description": "Client Secret Associated with the payment intent",
-            "required": true,
-            "schema": {
-              "type": "string"
-            },
-            "example": {
-              "X-Client-Secret": "12345_pay_0193e41106e07e518940f8b51b9c8121_secret_0193e41107027a928d61d292e6a5dba9"
-            }
           }
         ],
         "requestBody": {
@@ -2222,18 +2210,6 @@
               "type": "string"
             },
             "example": "pro_abcdefghijklmnop"
-          },
-          {
-            "name": "X-Client-Secret",
-            "in": "header",
-            "description": "Client Secret Associated with the payment intent",
-            "required": true,
-            "schema": {
-              "type": "string"
-            },
-            "example": {
-              "X-Client-Secret": "12345_pay_0193e41106e07e518940f8b51b9c8121_secret_0193e41107027a928d61d292e6a5dba9"
-            }
           }
         ],
         "responses": {
@@ -3538,6 +3514,8 @@
         "tags": [
           "Tokenization"
         ],
+        "summary": "Tokenization - Create",
+        "description": "Create a token with customer_id",
         "operationId": "create_token_vault_api",
         "requestBody": {
           "content": {

api-reference/v2/payment-method-session/payment-method-session--confirm-a-payment-method-session.mdx

@@ -1,3 +1,3 @@
 ---
-openapi: post /v2/payment-method-session/:id/confirm
+openapi: post /v2/payment-method-session/{id}/confirm
 ---

api-reference/v2/payment-method-session/payment-method-session--delete-a-saved-payment-method.mdx

@@ -1,3 +1,3 @@
 ---
-openapi: delete /v2/payment-method-session/:id
+openapi: delete /v2/payment-method-session/{id}
 ---

api-reference/v2/payment-method-session/payment-method-session--list-payment-methods.mdx

@@ -1,3 +1,3 @@
 ---
-openapi: get /v2/payment-method-session/:id/list-payment-methods
+openapi: get /v2/payment-method-session/{id}/list-payment-methods
 ---

api-reference/v2/payment-method-session/payment-method-session--retrieve.mdx

@@ -1,3 +1,3 @@
 ---
-openapi: get /v2/payment-method-session/:id
+openapi: get /v2/payment-method-session/{id}
 ---

api-reference/v2/payment-method-session/payment-method-session--update-a-saved-payment-method.mdx

@@ -1,3 +1,3 @@
 ---
-openapi: put /v2/payment-method-session/:id/update-saved-payment-method
+openapi: put /v2/payment-method-session/{id}/update-saved-payment-method
 ---

api-reference/v2/payment-methods/list-customer-saved-payment-methods-for-a-payment.mdx

@@ -1,3 +0,0 @@
----
-openapi: get /v2/payments/{id}/saved-payment-methods
----

api-reference/v2/payment-methods/list-payment-methods-for-a-customer.mdx

@@ -1,3 +0,0 @@
----
-openapi: get /v2/customers/{id}/saved-payment-methods
----

api-reference/v2/payment-methods/list-saved-payment-methods-for-a-customer.mdx

@@ -1,3 +0,0 @@
----
-openapi: get /v2/customers/{id}/saved-payment-methods
----

api-reference/v2/refunds/refunds--list.mdx

@@ -0,0 +1,3 @@
+---
+openapi: post /v2/refunds/list
+---

api-reference/v2/refunds/refunds--metadata-update.mdx

@@ -0,0 +1,3 @@
+---
+openapi: put /v2/refunds/{id}/update_metadata
+---

api-reference/v2/refunds/refunds--retrieve.mdx

@@ -0,0 +1,3 @@
+---
+openapi: get /v2/refunds/{id}
+---

api-reference/v2/revenue-recovery/revenue-recovery--retrieve.mdx

@@ -0,0 +1,3 @@
+---
+openapi: get /v2/process_tracker/revenue_recovery_workflow/{revenue_recovery_id}
+---

crates/openapi/src/routes/payments.rs

@@ -923,12 +923,7 @@ pub fn payments_update_intent() {}
         "X-Profile-Id" = String, Header,
         description = "Profile ID associated to the payment intent",
         example = "pro_abcdefghijklmnop"
-      ),
+      )
-      (
-        "X-Client-Secret" = String, Header,
-        description = "Client Secret Associated with the payment intent",
-        example = json!({"X-Client-Secret": "12345_pay_0193e41106e07e518940f8b51b9c8121_secret_0193e41107027a928d61d292e6a5dba9"})
-      ),
     ),
   request_body(
       content = PaymentsConfirmIntentRequest,
@@ -1058,11 +1053,6 @@ pub(crate) enum ForceSync {
           description = "Profile ID associated to the payment intent",
           example = "pro_abcdefghijklmnop"
         ),
-        (
-          "X-Client-Secret" = String, Header,
-          description = "Client Secret Associated with the payment intent",
-          example = json!({"X-Client-Secret": "12345_pay_0193e41106e07e518940f8b51b9c8121_secret_0193e41107027a928d61d292e6a5dba9"})
-        ),
     ),
     responses(
         (status = 200, description = "Get the payment methods", body = PaymentMethodListResponseForPayments),

crates/openapi/src/routes/tokenization.rs

@@ -1,6 +1,9 @@
 use serde_json::json;
 use utoipa::OpenApi;
 
+/// Tokenization - Create
+///
+/// Create a token with customer_id
 #[cfg(feature = "v2")]
 #[utoipa::path(
     post,