@devries-cameron20 / composio Mirror · read-only / commits / b12e0b3be
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, 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