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 Instant project access and shared-account limits
Palash Kala committed
Sep 29, 2026 at 20:00 UTC
3ff166aefc907adf5dd49a11aad20aaffc1eb0c6
1 file changed
+9
-3
docs/content/docs/instant-tools.mdx
+9
-3
@@ -5,17 +5,19 @@ keywords: [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
+Adding a capability to your agent can mean another provider account, API key, and bill or subscription. Instant Tools let your Session use supported actions without that setup. Composio supplies access and charges usage to your organization's available balance. Your users can still connect their own accounts when a task needs their provider identity.
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.
11
+ The project setting `enable_instant` must be `true`. It is off by default and 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.
15
16
## Find eligible tools
17
18
-Instant tool coverage is per tool, not per toolkit. The current [toolkit listing API](/reference/api-reference/toolkits/getToolkits) does not return instant tool availability or offer an instant tool 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
+Instant coverage is per tool, not per toolkit. A toolkit may support Instant Tools without every tool in it being eligible. Composio's provider account can be shared across customers, so only reviewed actions can run through it. Actions that could reveal shared account history or send arbitrary proxy requests are excluded. Use a connected account for actions Instant does not support.
19
+
20
+The current [toolkit listing API](/reference/api-reference/toolkits/getToolkits) does not return Instant availability or offer an Instant 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.
21
22
## Create a Session
23
@@ -183,4 +185,8 @@ Session search tells you when a hosted account serves a toolkit. The toolkit's c
185
186
Hosted accounts cannot run arbitrary provider requests through proxy execution. Use supported tool actions. Direct execution outside a Session does not inherit its `premium_usage` policy.
187
188
+## Review usage
189
+
190
+Use the [project usage summary API](/reference/api-reference/projects/postProjectUsageSummary) for totals and the [tool-execution logs API](/reference/api-reference/logs/postLogsToolExecution) for individual calls. Filter logs by `session_id` when you need to trace a Session. These records remain available even when `return_premium_charge` is `false`.
191
+
192
See [Configuring Sessions](/docs/configuring-sessions) for general toolkit and tool filters and the [create Session API reference](/reference/api-reference/tool-router/postToolRouterSession) for the complete request schema.