Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

feat: changelog for tool listing

Composio6124f0effe37
diff --git a/fern/pages/src/changelog/10-28-25.md b/fern/pages/src/changelog/10-28-25.md
new file mode 100644
index 000000000..b4cbd567c
--- /dev/null
+++ b/fern/pages/src/changelog/10-28-25.md
@@ -0,0 +1,25 @@
+## Tools Listing Now Requires Filters for Better Performance
+
+### Summary
+Due to the increased scale in the number of tools and their versions powered by Composio, listing tools now requires passing specific filters to ensure optimal performance and relevant results.
+
+### Key Changes
+
+#### Required Filters
+Going forward, listing tools requires one of the following filters:
+- ✅ **Tool slugs filter**: Specify specific tool slugs to retrieve
+- ✅ **Toolkit slug filter**: Filter by specific toolkit(s)
+- ✅ **Generic search**: Use search terms to find relevant tools
+
+### Behavior
+**Before:** Tools could be listed without any filters, potentially returning large datasets
+**After:** At least one filter parameter is required when listing tools:
+
+### Breaking Changes
+⚠️ **Breaking Change**: Listing tools without any filter parameters will now return an error. Users must specify at least one of:
+1. `toolkit_slug` parameter
+2. `tool_slugs` parameter
+3. `search` parameter
+4. `auth_config_ids` parameter
+
+This change ensures better performance and more relevant results as the Composio ecosystem continues to scale.