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.

docs: update session use attach changeset

Abir Taheer2d07d26f527d
diff --git a/.changeset/v31-customs-use-attach.md b/.changeset/v31-customs-use-attach.md
index 047834fd4..5ebd92800 100644
--- a/.changeset/v31-customs-use-attach.md
+++ b/.changeset/v31-customs-use-attach.md
@@ -4,6 +4,6 @@
Add custom tools support to `composio.use()`.
-- **`composio.use(id, { customTools, customToolkits })`**: Attach custom tools to an existing session. Binds local tools for search and execution. When called without custom tools, falls back to the standard session retrieve.
+- **`composio.use(id, { customTools, customToolkits })`**: Attach to an existing session through the v3.1 attach endpoint. When custom tools are provided, binds local tools for search and execution; when called without custom tools, it still uses attach with an empty body so session reuse has one backend path.
- **Inline custom tools payload**: `use()` now correctly passes `inlineCustomToolsPayload` and `preloadedCustomToolSlugs` to the session, enabling custom tool execution and preloading on rehydrated sessions.
- **`CustomToolsMap.tools`**: The map now caches the raw `CustomTool[]` array for future inline re-injection on v3.1 search/execute requests.