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>