Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
Versioning docs fixes
Sushmithamallesh4ca3a4545607
diff --git a/fern/pages/src/migration-guide/index.mdx b/fern/pages/src/migration-guide/index.mdxindex c9d9d6dc7..c009a0ff4 100644--- a/fern/pages/src/migration-guide/index.mdx+++ b/fern/pages/src/migration-guide/index.mdx@@ -6,19 +6,17 @@ keywords: "migration, upgrade, sdk, versioning"hide-nav-links: false----Find the appropriate migration guide for your use case:-## Available migration guides<AccordionGroup><Accordion title="New SDK migration">- Migrate from the old Composio SDK to the new next-generation SDK, including breaking changes, new features, and updated APIs.+ Migrate from the old Composio SDK to the new new SDK, including breaking changes, new features, and updated APIs.[View SDK migration guide →](/resources/migration-guide/new-sdk)</Accordion><Accordion title="Toolkit versioning migration">- Migrate to the new toolkit versioning system introduced on October 22, 2025.+ Migrate to use the toolkit versioning system.[View versioning migration guide →](/resources/migration-guide/toolkit-versioning)</Accordion>diff --git a/fern/pages/src/migration-guide/new-sdk.mdx b/fern/pages/src/migration-guide/new-sdk.mdxindex bcabf1e50..27bc068eb 100644--- a/fern/pages/src/migration-guide/new-sdk.mdx+++ b/fern/pages/src/migration-guide/new-sdk.mdx@@ -1,8 +1,8 @@----title: New SDK migration+title: Our next generation SDKssubtitle: Learn more about Composio's next generation SDKs and how to migrateimage: "https://og.composio.dev/api/og?title=New%20SDK%20migration"-keywords: 'sdk, migration, next generation, upgrade'+keywords: 'sdk, migration, upgrade'hide-nav-links: false---diff --git a/fern/pages/src/migration-guide/toolkit-versioning.mdx b/fern/pages/src/migration-guide/toolkit-versioning.mdxindex d38f94bc1..6cab52ed9 100644--- a/fern/pages/src/migration-guide/toolkit-versioning.mdx+++ b/fern/pages/src/migration-guide/toolkit-versioning.mdx@@ -2,7 +2,7 @@title: Toolkit versioning migrationsubtitle: Migrate to the new toolkit versioning systemimage: "https://og.composio.dev/api/og?title=Toolkit%20versioning%20migration"-keywords: "toolkit versioning, migration, breaking changes"+keywords: "toolkit versioning, migration"hide-nav-links: false---@@ -41,11 +41,11 @@ Choose one of three migration strategies:<CodeGroup><SnippetCode- src="fern/snippets/tool-calling/versioning/python/sdk-initialization.py"+ src="fern/snippets/tool-calling/python/versioning-sdk-init.py"title="Python"/><SnippetCode- src="fern/snippets/tool-calling/versioning/typescript/sdk-initialization.ts"+ src="fern/snippets/tool-calling/typescript/versioning-sdk-init.ts"title="TypeScript"/></CodeGroup>@@ -54,14 +54,14 @@ Choose one of three migration strategies:<CodeGroup><SnippetCode- src="fern/snippets/tool-calling/versioning/python/per-execution-override.py"- startLine={5}- endLine={16}+ src="fern/snippets/tool-calling/python/versioning-per-execution.py"+ startLine={6}+ endLine={15}title="Python"/><SnippetCode- src="fern/snippets/tool-calling/versioning/typescript/per-execution-override.ts"- startLine={5}+ src="fern/snippets/tool-calling/typescript/versioning-per-execution.ts"+ startLine={6}endLine={14}title="TypeScript"/>@@ -70,28 +70,9 @@ Choose one of three migration strategies:#### Option 3: Use environment variables```bash-export COMPOSIO_TOOLKIT_VERSION_GITHUB="20250116_00"+export COMPOSIO_TOOLKIT_VERSION_GITHUB="20251027_00"```-Then execute normally:--<CodeGroup>-```python Python-result = composio.tools.execute(- "GITHUB_CREATE_ISSUE",- {"user_id": "user-123", "arguments": {...}}-)-```--```typescript TypeScript-const result = await composio.tools.execute({- toolSlug: "GITHUB_CREATE_ISSUE",- userId: "user-123",- arguments: {...}-});-```-</CodeGroup>-## Migration checklist1. **Audit your code**: Find all `tools.execute()` calls in your codebasediff --git a/fern/pages/src/tool-calling/toolkit-versioning.mdx b/fern/pages/src/tool-calling/toolkit-versioning.mdxindex 86bb2d868..eb4677eb3 100644--- a/fern/pages/src/tool-calling/toolkit-versioning.mdx+++ b/fern/pages/src/tool-calling/toolkit-versioning.mdx@@ -20,11 +20,11 @@ Configure toolkit versions using one of three methods:<CodeGroup><SnippetCode- src="fern/snippets/tool-calling/versioning/python/sdk-initialization.py"+ src="fern/snippets/tool-calling/python/versioning-sdk-init.py"title="Python"/><SnippetCode- src="fern/snippets/tool-calling/versioning/typescript/sdk-initialization.ts"+ src="fern/snippets/tool-calling/typescript/versioning-sdk-init.ts"title="TypeScript"/></CodeGroup>@@ -33,20 +33,20 @@ Configure toolkit versions using one of three methods:```bash# Set versions for specific toolkits-export COMPOSIO_TOOLKIT_VERSION_GITHUB="20250116_00"-export COMPOSIO_TOOLKIT_VERSION_SLACK="20250115_01"-export COMPOSIO_TOOLKIT_VERSION_GMAIL="20250115_00"+export COMPOSIO_TOOLKIT_VERSION_GITHUB="20251027_00"+export COMPOSIO_TOOLKIT_VERSION_SLACK="20251027_00"+export COMPOSIO_TOOLKIT_VERSION_GMAIL="20251027_00"```### Per-execution override<CodeGroup><SnippetCode- src="fern/snippets/tool-calling/versioning/python/per-execution-override.py"+ src="fern/snippets/tool-calling/python/versioning-per-execution.py"title="Python"/><SnippetCode- src="fern/snippets/tool-calling/versioning/typescript/per-execution-override.ts"+ src="fern/snippets/tool-calling/typescript/versioning-per-execution.ts"title="TypeScript"/></CodeGroup>@@ -59,7 +59,7 @@ Versions follow the format `YYYYMMDD_NN`:```python# Production-toolkit_versions = {"github": "20250116_00"}+toolkit_versions = {"github": "20251027_00"}# Developmenttoolkit_versions = {"github": "latest"}@@ -77,42 +77,21 @@ Never use `latest` in production. It can introduce breaking changes.## Managing versions-### List available versions--Check what versions are available for a toolkit:+Check available versions and inspect what your tools are using:<CodeGroup><SnippetCode- src="fern/snippets/tool-calling/versioning/python/manage-versions.py"- startLine={8}+ src="fern/snippets/tool-calling/python/versioning-manage.py"+ startLine={5}endLine={11}title="Python"/><SnippetCode- src="fern/snippets/tool-calling/versioning/typescript/manage-versions.ts"- startLine={8}+ src="fern/snippets/tool-calling/typescript/versioning-manage.ts"+ startLine={5}endLine={12}title="TypeScript"/></CodeGroup>-### Inspect current versions--Check which version your tools are actually using:--<CodeGroup>-<SnippetCode- src="fern/snippets/tool-calling/versioning/python/manage-versions.py"- startLine={13}- endLine={16}- title="Python"-/>-<SnippetCode- src="fern/snippets/tool-calling/versioning/typescript/manage-versions.ts"- startLine={14}- endLine={20}- title="TypeScript"-/>-</CodeGroup>-diff --git a/fern/snippets/tool-calling/python/versioning-manage.py b/fern/snippets/tool-calling/python/versioning-manage.pynew file mode 100644index 000000000..c661e9e6a--- /dev/null+++ b/fern/snippets/tool-calling/python/versioning-manage.py@@ -0,0 +1,11 @@+from composio import Composio++composio = Composio(api_key="YOUR_API_KEY")++# Get toolkit information including available versions+toolkit = composio.toolkits.get(slug="github")++# Extract and print version information+print(f"Toolkit: {toolkit.name}")+print(f"Current Version: {toolkit.meta.version}")+print(f"Available Versions: {toolkit.meta.available_versions}")\ No newline at end of filediff --git a/fern/snippets/tool-calling/python/versioning-per-execution.py b/fern/snippets/tool-calling/python/versioning-per-execution.pynew file mode 100644index 000000000..2e1c64482--- /dev/null+++ b/fern/snippets/tool-calling/python/versioning-per-execution.py@@ -0,0 +1,15 @@+from composio import Composio++composio = Composio(api_key="YOUR_API_KEY")++# Specify version directly in execute call+result = composio.tools.execute(+ "GITHUB_LIST_STARGAZERS",+ arguments={+ "owner": "ComposioHQ",+ "repo": "composio"+ },+ user_id="user-k7334",+ version="20251027_00" # Override version for this execution+)+print(result)\ No newline at end of filediff --git a/fern/snippets/tool-calling/versioning/python/sdk-initialization.py b/fern/snippets/tool-calling/python/versioning-sdk-init.pysimilarity index 60%rename from fern/snippets/tool-calling/versioning/python/sdk-initialization.pyrename to fern/snippets/tool-calling/python/versioning-sdk-init.pyindex a391dd09f..fc9ef0959 100644--- a/fern/snippets/tool-calling/versioning/python/sdk-initialization.py+++ b/fern/snippets/tool-calling/python/versioning-sdk-init.py@@ -4,8 +4,8 @@ from composio import Composiocomposio = Composio(api_key="YOUR_API_KEY",toolkit_versions={- "github": "20250116_00",- "slack": "20250115_01",- "gmail": "20250115_00"+ "github": "20251027_00",+ "slack": "20251027_00",+ "gmail": "20251027_00"})\ No newline at end of filediff --git a/fern/snippets/tool-calling/typescript/versioning-manage.ts b/fern/snippets/tool-calling/typescript/versioning-manage.tsnew file mode 100644index 000000000..6bc364555--- /dev/null+++ b/fern/snippets/tool-calling/typescript/versioning-manage.ts@@ -0,0 +1,12 @@+import { Composio } from "@composio/core";++const composio = new Composio({ apiKey: "YOUR_API_KEY" });++// Get toolkit information including available versions+const toolkit = await composio.toolkits.get("github");++// Extract and print version information+console.log("Toolkit:", toolkit.name);+console.log("Current Version:", toolkit.meta.version);+console.log("Available Versions:", toolkit.meta.availableVersions);+console.log("Latest Version:", toolkit.meta.availableVersions[0]); // First one is usually the latest\ No newline at end of filediff --git a/fern/snippets/tool-calling/typescript/versioning-per-execution.ts b/fern/snippets/tool-calling/typescript/versioning-per-execution.tsnew file mode 100644index 000000000..ba3eab26e--- /dev/null+++ b/fern/snippets/tool-calling/typescript/versioning-per-execution.ts@@ -0,0 +1,14 @@+import { Composio } from "@composio/core";++const composio = new Composio({ apiKey: "YOUR_API_KEY" });++// Specify version directly in execute call+const result = await composio.tools.execute("GITHUB_LIST_STARGAZERS", {+ userId: "user-k7334",+ arguments: {+ owner: "ComposioHQ",+ repo: "composio"+ },+ version: "20251027_00" // Override version for this execution+});+console.log(result);\ No newline at end of filediff --git a/fern/snippets/tool-calling/versioning/typescript/sdk-initialization.ts b/fern/snippets/tool-calling/typescript/versioning-sdk-init.tssimilarity index 65%rename from fern/snippets/tool-calling/versioning/typescript/sdk-initialization.tsrename to fern/snippets/tool-calling/typescript/versioning-sdk-init.tsindex 0e11d1f8f..f3c5e70ff 100644--- a/fern/snippets/tool-calling/versioning/typescript/sdk-initialization.ts+++ b/fern/snippets/tool-calling/typescript/versioning-sdk-init.ts@@ -4,8 +4,8 @@ import { Composio } from "@composio/core";const composio = new Composio({apiKey: "YOUR_API_KEY",toolkitVersions: {- github: "20250116_00",- slack: "20250115_01",- gmail: "20250115_00"+ github: "20251027_00",+ slack: "20251027_00",+ gmail: "20251027_00"}});\ No newline at end of filediff --git a/fern/snippets/tool-calling/versioning/python/manage-versions.py b/fern/snippets/tool-calling/versioning/python/manage-versions.pydeleted file mode 100644index 7b51f1be3..000000000--- a/fern/snippets/tool-calling/versioning/python/manage-versions.py+++ /dev/null@@ -1,16 +0,0 @@-from composio import Composio--composio = Composio(- api_key="YOUR_API_KEY",- toolkit_versions={"github": "20250116_00"}-)--# List available versions for a toolkit-versions = composio.tools.get_toolkit_versions("github")-for version in versions[:3]:- print(f"Version: {version['version']} - Status: {version['status']}")--# Fetch tools and inspect their versions-tools = composio.tools.get("user-123", toolkits=["github"])-for tool in tools[:3]:- print(f"{tool.slug}: v{tool.toolkit_version}")\ No newline at end of filediff --git a/fern/snippets/tool-calling/versioning/python/per-execution-override.py b/fern/snippets/tool-calling/versioning/python/per-execution-override.pydeleted file mode 100644index aa6658c27..000000000--- a/fern/snippets/tool-calling/versioning/python/per-execution-override.py+++ /dev/null@@ -1,16 +0,0 @@-from composio import Composio--composio = Composio(api_key="YOUR_API_KEY")--# Specify version directly in execute call-result = composio.tools.execute(- "GITHUB_CREATE_ISSUE",- {- "user_id": "user-123",- "arguments": {- "repo": "my-repo",- "title": "Critical fix"- },- "toolkit_version": "20250116_00" # Version for this execution- }-)\ No newline at end of filediff --git a/fern/snippets/tool-calling/versioning/typescript/manage-versions.ts b/fern/snippets/tool-calling/versioning/typescript/manage-versions.tsdeleted file mode 100644index 1685fffeb..000000000--- a/fern/snippets/tool-calling/versioning/typescript/manage-versions.ts+++ /dev/null@@ -1,20 +0,0 @@-import { Composio } from "@composio/core";--const composio = new Composio({- apiKey: "YOUR_API_KEY",- toolkitVersions: { github: "20250116_00" }-});--// List available versions for a toolkit-const versions = await composio.tools.getToolkitVersions("github");-versions.slice(0, 3).forEach(version => {- console.log(`Version: ${version.version} - Status: ${version.status}`);-});--// Fetch tools and inspect their versions-const tools = await composio.tools.get("user-123", {- toolkits: ["github"]-});-tools.slice(0, 3).forEach(tool => {- console.log(`${tool.slug}: v${tool.toolkitVersion}`);-});\ No newline at end of filediff --git a/fern/snippets/tool-calling/versioning/typescript/per-execution-override.ts b/fern/snippets/tool-calling/versioning/typescript/per-execution-override.tsdeleted file mode 100644index 221017717..000000000--- a/fern/snippets/tool-calling/versioning/typescript/per-execution-override.ts+++ /dev/null@@ -1,14 +0,0 @@-import { Composio } from "@composio/core";--const composio = new Composio({ apiKey: "YOUR_API_KEY" });--// Specify version directly in execute call-const result = await composio.tools.execute({- toolSlug: "GITHUB_CREATE_ISSUE",- userId: "user-123",- arguments: {- repo: "my-repo",- title: "Critical fix"- },- toolkitVersion: "20250116_00" // Version for this execution-});\ No newline at end of file