docs: Update Admin API docs for v25.3.3

Author: vbotbuildovich

admin/admin-v2.yaml

@@ -1996,14 +1996,14 @@ info:
   title: Redpanda Admin API
   version: v2.0.0
   x-admin-api-major: v2.0.0
-  x-generated-at: 2025-12-12T04:54:23.532Z
+  x-generated-at: 2025-12-20T17:39:07.209Z
   x-generator: redpanda-docs-openapi-bundler
-  x-redpanda-core-version: v25.3.2
+  x-redpanda-core-version: v25.3.3
 openapi: 3.1.0
 paths:
   /redpanda.core.admin.v2.BrokerService/GetBroker:
     post:
-      description: Returns information about a single broker in the cluster.
+      description: GetBroker returns information about a single broker in the cluster.
       operationId: redpanda.core.admin.v2.BrokerService.GetBroker
       parameters:
         - in: header
@@ -2034,12 +2034,12 @@ paths:
               schema:
                 $ref: "#/components/schemas/connect.error"
           description: Error
-      summary: GetBroker
+      summary: GetBroker returns information about a single broker in the cluster.
       tags:
         - BrokerService
   /redpanda.core.admin.v2.BrokerService/ListBrokers:
     post:
-      description: Returns information about all brokers in the cluster.
+      description: ListBrokers returns information about all brokers in the cluster.
       operationId: redpanda.core.admin.v2.BrokerService.ListBrokers
       parameters:
         - in: header
@@ -2070,12 +2070,14 @@ paths:
               schema:
                 $ref: "#/components/schemas/connect.error"
           description: Error
-      summary: ListBrokers
+      summary: ListBrokers returns information about all brokers in the cluster.
       tags:
         - BrokerService
   /redpanda.core.admin.v2.ClusterService/ListKafkaConnections:
     post:
-      description: Returns information about the cluster's Kafka connections, collected and ordered across all brokers.
+      description: |-
+        ListKafkaConnections returns information about the cluster's Kafka
+         connections, collected and ordered across all brokers.
       operationId: redpanda.core.admin.v2.ClusterService.ListKafkaConnections
       parameters:
         - in: header
@@ -2106,12 +2108,11 @@ paths:
               schema:
                 $ref: "#/components/schemas/connect.error"
           description: Error
-      summary: ListKafkaConnections
+      summary: ListKafkaConnections returns information about the cluster's Kafka  connections, collected and ordered across all brokers.
       tags:
         - ClusterService
   /redpanda.core.admin.v2.ShadowLinkService/CreateShadowLink:
     post:
-      description: Creates a new shadow link between clusters.
       operationId: redpanda.core.admin.v2.ShadowLinkService.CreateShadowLink
       parameters:
         - in: header
@@ -2147,7 +2148,6 @@ paths:
         - ShadowLinkService
   /redpanda.core.admin.v2.ShadowLinkService/DeleteShadowLink:
     post:
-      description: Deletes an existing shadow link.
       operationId: redpanda.core.admin.v2.ShadowLinkService.DeleteShadowLink
       parameters:
         - in: header
@@ -2183,7 +2183,7 @@ paths:
         - ShadowLinkService
   /redpanda.core.admin.v2.ShadowLinkService/FailOver:
     post:
-      description: Fails over a shadow link or a single shadow topic for disaster recovery.
+      description: Fails over a shadow link or a single shadow topic
       operationId: redpanda.core.admin.v2.ShadowLinkService.FailOver
       parameters:
         - in: header
@@ -2214,12 +2214,11 @@ paths:
               schema:
                 $ref: "#/components/schemas/connect.error"
           description: Error
-      summary: FailOver
+      summary: Fails over a shadow link or a single shadow topic
       tags:
         - ShadowLinkService
   /redpanda.core.admin.v2.ShadowLinkService/GetShadowLink:
     post:
-      description: Gets information about a specific shadow link.
       operationId: redpanda.core.admin.v2.ShadowLinkService.GetShadowLink
       parameters:
         - in: header
@@ -2256,9 +2255,9 @@ paths:
   /redpanda.core.admin.v2.ShadowLinkService/GetShadowTopic:
     post:
       description: |-
-        Returns information about a shadow topic on a shadow link.
-         A shadow topic is a resource created automatically by a shadow link. The
-         shadow topic 'shadows' a topic on a source cluster, mirroring the data
+        This operation returns information about a Shadow Topic on a Shadow Link.
+         A Shadow Topic is a resource created automatically by a Shadow Link.  The
+         Shadow Topic 'shadows' a topic on a source cluster, mirroring the data
          and properties of that topic.
       operationId: redpanda.core.admin.v2.ShadowLinkService.GetShadowTopic
       parameters:
@@ -2290,12 +2289,11 @@ paths:
               schema:
                 $ref: "#/components/schemas/connect.error"
           description: Error
-      summary: GetShadowTopic
+      summary: This operation returns information about a Shadow Topic on a Shadow Link.  A Shadow Topic is a resource created automatically by a Shadow Link.  The  Shadow Topic 'shadows' a topic on a source cluster, mirroring the data  and properties of that topic.
       tags:
         - ShadowLinkService
   /redpanda.core.admin.v2.ShadowLinkService/ListShadowLinks:
     post:
-      description: Lists all shadow links in the cluster.
       operationId: redpanda.core.admin.v2.ShadowLinkService.ListShadowLinks
       parameters:
         - in: header
@@ -2332,8 +2330,8 @@ paths:
   /redpanda.core.admin.v2.ShadowLinkService/ListShadowTopics:
     post:
       description: |-
-        Returns a list of all shadow topics on a shadow link and
-         their status.
+        This operation returns a list of all Shadow Topics on a Shadow Link and
+         their status
       operationId: redpanda.core.admin.v2.ShadowLinkService.ListShadowTopics
       parameters:
         - in: header
@@ -2364,12 +2362,11 @@ paths:
               schema:
                 $ref: "#/components/schemas/connect.error"
           description: Error
-      summary: ListShadowTopics
+      summary: This operation returns a list of all Shadow Topics on a Shadow Link and  their status
       tags:
         - ShadowLinkService
   /redpanda.core.admin.v2.ShadowLinkService/UpdateShadowLink:
     post:
-      description: Updates an existing shadow link configuration.
       operationId: redpanda.core.admin.v2.ShadowLinkService.UpdateShadowLink
       parameters:
         - in: header