@devries-cameron20 / composio Mirror · read-only / commits / 4110ff272
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.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 11:00 UTC

docs: clarify hosted-account discovery and validate SDK snippets

Palash Kala committed Sep 23, 2026 at 18:36 UTC 4110ff272c8d8305b0b4751289b2b39722b1dd83
1 file changed +12 -2
docs/content/docs/instant-tools.mdx
+12 -2
@@ -12,6 +12,10 @@ Instant Tools let your Session run supported tools without an end-user provider
12
13 Once the project setting is enabled, new Sessions can use eligible Instant Tools by default, even if `premium_usage` is omitted. Set `premium_usage=False` in Python or `premiumUsage: false` in TypeScript when creating a Session that must not incur premium usage charges.
14
15 +## Find eligible tools
16 +
17 +Hosted account coverage is per tool, not per toolkit. The current [toolkit listing API](/reference/api-reference/toolkits/getToolkits) does not return hosted account availability or offer a hosted-account filter. Its `no_auth` and `composio_managed_auth_schemes` fields mean different things and should not be used as substitutes. During Experimental access, ask [support@composio.dev](mailto:support@composio.dev) for the supported tools and rates before allowing them in a production Session.
18 +
19 ## Create a Session
20
21 After your project is enabled, create a Session. This example makes Exa available and permits premium usage for its eligible tools:
@@ -63,7 +67,10 @@ tools = session.tools() # Pass these to your agent framework.
67 </Tab>
68 <Tab value="TypeScript">
69 ```typescript
66 -// @noErrors
70 +import { Composio } from "@composio/core";
71 +const composio = new Composio();
72 +const session = await composio.create("user_123");
73 +// ---cut---
74 const tools = await session.tools(); // Pass these to your agent framework.
75 ```
76 </Tab>
@@ -79,7 +86,10 @@ result = session.execute("EXA_SEARCH", arguments={"query": "Composio documentati
86 </Tab>
87 <Tab value="TypeScript">
88 ```typescript
82 -// @noErrors
89 +import { Composio } from "@composio/core";
90 +const composio = new Composio();
91 +const session = await composio.create("user_123");
92 +// ---cut---
93 const result = await session.execute("EXA_SEARCH", { query: "Composio documentation" });
94 ```
95 </Tab>