1 files changed, 60 insertions, 0 deletions
diff --git a/web/api/netdata-swagger.json b/web/api/netdata-swagger.json
index 5c2bba9a8..7786b333a 100644
--- a/web/api/netdata-swagger.json
+++ b/web/api/netdata-swagger.json
@@ -1067,6 +1067,24 @@
           }
         }
       }
+    },
+    "/aclk": {
+      "get": {
+        "summary": "Get information about current ACLK state",
+        "description": "aclk endpoint returns detailed information about current state of ACLK (Agent to Cloud communication).",
+        "responses": {
+          "200": {
+            "description": "JSON object with ACLK information.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/aclk_state"
+                }
+              }
+            }
+          }
+        }
+      }
     }
   },
   "servers": [
@@ -2059,6 +2077,48 @@
             }
           }
         }
+      },
+      "aclk_state": {
+        "type": "object",
+        "properties": {
+          "aclk-available": {
+            "type": "boolean",
+            "description": "Describes whether this agent is capable of connection to the Cloud. False means agent has been built without ACLK component either on purpose (user choice) or due to missing dependency."
+          },
+          "aclk-implementation": {
+            "type": "string",
+            "description": "Describes which ACLK implementation is currently used.",
+            "enum": [
+              "Next Generation",
+              "Legacy"
+            ]
+          },
+          "new-cloud-protocol-supported": {
+            "type": "boolean",
+            "description": "Informs about new protobuf based Cloud/Agent protocol support of this agent. If false agent has to be compiled with protobuf and protoc available."
+          },
+          "agent-claimed": {
+            "type": "boolean",
+            "description": "Informs whether this agent has been added to a space in the cloud (User has to perform claiming). If false (user didnt perform claiming) agent will never attempt any cloud connection."
+          },
+          "claimed-id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Unique ID this agent uses to identify when connecting to cloud"
+          },
+          "online": {
+            "type": "boolean",
+            "description": "Informs if this agent was connected to the cloud at the time this request has been processed."
+          },
+          "used-cloud-protocol": {
+            "type": "string",
+            "description": "Informs which protocol is used to communicate with cloud",
+            "enum": [
+              "Old",
+              "New"
+            ]
+          }
+        }
       }
     }
   }