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, 09:45 UTC
docs: use Composio Instant naming
Brendan O'Leary committed
Oct 2, 2026 at 02:50 UTC
b12e0b3bec48559d15f5c519453c23237ff5e928
1 file changed
+6
-6
docs/content/docs/instant-tools.mdx
+6
-6
@@ -1,17 +1,17 @@
1
---
2
-title: Instant Tools
2
+title: Instant
3
description: Use supported tools in a Session without asking every user to connect a provider account
4
-keywords: [Instant Tools, Sessions, premium usage, hosted account]
4
+keywords: [Composio Instant, instant tools, Sessions, premium usage, hosted account]
5
experimental: true
6
---
7
8
-Instant Tools let your Session run supported tools without an end-user provider connection. A Composio hosted account provides access for eligible tools. Premium usage charges for those calls come from your organization's available balance.
8
+Composio Instant lets your Session run supported tools without an end-user provider connection. A Composio hosted account provides access for eligible tools. Premium usage charges for those calls come from your organization's available balance.
9
10
<Callout type="warning" title="Experimental access">
11
This feature requires a project setting that is not yet self-service. Email [support@composio.dev](mailto:support@composio.dev) to enable it for your project and confirm which tools and rates are available. Session configuration cannot override a project where the setting is off.
12
</Callout>
13
14
-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
+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.
15
16
## Find eligible tools
17
@@ -54,7 +54,7 @@ const session = await composio.create("user_123", {
54
</Tab>
55
</Tabs>
56
57
-Top-level `toolkits` controls which tools the Session can discover and run. Omit it to make all toolkits discoverable. `premium_usage.toolkits` (or `premiumUsage.toolkits` in TypeScript) separately restricts which eligible tools can incur premium usage charges. Omitting `premium_usage.toolkits` does not restrict premium usage: eligible tools remain available when the project and Session permit them. `return_premium_charge` defaults to `false` and only controls whether the actual charge appears in the immediate tool response. An Instant toolkit can still contain tools that need a connected account; hosted account coverage is tool-specific.
57
+Top-level `toolkits` controls which tools the Session can discover and run. Omit it to make all toolkits discoverable. `premium_usage.toolkits` (or `premiumUsage.toolkits` in TypeScript) separately restricts which eligible tools can incur premium usage charges. Omitting `premium_usage.toolkits` does not restrict premium usage: eligible tools remain available when the project and Session permit them. `return_premium_charge` defaults to `false` and only controls whether the actual charge appears in the immediate tool response. A toolkit with instant tools can still contain tools that need a connected account; hosted account coverage is tool-specific.
58
59
## Find and run a tool
60
@@ -175,7 +175,7 @@ On patch, omitted `premium_usage` fields keep their existing values. Supplying a
175
176
## Know which account runs the tool
177
178
-A hosted account is a provider account held by Composio for specific tools. It is different from **Composio-managed auth**, where Composio supplies OAuth application credentials but your user still connects their own account. Composio-managed auth alone does not make a tool Instant.
178
+A hosted account is a provider account held by Composio for specific tools. It is different from **Composio-managed auth**, where Composio supplies OAuth application credentials but your user still connects their own account. Composio-managed auth alone does not make a tool available through Composio Instant.
179
180
If you select a connected account explicitly, that route wins and does not fall back to the hosted account on failure. Otherwise, available user or shared connections take priority over a hosted account. If the chosen tool is not supported by a hosted account, it follows the normal connection flow.
181