Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
docs: keep shared Instant guidance in instant-tools
Move direct-tool Instant execution into the canonical Instant page and trim the No Auth migration guide to the cutoff, toolkit mapping, basic Session and direct-execution changes, and links to canonical guidance. Direct `instant_account` calls run the latest toolkit version, so the guide no longer suggests keeping older version pins for Instant. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Shashwat [zen] committed
Oct 28, 2026 at 17:25 UTC
243384f33d9a642fa1181e2e30e26913a524b1ae
2 files changed
+82
-39
docs/content/docs/instant-tools.mdx
+48
@@ -433,6 +433,54 @@ To select Instant explicitly, pass `account="instant_account"` to Python `sessio
433
434
Composio-managed auth is different: Composio supplies the OAuth app credentials, but your user still connects their own account. It does not establish Instant support.
435
436
+### Use Instant with direct tool execution
437
+
438
+Direct calls with `composio.tools.execute()` don't use Session policies. With Instant on for the project, a direct call for a user with no active connection can use an eligible Instant account. To choose Instant explicitly, pass `connected_account_id="instant_account"` in Python or `connectedAccountId: "instant_account"` in TypeScript:
439
+
440
+<Tabs groupId="language" items={['Python', 'TypeScript', 'API']} persist>
441
+<Tab value="Python">
442
+```python
443
+from composio import Composio
444
+
445
+composio = Composio()
446
+result = composio.tools.execute(
447
+ "FIRECRAWL_SCRAPE",
448
+ user_id="user_123",
449
+ arguments={"url": "https://composio.dev"},
450
+ connected_account_id="instant_account",
451
+ dangerously_skip_version_check=True,
452
+)
453
+print(result)
454
+```
455
+</Tab>
456
+<Tab value="TypeScript">
457
+```typescript
458
+import { Composio } from "@composio/core";
459
+
460
+const composio = new Composio();
461
+const result = await composio.tools.execute("FIRECRAWL_SCRAPE", {
462
+ userId: "user_123",
463
+ arguments: { url: "https://composio.dev" },
464
+ connectedAccountId: "instant_account",
465
+ dangerouslySkipVersionCheck: true,
466
+});
467
+console.log(result);
468
+```
469
+</Tab>
470
+<Tab value="API">
471
+```bash
472
+curl -X POST https://backend.composio.dev/api/v3.1/tools/execute/FIRECRAWL_SCRAPE \
473
+ -H "x-api-key: $COMPOSIO_API_KEY" \
474
+ -H "Content-Type: application/json" \
475
+ -d '{"user_id": "user_123", "version": "latest", "connected_account_id": "instant_account", "arguments": {"url": "https://composio.dev"}}'
476
+```
477
+</Tab>
478
+</Tabs>
479
+
480
+Instant accounts run the latest toolkit version. A call pinned to an older version fails with HTTP 403, so a pinned version works only while it is the latest. The example uses `latest` with the [direct-execution version opt-in](/docs/tools-direct/executing-tools#use-the-latest-version).
481
+
482
+An explicit `instant_account` call fails rather than falling back to another account. Check the project setting and the tool's eligibility if it fails.
483
+
484
## Balance, usage, and troubleshooting
485
486
Instant calls use your organization's prepaid balance, including on Enterprise. Check or add funds in [Billing](https://dashboard.composio.dev/~/org/settings/billing?utm_source=docs&utm_medium=content&utm_campaign=instant-tools). If your plan doesn't allow adding funds, upgrade or contact support.
docs/content/docs/migration-guide/no-auth-to-instant.mdx
+34
-39
@@ -4,13 +4,29 @@ description: Move shared-access workflows to Instant with your existing agents a
4
keywords: [No Auth, Instant, migration, Sessions, shared access]
5
---
6
7
-Use Instant to run supported tools on Composio's provider accounts, charged to your organization's Composio balance. Your users don't need separate provider credentials for those tools.
7
+From **13 November 2026**, the No Auth and shared-access routes for the toolkits below are being retired. This change supports growing usage while maintaining performance and quality for web search, browsing and AI tools via Composio.
8
9
-From **13 November 2026**, the shared-access routes below are being retired. This change supports growing usage while maintaining performance and quality for web search, browsing and AI tools via Composio.
9
+[Instant](/docs/instant-tools) replaces them. It runs supported tools on Composio's provider accounts and charges your organization's Composio balance, so your users don't need their own provider credentials for those tools.
10
+
11
+## Choose a replacement
12
+
13
+All changes in this table take effect on **13 November 2026** for the developer platform.
14
+
15
+| Toolkit | Change | Migration path |
16
+| --- | --- | --- |
17
+| Gemini (`gemini`) | No Auth/shared-key access ends; the toolkit remains | Use supported Gemini Instant tools or credentials connected by your users. |
18
+| Yelp (`yelp`) | No Auth/shared-key access ends; the toolkit remains | Use eligible Yelp Instant tools or supported credentials connected by your users. |
19
+| Browser Tool (`browser_tool`) | Legacy toolkit retired | Replace with supported Browser Use (`browser_use`) Instant tools. |
20
+| Composio Search (`composio_search`) | Legacy toolkit retired | Choose Exa (`exa`), Tavily (`tavily`), or SerpAPI (`serpapi`) tools for your use case. |
21
+| Text to PDF (`text_to_pdf`) | Toolkit removed | PDF.co (`pdf_co`) Instant supports URL-based conversion. |
22
+| WeatherMap (`weathermap`) | Toolkit removed | Use supported AccuWeather (`accu_weather`) Instant tools and update requests and response handling. |
23
+| SeatGeek (`seat_geek`) | No Auth/shared-key access ends | SeatGeek will be available through Composio Instant. |
24
+
25
+These alternatives aren't interchangeable APIs, and Instant support is per tool. [Check each tool's support, rate, and input schema](/docs/instant-tools#find-supported-tools-and-rates) before replacing it.
26
27
## Update your Session
28
13
-First, [enable Instant in project Settings and fund your organization's balance](/docs/instant-tools#enable-instant). If your agent already uses Sessions, keep your agent integration and change only the affected toolkit references and any Instant restrictions.
29
+First, [enable Instant and check your organization's balance](/docs/instant-tools#enable-instant). If your agent already uses Sessions, keep your agent integration and change only the affected toolkit references.
30
31
For example, replace the legacy `composio_search` toolkit with `exa`:
32
@@ -23,7 +39,6 @@ composio = Composio()
39
session = composio.sessions.create(
40
user_id="user_123",
41
toolkits=["exa"],
26
- instant={"toolkits": {"enable": ["exa"]}},
42
)
43
tools = session.tools()
44
```
@@ -35,7 +50,6 @@ import { Composio } from "@composio/core";
50
const composio = new Composio();
51
const session = await composio.create("user_123", {
52
toolkits: ["exa"],
38
- instant: { toolkits: { enable: ["exa"] } },
53
});
54
const tools = await session.tools();
55
```
@@ -45,7 +59,7 @@ const tools = await session.tools();
59
SESSION_ID=$(curl -s -X POST https://backend.composio.dev/api/v3.1/tool_router/session \
60
-H "x-api-key: $COMPOSIO_API_KEY" \
61
-H "Content-Type: application/json" \
48
- -d '{"user_id":"user_123","toolkits":{"enable":["exa"]},"instant":{"toolkits":{"enable":["exa"]}}}' \
62
+ -d '{"user_id":"user_123","toolkits":{"enable":["exa"]}}' \
63
| jq -r '.session_id')
64
65
curl -X GET https://backend.composio.dev/api/v3.1/tool_router/session/$SESSION_ID/tools \
@@ -54,51 +68,32 @@ curl -X GET https://backend.composio.dev/api/v3.1/tool_router/session/$SESSION_I
68
</Tab>
69
</Tabs>
70
57
-Pass `tools` to your existing agent as usual, using your framework's [provider adapter](/docs/providers). Your agent can discover and execute eligible Exa tools. This example permits Instant only for Exa; include your other required toolkits in the top-level filter and adjust the Instant filter to match your spending policy.
58
-
59
-Omitting `instant` permits eligible Instant usage when the project setting is on. You don't need to add an `instant` object if your current Session already allows it. A Session with `instant=false`, restrictive filters, or an explicit provider-account selection needs a corresponding policy or account change. See [Instant controls](/docs/instant-tools#control-instant-usage).
71
+Pass `tools` to your existing agent as usual, using your framework's [provider adapter](/docs/providers). Keep your other required toolkits in the `toolkits` list.
72
61
-Existing Sessions can use Instant after project enablement unless their policy prevents it. Update or recreate Sessions that still reference retired toolkits, and update saved Session configurations so future Sessions use the replacements too. Enabling Instant doesn't rewrite tool slugs, arguments, or response handling.
73
+You don't need to add an `instant` setting; Sessions permit eligible Instant usage by default. If your Session sets `instant=false`, restricts Instant to other toolkits, or selects a provider account explicitly, update that policy. See [Control Instant usage](/docs/instant-tools#control-instant-usage) and [Know which account runs the tool](/docs/instant-tools#know-which-account-runs-the-tool).
74
63
-## Choose a replacement
64
-
65
-All changes in this table take effect on **13 November 2026** for the developer platform.
66
-
67
-| Toolkit | Change | Migration path |
68
-| --- | --- | --- |
69
-| Gemini (`gemini`) | No Auth/shared-key access ends; the toolkit remains | Use supported Gemini Instant tools or credentials connected by your users. |
70
-| Yelp (`yelp`) | No Auth/shared-key access ends; the toolkit remains | Use eligible Yelp Instant tools or supported credentials connected by your users. |
71
-| Browser Tool (`browser_tool`) | Legacy toolkit retired | Replace with supported Browser Use (`browser_use`) Instant tools. |
72
-| Composio Search (`composio_search`) | Legacy toolkit retired | Choose Exa (`exa`), Tavily (`tavily`), or SerpAPI (`serpapi`) tools for your use case. |
73
-| Text to PDF (`text_to_pdf`) | Toolkit removed | PDF.co (`pdf_co`) Instant supports URL-based conversion. |
74
-| WeatherMap (`weathermap`) | Toolkit removed | Use supported AccuWeather (`accu_weather`) Instant tools and update requests and response handling. |
75
-| SeatGeek (`seat_geek`) | No Auth/shared-key access ends | SeatGeek will be available through Composio Instant. |
76
-
77
-Instant eligibility is per action. [Check each tool's support, rate, and input schema](/docs/instant-tools#find-supported-tools-and-rates) before replacing it. These alternatives aren't interchangeable APIs.
75
+Enabling Instant doesn't rewrite tool slugs, arguments, or response handling. Update or recreate existing Sessions that still reference retired toolkits, and update saved Session configurations so future Sessions use the replacements.
76
77
## If you call tools directly
78
81
-`composio.tools.execute()` is a different execution path from `session.execute()`, `session.tools()`, or a Session MCP endpoint. A Session's `instant` policy doesn't configure direct-tool calls.
79
+`composio.tools.execute()` is a different execution path from Sessions. A Session's `instant` policy doesn't configure direct-tool calls.
80
83
-If you want to keep direct execution, replace retired tool references, check the target action's Instant support on the version you use, and select `connected_account_id="instant_account"` in Python or `connectedAccountId: "instant_account"` in TypeScript when choosing Instant explicitly. Keep direct-tool [version pinning](/docs/tools-direct/toolkit-versioning) in place. An older version isn't a way to preserve retired shared access.
81
+To keep direct execution, replace retired tool references and [select the Instant account explicitly](/docs/instant-tools#use-instant-with-direct-tool-execution). An older toolkit version isn't a way to preserve retired shared access.
82
83
Alternatively, follow [Migrate from Direct Tools to Sessions](/docs/migration-guide/direct-to-sessions). This is a separate migration; agents already using Sessions don't need it.
84
87
-Where supported, your users can connect their own provider credentials instead. Composio normally selects your user's connection before Instant. To choose Instant explicitly within a Session, use its [account selection options](/docs/instant-tools#inspect-or-explicitly-select-an-instant-account). Account selection still requires project permission, Session permission, and tool eligibility.
88
-
85
## Verify before the cutoff
86
91
-1. Check [Instant pricing](https://composio.dev/pricing), enable the project setting, and check the organization's funded balance.
92
-2. Replace affected toolkit and action references, including saved configurations. Check request and response differences for each replacement.
93
-3. Test your agent or direct execution path. Inspect the [execution logs](/docs/instant-tools#balance-usage-and-troubleshooting) for the credential source and charge; an absent charge isn't proof that a call was free.
87
+1. Check [Instant pricing](https://composio.dev/pricing) and the published rate for each replacement tool.
88
+2. Replace affected toolkit and tool references, including saved configurations. Check request and response differences for each replacement.
89
+3. Test your agent or direct execution path, then [check the execution logs](/docs/instant-tools#balance-usage-and-troubleshooting) for the credential source and charge.
90
4. Check existing Sessions and pinned direct-tool versions. A successful replacement call doesn't prove every old workflow has migrated.
91
96
-After the cutoff, affected legacy executions will stop working. If you need help mapping an action or adapting a workflow, contact [support@composio.dev](mailto:support@composio.dev).
97
-
92
+After the cutoff, affected legacy executions will stop working. If you need help mapping a tool or adapting a workflow, contact [support@composio.dev](mailto:support@composio.dev).
93
94
## Optional Session setup helper
95
101
-[Download the Python helper](/assets/migrations/migrate_no_auth_to_instant.py) if you want to preview and create a replacement Session with explicit toolkit and tool allowlists. It requires Python 3.10 or later and uses only the standard library.
96
+[Download the Python helper](/assets/migrations/migrate_no_auth_to_instant.py) to preview and create a replacement Session with explicit toolkit and tool allowlists. It requires Python 3.10 or later and uses only the standard library. It is for Sessions only.
97
98
Save the file locally, inspect it, then preview a request:
99
@@ -106,14 +101,14 @@ Save the file locally, inspect it, then preview a request:
101
python3 migrate_no_auth_to_instant.py --user-id user_123 --tool exa:EXA_SEARCH
102
```
103
109
-Use your existing application user ID and repeat `--tool toolkit:TOOL_SLUG` for each required action. The preview makes no network requests. The helper does not guess equivalents for retired actions or adapt their arguments and responses.
104
+Use your existing application user ID and repeat `--tool toolkit:TOOL_SLUG` for each required tool. The preview makes no network requests. The helper doesn't guess equivalents for retired tools or adapt their arguments and responses.
105
111
-After enabling Instant and funding the intended project's organization, set `COMPOSIO_API_KEY` securely for that project. Review the selected actions and their published rates before creating a replacement Session:
106
+After enabling Instant for the intended project, set `COMPOSIO_API_KEY` for that project. Review the selected tools and their published rates, then create the replacement Session:
107
108
```bash
109
python3 migrate_no_auth_to_instant.py --user-id user_123 --tool exa:EXA_SEARCH --apply
110
```
111
117
-`--apply` verifies each tool's current identity, Instant support and published price, then creates one Session. It does not run provider tools, edit existing Sessions, change project settings, or rewrite your application. Use the returned Session ID in your application and test the workflow separately. Normal account-selection rules still apply.
112
+`--apply` checks each tool's current identity, Instant support and published rate, then creates one Session. It doesn't run provider tools, edit existing Sessions, change project settings, or rewrite your application. Use the returned Session ID in your application and test the workflow separately.
113
119
-If creation times out or returns an ambiguous server error, inspect your project before trying again. The helper never retries automatically. This helper is for Sessions; direct-tool callers should follow the separate guidance above.
114
+If creation times out or returns an ambiguous server error, check your project before trying again. The helper never retries automatically.