@devries-cameron20 / composio-1 / commits / d7e7e3a88
Fork 0

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: polish custom tools references

Dhawal Upadhyay committed Mar 25, 2026 at 15:24 UTC d7e7e3a883ffc10ae75127a4ea4c8202f62be31f
1 file changed +7 -5
docs/content/docs/toolkits/custom-tools-and-toolkits.mdx
+7 -5
@@ -227,10 +227,14 @@ For more best practices, see [How to Build Tools for AI Agents: A Field Guide](h
227
228 Use `session.customTools()` / `session.customToolkits()` in TypeScript or `session.custom_tools()` / `session.custom_toolkits()` in Python to list registered tools and toolkits. Registered tool slugs include their final `LOCAL_` prefix, and toolkit-scoped tools also include the toolkit slug.
229
230 +Reference: [TypeScript ToolRouterSession](/reference/sdk-reference/typescript/tool-router-session) · [Python SDK Reference](/reference/sdk-reference/python)
231 +
232 ## Programmatic execution
233
234 Use `session.execute()` to run custom tools directly, outside of an agent loop (e.g. `session.execute("GET_USER_PROFILE")`). Custom tools execute in-process; remote tools are sent to the backend automatically.
235
236 +Reference: [Tool Router API Reference](/reference/api-reference/tool-router) · [TypeScript ToolRouterSession](/reference/sdk-reference/typescript/tool-router-session) · [Python SDK Reference](/reference/sdk-reference/python)
237 +
238 ## SessionContext
239
240 Every custom tool's `execute` function receives `(input, ctx)`. The `ctx` object provides:
@@ -250,14 +254,12 @@ Every custom tool's `execute` function receives `(input, ctx)`. The `ctx` object
254 | Method | Description |
255 |--------|-------------|
256 | `ctx.user_id` | The user ID for the current session. |
253 -| `ctx.proxy_execute(...)` | Authenticated HTTP request via Composio's auth layer. Params: `toolkit`, `endpoint`, `method`, `body=None`, `parameters=[{"type": "query" \| "header", "name": ..., "value": ...}]`. |
257 +| `ctx.proxy_execute(...)` | Authenticated HTTP request via Composio's auth layer. Params: `toolkit`, `endpoint`, `method`, `body=None`, `parameters=[{"in": "query" \| "header", "name": ..., "value": ...}]`. |
258 | `ctx.execute(tool_slug, arguments)` | Execute any Composio native tool from within your custom tool. |
259
260 </Tab>
261 </Tabs>
262
259 -## Related reference
263 +In Python, `parameters` dictionaries accept both `in` and `type`; this guide uses `in` to match the TypeScript examples.
264
261 -- [Tool Router API Reference](/reference/api-reference/tool-router)
262 -- [TypeScript ToolRouterSession Reference](/reference/sdk-reference/typescript/tool-router-session)
263 -- [Python SDK Reference](/reference/sdk-reference/python)
265 +Reference: [TypeScript SessionContextImpl](/reference/sdk-reference/typescript/session-context-impl) · [Python SDK Reference](/reference/sdk-reference/python)