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 No Auth migration changes out of instant-tools
Revert instant-tools.mdx to next and describe direct-execution Instant selection in the migration guide instead. Note that retired toolkit references don't block Session creation, but retired tools must be removed from preload.tools. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Shashwat [zen] committed
Oct 29, 2026 at 05:51 UTC
c4bc437a4aaf16da44682608047c1290e10adcb5
2 files changed
+3
-49
docs/content/docs/instant-tools.mdx
-48
@@ -433,54 +433,6 @@ 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
-
436
## Balance, usage, and troubleshooting
437
438
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
+3
-1
@@ -36,11 +36,13 @@ If your Session already permits eligible Instant tools, keep that policy. If it
36
37
Update or recreate existing Sessions that reference retired toolkits, and update saved configurations for future Sessions. Enabling Instant doesn't rewrite these references.
38
39
+Keeping retired toolkit references in your Session configuration doesn't block Session creation, but retired tools remain unavailable. Remove any retired tools listed in [`preload.tools`](/docs/configuring-sessions#preloading-tools).
40
+
41
## If you call tools directly
42
43
`composio.tools.execute()` is a different execution path from Sessions. A Session's `instant` policy doesn't configure direct-tool calls.
44
43
-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.
45
+To keep direct execution, replace retired tool references. To choose Instant explicitly, pass `connected_account_id="instant_account"` to `composio.tools.execute()` in Python or `connectedAccountId: "instant_account"` in TypeScript. Instant runs the latest toolkit version, so a call pinned to an older version fails. An older toolkit version isn't a way to preserve retired shared access.
46
47
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.
48