cometchat · ketanyekale · Feb 9, 2026 · Feb 10, 2026 · Feb 10, 2026 · Feb 10, 2026
diff --git a/.editorconfig b/.editorconfig
@@ -0,0 +1,21 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.json]
+indent_style = space
+indent_size = 2
+
+[*.mdx]
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = false
+
+[*.md]
+trim_trailing_whitespace = false
diff --git a/.mintlifyignore b/.mintlifyignore
@@ -1 +1,2 @@
-.github
+.github/**
+.claude/**
diff --git a/.prettierrc b/.prettierrc
@@ -0,0 +1,7 @@
+{
+  "tabWidth": 2,
+  "useTabs": false,
+  "endOfLine": "lf",
+  "singleQuote": false,
+  "trailingComma": "none"
+}
diff --git a/Warning b/Warning
diff --git a/ai-agent-service.json b/ai-agent-service.json
@@ -114,12 +114,12 @@
                                                     "description": "Internal document ID"
                                                 },
                                                 "createdAt": {
-                                                    "type": "string",
+                                                    "type": "integer",
                                                     "format": "date-time",
                                                     "description": "Creation timestamp"
                                                 },
                                                 "updatedAt": {
-                                                    "type": "string",
+                                                    "type": "integer",
                                                     "format": "date-time",
                                                     "description": "Last update timestamp"
                                                 }
@@ -294,11 +294,11 @@
                                             }
                                         },
                                         "createdAt": {
-                                            "type": "string",
+                                            "type": "integer",
                                             "format": "date-time"
                                         },
                                         "updatedAt": {
-                                            "type": "string",
+                                            "type": "integer",
                                             "format": "date-time"
                                         }
                                     }
@@ -419,11 +419,11 @@
                                                 }
                                             },
                                             "createdAt": {
-                                                "type": "string",
+                                                "type": "integer",
                                                 "format": "date-time"
                                             },
                                             "updatedAt": {
-                                                "type": "string",
+                                                "type": "integer",
                                                 "format": "date-time"
                                             }
                                         }
@@ -542,11 +542,11 @@
                                             }
                                         },
                                         "createdAt": {
-                                            "type": "string",
+                                            "type": "integer",
                                             "format": "date-time"
                                         },
                                         "updatedAt": {
-                                            "type": "string",
+                                            "type": "integer",
                                             "format": "date-time"
                                         }
                                     }
@@ -670,11 +670,11 @@
                                             }
                                         },
                                         "createdAt": {
-                                            "type": "string",
+                                            "type": "integer",
                                             "format": "date-time"
                                         },
                                         "updatedAt": {
-                                            "type": "string",
+                                            "type": "integer",
                                             "format": "date-time"
                                         }
                                     }
@@ -1416,7 +1416,7 @@
                                             },
                                             "constantValue": {
                                                 "type": "string",
-                                                "example": ""
+                                                "example": "premium"
                                             },
                                             "defaultValue": {
                                                 "type": "string",
@@ -1517,7 +1517,7 @@
                                         },
                                         "constantValue": {
                                             "type": "string",
-                                            "example": ""
+                                            "example": "premium"
                                         },
                                         "defaultValue": {
                                             "type": "string",
@@ -1629,7 +1629,7 @@
                                         },
                                         "constantValue": {
                                             "type": "string",
-                                            "example": ""
+                                            "example": "premium"
                                         },
                                         "defaultValue": {
                                             "type": "string",
@@ -4387,7 +4387,7 @@
                                                             "example": 1
                                                         },
                                                         "createdAt": {
-                                                            "type": "string",
+                                                            "type": "integer",
                                                             "example": "2026-03-12T12:52:28.063000"
                                                         }
                                                     }
@@ -7481,6 +7481,7 @@
                     }
                 ],
                 "summary": "Enable actions for a tool",
+                "description": "Adds actions to a specific tool attached to an agent.",
                 "tags": [
                     "Agent Builder"
                 ]
@@ -7540,6 +7541,7 @@
                     }
                 ],
                 "summary": "Remove actions for a tool",
+                "description": "Removes actions from a specific tool attached to an agent.",
                 "tags": [
                     "Agent Builder"
                 ]
@@ -7612,6 +7614,7 @@
                     }
                 ],
                 "summary": "Get actions available within a tool for agent",
+                "description": "Lists all actions available for a specific tool attached to an agent.",
                 "tags": [
                     "Agent Builder Ready to Use Tools"
                 ]
@@ -8188,9 +8191,9 @@
     ],
     "servers": [
         {
-            "url": "https://{appid}.api-{region}.cometchat.io/v3",
+            "url": "https://{appId}.api-{region}.cometchat.io/v3",
             "variables": {
-                "appid": {
+                "appId": {
                     "default": "appId",
                     "description": "(Required) App ID"
                 },
@@ -9190,12 +9193,12 @@
                         "description": "Internal document ID"
                     },
                     "createdAt": {
-                        "type": "string",
+                        "type": "integer",
                         "format": "date-time",
                         "description": "Creation timestamp"
                     },
                     "updatedAt": {
-                        "type": "string",
+                        "type": "integer",
                         "format": "date-time",
                         "description": "Last update timestamp"
                     }

diff --git a/ai-agents/ag2-knowledge-agent.mdx b/ai-agents/ag2-knowledge-agent.mdx
@@ -212,7 +212,7 @@ curl -N -X POST http://localhost:8000/agent \
   <Step title="Enable">Save then confirm the toggle shows <b>Enabled</b>.</Step>
 </Steps>
 
-> For more on CometChat AI Agents, see: [Overview](/ai-agents/overview) · [Instructions](/ai-agents/instructions) · [Custom agents](/ai-agents/custom-agents)
+> For more on CometChat AI Agents, see: [Overview](/ai-agents/agent-builder/overview) · [Instructions](/ai-agents/agent-builder/instructions) · [Custom agents](/ai-agents/agent-builder/tools/overview)
 
 ***
 

diff --git a/ai-agents/agent-builder/guides/implementing-authorization.mdx b/ai-agents/agent-builder/guides/implementing-authorization.mdx
@@ -215,7 +215,7 @@ Or if content should be redacted:
 ```
 
 **Agent Instructions:**
-```
+```python
 After retrieving information from the knowledge base, call 
 validateKnowledgeResponse with the retrieved content.
 

diff --git a/ai-agents/apis/add-api-tools-to-agent.mdx b/ai-agents/apis/add-api-tools-to-agent.mdx
diff --git a/ai-agents/apis/add-frontend-actions-to-agent.mdx b/ai-agents/apis/add-frontend-actions-to-agent.mdx
diff --git a/ai-agents/apis/add-knowledge-base-files.mdx b/ai-agents/apis/add-knowledge-base-files.mdx
diff --git a/ai-agents/apis/add-mcp-servers-to-agent.mdx b/ai-agents/apis/add-mcp-servers-to-agent.mdx
diff --git a/ai-agents/apis/add-tools-to-agent.mdx b/ai-agents/apis/add-tools-to-agent.mdx
diff --git a/ai-agents/apis/authenticate-composio-tool.mdx b/ai-agents/apis/authenticate-composio-tool.mdx
@@ -1,3 +1,4 @@
 ---
 openapi: post /ai-agents/agent-builder/agents/{uid}/tools/{slug}/authenticate
+description: "POST /ai-agents/agent-builder/agents/{uid}/tools/{slug}/authenticate — CometChat API endpoint."
 ---
diff --git a/ai-agents/apis/create-agent.mdx b/ai-agents/apis/create-agent.mdx
diff --git a/ai-agents/apis/create-api-tool.mdx b/ai-agents/apis/create-api-tool.mdx
diff --git a/ai-agents/apis/create-byo-agent.mdx b/ai-agents/apis/create-byo-agent.mdx
diff --git a/ai-agents/apis/create-custom-variable.mdx b/ai-agents/apis/create-custom-variable.mdx
diff --git a/ai-agents/apis/create-frontend-action.mdx b/ai-agents/apis/create-frontend-action.mdx
diff --git a/ai-agents/apis/create-mcp-server.mdx b/ai-agents/apis/create-mcp-server.mdx
diff --git a/ai-agents/apis/create-tag.mdx b/ai-agents/apis/create-tag.mdx
@@ -1,3 +1,4 @@
 ---
 openapi: post /ai-agents/tags
+description: "POST /ai-agents/tags — CometChat API endpoint."
 ---
diff --git a/ai-agents/apis/create-text-detail.mdx b/ai-agents/apis/create-text-detail.mdx
diff --git a/ai-agents/apis/create-tool.mdx b/ai-agents/apis/create-tool.mdx
diff --git a/ai-agents/apis/delete-agent.mdx b/ai-agents/apis/delete-agent.mdx
diff --git a/ai-agents/apis/delete-api-tool.mdx b/ai-agents/apis/delete-api-tool.mdx
diff --git a/ai-agents/apis/delete-byo-agent.mdx b/ai-agents/apis/delete-byo-agent.mdx
diff --git a/ai-agents/apis/delete-custom-variable.mdx b/ai-agents/apis/delete-custom-variable.mdx
diff --git a/ai-agents/apis/delete-frontend-action.mdx b/ai-agents/apis/delete-frontend-action.mdx
diff --git a/ai-agents/apis/delete-mcp-server.mdx b/ai-agents/apis/delete-mcp-server.mdx
diff --git a/ai-agents/apis/delete-text-detail.mdx b/ai-agents/apis/delete-text-detail.mdx
diff --git a/ai-agents/apis/delete-tool.mdx b/ai-agents/apis/delete-tool.mdx
diff --git a/ai-agents/apis/delete-uploaded-file.mdx b/ai-agents/apis/delete-uploaded-file.mdx
diff --git a/ai-agents/apis/delete-website.mdx b/ai-agents/apis/delete-website.mdx
diff --git a/ai-agents/apis/enable-tool-actions.mdx b/ai-agents/apis/enable-tool-actions.mdx
diff --git a/ai-agents/apis/get-action-edit-form.mdx b/ai-agents/apis/get-action-edit-form.mdx
@@ -1,3 +1,4 @@
 ---
 openapi: get /ai-agents/forms/action-edit/{name}
+description: "GET /ai-agents/forms/action-edit/{name} — CometChat API endpoint."
 ---
diff --git a/ai-agents/apis/get-actions-creation-form.mdx b/ai-agents/apis/get-actions-creation-form.mdx
@@ -1,3 +1,4 @@
 ---
 openapi: get /ai-agents/forms/actions-creation
+description: "GET /ai-agents/forms/actions-creation — CometChat API endpoint."
 ---
diff --git a/ai-agents/apis/get-actions-form.mdx b/ai-agents/apis/get-actions-form.mdx
@@ -1,3 +1,4 @@
 ---
 openapi: get /ai-agents/forms/actions
+description: "GET /ai-agents/forms/actions — CometChat API endpoint."
 ---
diff --git a/ai-agents/apis/get-agent-creation-form.mdx b/ai-agents/apis/get-agent-creation-form.mdx
@@ -1,3 +1,4 @@
 ---
 openapi: get /ai-agents/forms/agent-creation
+description: "GET /ai-agents/forms/agent-creation — CometChat API endpoint."
 ---
diff --git a/ai-agents/apis/get-agent-edit-form.mdx b/ai-agents/apis/get-agent-edit-form.mdx
@@ -1,3 +1,4 @@
 ---
 openapi: get /ai-agents/forms/agent-edit/{id}
+description: "GET /ai-agents/forms/agent-edit/{id} — CometChat API endpoint."
 ---
diff --git a/ai-agents/apis/get-agent.mdx b/ai-agents/apis/get-agent.mdx
diff --git a/ai-agents/apis/get-all-available-variables.mdx b/ai-agents/apis/get-all-available-variables.mdx
diff --git a/ai-agents/apis/get-all-tools-for-agent.mdx b/ai-agents/apis/get-all-tools-for-agent.mdx
@@ -1,3 +1,4 @@
 ---
 openapi: get /ai-agents/agent-builder/agents/{uid}/all-tools
+description: "GET /ai-agents/agent-builder/agents/{uid}/all-tools — CometChat API endpoint."
 ---
diff --git a/ai-agents/apis/get-all-variables.mdx b/ai-agents/apis/get-all-variables.mdx
@@ -1,3 +1,4 @@
 ---
 openapi: get /ai-agents/agent-builder/agents/variables
+description: "GET /ai-agents/agent-builder/agents/variables — CometChat API endpoint."
 ---
diff --git a/ai-agents/apis/get-api-tool.mdx b/ai-agents/apis/get-api-tool.mdx
@@ -1,3 +1,4 @@
 ---
 openapi: get /ai-agents/agent-builder/api-tools/{slug}
+description: "Retrieves a specific API tool by its slug. Use this endpoint to inspect an API tool's configuration, parameters, and connected agents."
 ---
diff --git a/ai-agents/apis/get-available-models.mdx b/ai-agents/apis/get-available-models.mdx
@@ -1,3 +1,4 @@
 ---
 openapi: get /ai-agents/agent-builder/agents/available-models
+description: "Retrieves the list of AI models available for agents. Use this endpoint to discover supported models before creating or updating an agent.  **Model details:** Each model includes its provider, configu"
 ---
diff --git a/ai-agents/apis/get-composio-tools.mdx b/ai-agents/apis/get-composio-tools.mdx
@@ -1,3 +1,4 @@
 ---
 openapi: get /ai-agents/agent-builder/tools/agent/{uid}
+description: "GET /ai-agents/agent-builder/tools/agent/{uid} — CometChat API endpoint."
 ---
diff --git a/ai-agents/apis/get-custom-variables.mdx b/ai-agents/apis/get-custom-variables.mdx
@@ -1,3 +1,4 @@
 ---
 openapi: get /ai-agents/agent-builder/agents/variables/custom
+description: "Retrieves all custom variables defined for the application. Use this endpoint to view and manage dynamic variables used in agent instructions.  **Variable types:** Custom variables can source values f"
 ---
diff --git a/ai-agents/apis/get-discovered-urls.mdx b/ai-agents/apis/get-discovered-urls.mdx
diff --git a/ai-agents/apis/get-form-fields.mdx b/ai-agents/apis/get-form-fields.mdx
@@ -1,3 +1,4 @@
 ---
 openapi: get /ai-agents/agents/form-fields
+description: "GET /ai-agents/agents/form-fields — CometChat API endpoint."
 ---
diff --git a/ai-agents/apis/get-frontend-action.mdx b/ai-agents/apis/get-frontend-action.mdx
@@ -1,3 +1,4 @@
 ---
 openapi: get /ai-agents/agent-builder/frontend-actions/{id}
+description: "Retrieves a specific frontend action by its unique ID. Use this endpoint to inspect a frontend action's configuration, parameters, and trigger function."
 ---
diff --git a/ai-agents/apis/get-mcp-server.mdx b/ai-agents/apis/get-mcp-server.mdx
@@ -1,3 +1,4 @@
 ---
 openapi: get /ai-agents/agent-builder/mcp-servers/{slug}
+description: "Retrieves a specific MCP server by its slug. Use this endpoint to inspect an MCP server's configuration and connected agents."
 ---