docs: fix broken links utility + uncaught broken links (#12637)

* fix broken links

* update broken links utility

* add missing payment evens

* generate llms

* fix segment link

www/apps/api-reference/specs/admin/code_samples/JavaScript/admin_uploads/post.js

@@ -14,7 +14,7 @@ sdk.admin.upload.create(
        // file uploaded as a binary string
       {
         name: "test.txt",
-        content: "test", // Should be the binary content of the file
+        content: "test", // Should be the binary string of the file
       },
       // file uploaded as a File object
       new File(["test"], "test.txt", { type: "text/plain" })

www/apps/api-reference/specs/admin/openapi.full.yaml

@@ -25350,7 +25350,16 @@ paths:
         '500':
           $ref: '#/components/responses/500_error'
       x-workflow: markPaymentCollectionAsPaid
-      x-events: []
+      x-events:
+        - name: payment.captured
+          payload: |-
+            ```ts
+            {
+              id, // the ID of the payment
+            }
+            ```
+          description: Emitted when a payment is captured.
+          deprecated: false
   /admin/payments:
     get:
       operationId: GetPayments
@@ -26200,7 +26209,16 @@ paths:
         '500':
           $ref: '#/components/responses/500_error'
       x-workflow: capturePaymentWorkflow
-      x-events: []
+      x-events:
+        - name: payment.captured
+          payload: |-
+            ```ts
+            {
+              id, // the ID of the payment
+            }
+            ```
+          description: Emitted when a payment is captured.
+          deprecated: false
   /admin/payments/{id}/refund:
     post:
       operationId: PostPaymentsIdRefund
@@ -26292,7 +26310,16 @@ paths:
         '500':
           $ref: '#/components/responses/500_error'
       x-workflow: refundPaymentWorkflow
-      x-events: []
+      x-events:
+        - name: payment.refunded
+          payload: |-
+            ```ts
+            {
+              id, // the ID of the payment
+            }
+            ```
+          description: Emitted when a payment is refunded.
+          deprecated: false
   /admin/plugins:
     get:
       operationId: GetPlugins
@@ -49518,7 +49545,7 @@ paths:
                    // file uploaded as a binary string
                   {
                     name: "test.txt",
-                    content: "test", // Should be the binary content of the file
+                    content: "test", // Should be the binary string of the file
                   },
                   // file uploaded as a File object
                   new File(["test"], "test.txt", { type: "text/plain" })

www/apps/api-reference/specs/admin/paths/admin_payment-collections_{id}_mark-as-paid.yaml

@@ -81,4 +81,13 @@ post:
     '500':
       $ref: ../components/responses/500_error.yaml
   x-workflow: markPaymentCollectionAsPaid
-  x-events: []
+  x-events:
+    - name: payment.captured
+      payload: |-
+        ```ts
+        {
+          id, // the ID of the payment
+        }
+        ```
+      description: Emitted when a payment is captured.
+      deprecated: false

www/apps/api-reference/specs/admin/paths/admin_payments_{id}_capture.yaml

@@ -76,4 +76,13 @@ post:
     '500':
       $ref: ../components/responses/500_error.yaml
   x-workflow: capturePaymentWorkflow
-  x-events: []
+  x-events:
+    - name: payment.captured
+      payload: |-
+        ```ts
+        {
+          id, // the ID of the payment
+        }
+        ```
+      description: Emitted when a payment is captured.
+      deprecated: false

www/apps/api-reference/specs/admin/paths/admin_payments_{id}_refund.yaml

@@ -84,4 +84,13 @@ post:
     '500':
       $ref: ../components/responses/500_error.yaml
   x-workflow: refundPaymentWorkflow
-  x-events: []
+  x-events:
+    - name: payment.refunded
+      payload: |-
+        ```ts
+        {
+          id, // the ID of the payment
+        }
+        ```
+      description: Emitted when a payment is refunded.
+      deprecated: false