docs: add docs for agents list

2026-04-03 23:01:59 +03:00
parent 83427193bc
commit 27e82f80f1
5 changed files with 129 additions and 28 deletions
@@ -14,7 +14,50 @@ const docTemplate = `{
    },
    "host": "{{.Host}}",
    "basePath": "{{.BasePath}}",
-    "paths": {},
+    "paths": {
+        "/agents": {
+            "get": {
+                "description": "Returns a list of all agents currently connected via gRPC streaming",
+                "produces": [
+                    "application/json"
+                ],
+                "tags": [
+                    "agents"
+                ],
+                "summary": "Get connected agents",
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/definitions/internal_handlers.AgentInfo"
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    },
+    "definitions": {
+        "internal_handlers.AgentInfo": {
+            "type": "object",
+            "properties": {
+                "label": {
+                    "type": "string"
+                },
+                "services": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                },
+                "token": {
+                    "type": "string"
+                }
+            }
+        }
+    },
    "securityDefinitions": {
        "Bearer": {
            "description": "Type \"Bearer\" followed by a space and the JWT token.",